Claude Code Multi-Agent Workflow System

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

Quick Start

npx github:cexll/myclaude

Modules Overview

Module	Description	Documentation
do	Recommended - 7-phase feature development with codeagent orchestration	`/do` 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

# Interactive installer (recommended)
npx github:cexll/myclaude

# List installable items (modules / skills / wrapper)
npx github:cexll/myclaude --list

# Detect installed modules and update from GitHub
npx github:cexll/myclaude --update

# Custom install directory / overwrite
npx github:cexll/myclaude --install-dir ~/.claude --force

--update detects already installed modules in the target install dir (defaults to ~/.claude, via installed_modules.json when present) and updates them from GitHub (latest release) by overwriting the module files.

Module Configuration

Edit config.json to enable/disable modules:

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

Workflow Selection Guide

Scenario	Recommended
Feature development (default)	`/do`
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

Troubleshooting

Common Issues

Codex wrapper not found:

# Select: codeagent-wrapper
npx github:cexll/myclaude

Module not loading:

cat ~/.claude/installed_modules.json
npx github:cexll/myclaude --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
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

cexll/myclaude

README