中文 English

Claude Code Multi-Agent Workflow System

AI-powered development automation with multi-backend execution (Codex/Claude/Gemini/OpenCode)

Quick Start

git clone https://github.com/cexll/myclaude.git
cd myclaude
python3 install.py --install-dir ~/.claude

Modules Overview

| Module | Description | Documentation | |--------|-------------|---------------| | do | Recommended - 7-phase feature development with codeagent orchestration | /do command | | dev | Lightweight dev workflow with Codex integration | /dev command | | omo | Multi-agent orchestration with intelligent routing | /omo command | | bmad | BMAD agile workflow with 6 specialized agents | /bmad-pilot command | | requirements | Lightweight requirements-to-code pipeline | /requirements-pilot command | | essentials | Core development commands and utilities | /code, /debug, etc. | | sparv | SPARV workflow (Specify→Plan→Act→Review→Vault) | /sparv command | | course | Course development (combines dev + product-requirements + test-cases) | Composite module |

Installation

# Install all enabled modules
python3 install.py --install-dir ~/.claude

# Install specific module
python3 install.py --module dev

# List available modules
python3 install.py --list-modules

# Force overwrite
python3 install.py --force

Module Configuration

Edit config.json to enable/disable modules:

{
  "modules": {
    "dev": { "enabled": true },
    "bmad": { "enabled": false },
    "requirements": { "enabled": false },
    "essentials": { "enabled": false },
    "omo": { "enabled": false },
    "sparv": { "enabled": false },
    "do": { "enabled": false },
    "course": { "enabled": false }
  }
}

Workflow Selection Guide

| Scenario | Recommended | |----------|-------------| | Feature development (default) | /do | | Lightweight feature | /dev | | Bug investigation + fix | /omo | | Large enterprise project | /bmad-pilot | | Quick prototype | /requirements-pilot | | Simple task | /code, /debug |

Core Architecture

| Role | Agent | Responsibility | |------|-------|----------------| | Orchestrator | Claude Code | Planning, context gathering, verification | | Executor | codeagent-wrapper | Code editing, test execution (Codex/Claude/Gemini/OpenCode) |

Backend CLI Requirements

| Backend | Required Features | |---------|-------------------| | Codex | codex e, --json, -C, resume | | Claude | --output-format stream-json, -r | | Gemini | -o stream-json, -y, -r |

Directory Structure After Installation

~/.claude/
├── bin/codeagent-wrapper
├── CLAUDE.md
├── commands/
├── agents/
├── skills/
└── config.json

Documentation

• Codeagent-Wrapper Guide
• Hooks Documentation
• codeagent-wrapper

Troubleshooting

Common Issues

Codex wrapper not found:

bash install.sh

Module not loading:

cat ~/.claude/installed_modules.json
python3 install.py --module <name> --force

Backend CLI errors:

which codex && codex --version
which claude && claude --version
which gemini && gemini --version

FAQ

| Issue | Solution | |-------|----------| | "Unknown event format" | Logging display issue, can be ignored | | Gemini can't read .gitignore files | Remove from .gitignore or use different backend | | /dev slow | Check logs, try faster model, use single repo | | Codex permission denied | Set approval_policy = "never" in ~/.codex/config.yaml |

See GitHub Issues for more.

License

AGPL-3.0 - see LICENSE

Commercial Licensing

For commercial use without AGPL obligations, contact: evanxian9@gmail.com

Support

• GitHub Issues
• Documentation