中文 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

Support

• GitHub Issues
• Documentation