# claude-tools

A comprehensive Claude Code plugin with specialized skills, workflow commands, intelligent hooks, and 46 AI agents for Python/FastAPI development, Brazilian financial integrations, and productivity automation.

## Installation

```bash
# Add the marketplace
/plugin marketplace add rafaelkamimura/claude-tools

# Install the plugin
/plugin install claude-tools@claude-tools
```

## Contents

### Skills (5 Domain Expertise Areas)

| Skill | Description | Auto-Triggers |
|-------|-------------|---------------|
| **fastapi-clean-architecture** | Clean Architecture patterns for FastAPI with 3-layer design, DI, repository pattern | `fastapi`, `clean architecture` |
| **brazilian-financial-integration** | Boleto, PIX payments, parcelamento, CPF/CNPJ validation, Banco do Brasil API | `boleto`, `pix`, `brazilian payment` |
| **async-testing-expert** | pytest patterns for async Python testing, fixtures, mocking, 387-test reference | `pytest`, `async test` |
| **multi-system-sso-authentication** | Enterprise SSO with JWT RS256, multi-provider support, session management | `sso`, `authentication`, `jwt` |
| **skill-developer** | Meta-skill for creating and managing Claude Code skills | `create skill`, `skill development` |

### Utility Skills

- **mariadb-database-explorer** - Schema exploration and documentation generation
- **gitlab-cli-troubleshooter** - GitLab CLI configuration and diagnostics
- **mcp-setup-wizard** - Model Context Protocol server configuration

### Commands (32 Workflow Automation)

#### Task Management
- `/task-init` - Intelligent task initialization with codebase exploration
- `/brainstorm` - Deep thinking sessions for implementation ideas
- `/todo-worktree` - Todo implementation program
- `/dev-docs` - Strategic plan creation
- `/dev-docs-update` - Documentation updates before context compaction

#### Code Quality
- `/review-code` - Pre-commit code review
- `/test-suite` - Test suite runner
- `/security-scan` - Security vulnerability scanning
- `/perf-check` - Performance analysis
- `/tech-debt` - Technical debt tracking
- `/debug-assistant` - Intelligent debugging helper

#### Git & Deployment
- `/commit` - Smart git commit with conventional commits
- `/deploy` - Smart deployment manager
- `/rollback` - Emergency rollback procedures

#### Documentation
- `/read-specs` - Specification reader and task decomposer
- `/write-documentation` - Documentation writer
- `/mr-draft` - Merge request draft generator
- `/handoff` - Team handoff assistant

#### Azure DevOps Integration
- `/fetch-azure-task` - Fetch Azure DevOps work items
- `/update-azure-task` - Update work items
- `/close-azure-task` - Close work items

#### Utilities
- `/standup` - Daily status generator
- `/env-sync` - Environment manager
- `/deps-update` - Dependency manager
- `/sync-config` - Sync configuration to GitHub
- `/create-skill` - Skill creation workflow
- `/bslist` - Brainstorm list viewer

### Agents (46 Specialized AI Subagents)

#### Architecture & Design
`backend-architect`, `code-architecture-reviewer`, `cloud-architect`, `graphql-architect`, `documentation-architect`, `plan-reviewer`

#### Development
`code-refactor-master`, `code-reviewer`, `frontend-developer`, `python-pro`, `golang-pro`, `typescript-expert`, `rust-pro`, `php-developer`, `laravel-vue-developer`, `nextjs-app-router-developer`, `drupal-developer`, `directus-developer`, `legacy-modernizer`

#### Quality & Testing
`test-automator`, `frontend-qa-tester`, `database-optimizer`, `performance-engineer`, `security-auditor`, `debugger`, `devops-troubleshooter`

#### Data & AI
`data-scientist`, `data-engineer`, `ml-engineer`, `ai-engineer`

#### Financial & Crypto
`payment-integration`, `arbitrage-bot`, `crypto-analyst`, `crypto-trader`, `crypto-risk-manager`, `defi-strategist`, `quant-analyst`

#### Specialized
`game-developer`, `mobile-developer`, `blockchain-developer`, `accessibility-specialist`, `api-documenter`, `web-research-specialist`, `ui-ux-designer`, `refactor-planner`

### Hooks (Intelligent Automation)

This plugin includes a TypeScript-based hook system for automatic skill activation:

- **UserPromptSubmit Hook** - Analyzes prompts and suggests relevant skills based on keywords and intent patterns
- **PostToolUse Hook** - Tracks edited files and caches build commands for affected repositories

**Requirements**: Node.js and npm/npx for hook execution.

## Skill Activation System

The plugin includes `skill-rules.json` which defines automatic triggers for skills:

```json
{
  "skills": {
    "fastapi-clean-architecture": {
      "type": "domain",
      "enforcement": "suggest",
      "priority": "high",
      "promptTriggers": {
        "keywords": ["fastapi", "clean architecture", "repository pattern"],
        "intentPatterns": ["build.*api", "create.*endpoint"]
      }
    }
  }
}
```

When you type a prompt containing trigger keywords, the hook system will suggest activating the relevant skill.

## Configuration

After installation, skills and commands are available immediately. To customize:

1. **Modify skill triggers**: Edit `skills/skill-rules.json`
2. **Customize commands**: Edit individual command files in `commands/`
3. **Add new agents**: Add markdown files to `agents/`

## Requirements

- Claude Code CLI
- Node.js 18+ (for hooks)
- npm or npx

## License

MIT

## Author

Rafael Kamimura

## Version

1.0.0