中文 English

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

This system leverages a dual-agent architecture with pluggable AI backends:

Why this separation?

• Claude Code excels at understanding context and orchestrating complex workflows
• Specialized backends (Codex for code, Claude for reasoning, Gemini for prototyping) excel at focused execution
• Backend selection via --backend codex|claude|gemini matches the model to the task

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

The primary workflow for most development tasks.

/dev "implement user authentication with JWT"

6-Step Process:

1. Requirements Clarification - Interactive Q&A to clarify scope
2. Codex Deep Analysis - Codebase exploration and architecture decisions
3. Dev Plan Generation - Structured task breakdown with test requirements
4. Parallel Execution - Codex executes tasks concurrently
5. Coverage Validation - Enforce ≥90% test coverage
6. Completion Summary - Report with file changes and coverage stats

Key Features:

• Claude Code orchestrates, Codex executes all code changes
• Automatic task parallelization for speed
• Mandatory 90% test coverage gate
• Rollback on failure

Best For: Feature development, refactoring, bug fixes with tests

Full enterprise agile methodology with 6 specialized agents.

/bmad-pilot "build e-commerce checkout system"

Agents:

Process:

Requirements → Architecture → Sprint Plan → Development → Review → QA
     ↓              ↓             ↓            ↓          ↓       ↓
   PRD.md      DESIGN.md     SPRINT.md     Code      REVIEW.md  TEST.md

Best For: Large features, team coordination, enterprise projects

Lightweight requirements-to-code pipeline.

/requirements-pilot "implement API rate limiting"

Process:

1. Requirements generation with quality scoring
2. Implementation planning
3. Code generation
4. Review and testing

Best For: Quick prototypes, well-defined features

Direct commands for daily coding tasks.

Best For: Quick tasks, no workflow overhead needed

• Multi-backend execution: codeagent-wrapper --backend codex|claude|gemini (default codex) so you can match the model to the task without changing workflows.
• GitHub workflow commands: /gh-create-issue "short need" creates structured issues; /gh-issue-implement 123 pulls issue #123, drives development, and prepares the PR.
• Skills + hooks activation: .claude/hooks run automation (tests, reviews), while .claude/skills/skill-rules.json auto-suggests the right skills. Keep hooks enabled in .claude/settings.json to activate the enterprise workflow helpers.

# Install all enabled modules (dev + essentials by default)
python3 install.py --install-dir ~/.claude

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

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

# Force overwrite existing files
python3 install.py --force

~/.claude/
├── CLAUDE.md              # Core instructions and role definition
├── commands/              # Slash commands (/dev, /code, etc.)
├── agents/                # Agent definitions
├── skills/
│   └── codex/
│       └── SKILL.md       # Codex integration skill
└── installed_modules.json # Installation status

Edit config.json to customize:

{
  "version": "1.0",
  "install_dir": "~/.claude",
  "modules": {
    "dev": {
      "enabled": true,
      "operations": [
        {"type": "merge_dir", "source": "dev-workflow"},
        {"type": "copy_file", "source": "memorys/CLAUDE.md", "target": "CLAUDE.md"},
        {"type": "copy_file", "source": "skills/codex/SKILL.md", "target": "skills/codex/SKILL.md"},
        {"type": "run_command", "command": "bash install.sh"}
      ]
    }
  }
}

Operation Types:

The codex skill enables Claude Code to delegate code execution to Codex CLI.

# Codex is invoked via the skill
codeagent-wrapper - <<'EOF'
implement @src/auth.ts with JWT validation
EOF

codeagent-wrapper --parallel <<'EOF'
---TASK---
id: backend_api
workdir: /project/backend
---CONTENT---
implement REST endpoints for /api/users

---TASK---
id: frontend_ui
workdir: /project/frontend
dependencies: backend_api
---CONTENT---
create React components consuming the API
EOF

# Automatic (via dev module)
python3 install.py --module dev

# Manual
bash install.sh

Windows installs place codeagent-wrapper.exe in %USERPROFILE%\bin.

# PowerShell (recommended)
powershell -ExecutionPolicy Bypass -File install.ps1

# Batch (cmd)
install.bat

Add to PATH (if installer doesn't detect it):

# PowerShell - persistent for current user
[Environment]::SetEnvironmentVariable('PATH', "$HOME\bin;" + [Environment]::GetEnvironmentVariable('PATH','User'), 'User')

# PowerShell - current session only
$Env:PATH = "$HOME\bin;$Env:PATH"

REM cmd.exe - persistent for current user
setx PATH "%USERPROFILE%\bin;%PATH%"

Codex wrapper not found:

# Check PATH
echo $PATH | grep -q "$HOME/bin" || echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc

# Reinstall
bash install.sh

Permission denied:

python3 install.py --install-dir ~/.claude --force

Module not loading:

# Check installation status
cat ~/.claude/installed_modules.json

# Reinstall specific module
python3 install.py --module dev --force

• Codeagent-Wrapper Guide - Multi-backend execution wrapper
• Hooks Documentation - Custom hooks and automation

• Installation Log - Installation history and troubleshooting

AGPL-3.0 License - see LICENSE

• Issues: GitHub Issues
• Documentation: docs/

Claude Code + Codex = Better Development - Orchestration meets execution.