bmad

中文 English

Claude Code Multi-Agent Workflow System

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

Quick Start

npx github:stellarlinkco/myclaude

Modules Overview

Module	Description	Documentation
do	Recommended - 5-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	11 core dev commands: ask, bugfix, code, debug, docs, enhance-prompt, optimize, refactor, review, test, think	/code, /debug, etc.
sparv	SPARV workflow (Specify→Plan→Act→Review→Vault)	/sparv command
course	Course development (combines dev + product-requirements + test-cases)	Composite module
claudekit	ClaudeKit: do skill + global hooks (pre-bash, inject-spec, log-prompt)	Composite module

Available Skills

Individual skills can be installed separately via npx github:stellarlinkco/myclaude --list (skills bundled in modules like do, omo, sparv are listed above):

Skill	Description
browser	Browser automation for web testing and data extraction
codeagent	codeagent-wrapper invocation for multi-backend AI code tasks
codex	Direct Codex backend execution
dev	Lightweight end-to-end development workflow
gemini	Direct Gemini backend execution
product-requirements	Interactive PRD generation with quality scoring
prototype-prompt-generator	Structured UI/UX prototype prompt generation
skill-install	Install skills from GitHub with security scanning
test-cases	Comprehensive test case generation from requirements

Installation

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

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

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

# Custom install directory / overwrite
npx github:stellarlinkco/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
OpenCode	opencode, stdin mode

Directory Structure After Installation

~/.claude/
├── bin/codeagent-wrapper
├── CLAUDE.md              (installed by default)
├── commands/              (from essentials module)
├── agents/                (from bmad/requirements modules)
├── skills/                (from do/omo/sparv/course modules)
├── hooks/                 (from claudekit module)
├── settings.json          (auto-generated, hooks config)
└── installed_modules.json (auto-generated, tracks modules)

Documentation

• codeagent-wrapper
• Plugin System

Troubleshooting