English | 中文

A sophisticated multi-agent configuration system for Claude Code featuring specialized agents and structured command templates to accelerate development workflows including code review, refactoring, security audits, architectural guidance, and UX evaluations.

New to the multi-agent system? Start here:

Option A: Using DotClaude CLI Tool (Recommended)

# Install the dotagent-cli tool
pip install dotagent-cli

# Sync with this repository
dotagent sync --repo FradSer/dotclaude

Option B: Using the Legacy Sync Script

bash <(curl -fsSL https://raw.githubusercontent.com/FradSer/dotclaude/main/sync-to-github.sh)

Available in any Claude Code conversation:

• @agent-code-reviewer - Comprehensive code analysis and best practices
• @agent-security-reviewer - Security vulnerability assessment
• @agent-tech-lead-reviewer - Architectural guidance and technical direction
• @agent-ux-reviewer - User interface and experience evaluation
• @agent-code-simplifier - Code refactoring and complexity reduction

Three-stage quality assurance process:

1. 🔍 Analysis - Use /review/hierarchical for multi-agent code analysis
2. 📋 Planning - Use /gh/create-issues to create tracked improvement tasks
3. ⚡ Implementation - Use /gh/resolve-issues with smart branch management

💡 Best Practice: Validate Claude's suggestions at each stage to ensure alignment with your project goals.

Open these command templates in Claude Code:

• /review/quick - Fast two-stage code review
• /git/commit-and-push - Structured commit workflow
• /continue - Resume interrupted work sessions

• Browse Agent System for all available specialists
• Explore Command Templates for structured workflows
• Review Usage Patterns for effective collaboration

# Basic sync
dotagent sync --repo FradSer/dotclaude

# Include project-specific agents
dotagent sync --repo FradSer/dotclaude --local

# Preview changes before applying
dotagent sync --repo FradSer/dotclaude --dry-run

# Check sync status
dotagent status --repo FradSer/dotclaude

dotclaude/
├── agents/                    # 🤖 Global agents (all projects)
│   ├── code-reviewer.md
│   ├── code-simplifier.md
│   ├── security-reviewer.md
│   ├── tech-lead-reviewer.md
│   └── ux-reviewer.md
├── local-agents/              # 🎯 Project-specific agents
│   └── swiftui-clean-architecture-reviewer.md
├── commands/                  # ⚡ Workflow templates
│   ├── continue.md
│   ├── create-command.md
│   ├── refactor.md
│   ├── gh/                    # GitHub workflows
│   │   ├── create-issues.md
│   │   ├── create-pr.md
│   │   └── resolve-issues.md
│   ├── git/                   # Git operations
│   │   ├── commit-and-push.md
│   │   ├── commit.md
│   │   ├── gitignore.md
│   │   └── push.md
│   ├── gitflow/               # GitFlow workflows
│   │   ├── finish-feature.md
│   │   ├── finish-hotfix.md
│   │   ├── finish-release.md
│   │   ├── start-feature.md
│   │   ├── start-hotfix.md
│   │   └── start-release.md
│   └── review/                # Code review workflows
│       ├── hierarchical.md
│       └── quick.md
├── CLAUDE.md                  # Development guidelines
├── README.md
├── README.zh-CN.md
└── sync-to-github.sh          # Configuration sync script

Universal specialists available in all projects:

Project-specific specialists (copied via sync script):

Structured workflow templates for common development tasks:

• /review/quick - Fast two-stage review process
• /review/hierarchical - Multi-agent parallel analysis with consolidated results

• /git/commit - Structured commit workflow with conventional messages
• /git/commit-and-push - Combined commit and push with validation
• /git/push - Push with pre-flight checks
• /git/gitignore - Generate and manage .gitignore files

• /gitflow/start-feature - Initialize feature branches
• /gitflow/finish-feature - Complete and merge features
• /gitflow/start-release - Prepare release branches
• /gitflow/finish-release - Finalize and tag releases
• /gitflow/start-hotfix - Create urgent fix branches
• /gitflow/finish-hotfix - Deploy critical patches

• /gh/create-issues - Generate issues with templates and labels
• /gh/create-pr - Create pull requests with structured descriptions
• /gh/resolve-issues - Smart issue resolution with auto-branching and worktree management

• /continue - Resume interrupted work sessions
• /create-command - Generate new command templates
• /refactor - Systematic code improvement checklist

1. 📋 Open templates - Use command files as interactive checklists in Claude Code
2. 🎯 Follow workflows - Each template provides structured, step-by-step guidance
3. 🤝 Maintain consistency - Standardized approaches across team members and projects

Sequential Reviews (thorough analysis):

@agent-code-reviewer → @agent-security-reviewer → @agent-tech-lead-reviewer

Parallel Specialization (targeted expertise):

@agent-ux-reviewer        # UI/UX focused
@agent-security-reviewer  # Security focused
@agent-code-simplifier    # Refactoring focused

Project-Specific (after sync):

@swiftui-clean-architecture-reviewer  # SwiftUI projects

Human-AI Partnership Claude Code serves as your specialized development partner, providing expert analysis and recommendations while you maintain decision-making authority and project context.

GitHub Integration The gh CLI creates seamless workflows where issues, pull requests, and commits become structured documentation, capturing both human decisions and AI insights.

Validation-Driven Development Each automation step includes human validation points, ensuring AI suggestions align with project goals and constraints.

See CLAUDE.md for comprehensive development guidelines including:

• 🏗️ Architecture - SOLID principles, dependency injection, design patterns
• ✨ Code Quality - Semantic naming, error handling, documentation standards
• 🔄 Development Standards - TDD, atomic commits, conventional commit messages
• 🛠️ Tech Stack - Node.js (pnpm), Python (uv), language-specific best practices

Q: Is the sync script interactive? A: Yes - you choose local vs. repo for each item and decide whether to commit/push at the end.

Q: How do I get colored diffs? A: Install colordiff - the script auto-detects and uses it when available.

Q: Can I customize agents for my project? A: Yes - add project-specific agents to local-agents/ and run the sync script.

MIT License - see LICENSE for details.