with one click
create-beads-orchestration
// Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead.
// Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead.
Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead.
Core engineering principles for implementation tasks
Invoke at the start of any implementation task to enforce verification-first development
React and Next.js performance optimization patterns. Use BEFORE implementing any React code to ensure best practices are followed.
| name | create-beads-orchestration |
| description | Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead. |
| user-invocable | true |
Set up lightweight multi-agent orchestration with git-native task tracking and mandatory code review gates.
| Step | Action | Checkpoint |
|---|---|---|
| 1 | Get project info from user | Have project name, directory, AND provider choice |
| 2 | Clone repo and run bootstrap | Bootstrap completes successfully |
| 3 | STOP - Instruct user to restart Claude Code | User confirms they will restart |
| 4 | After restart: Run discovery agent | Supervisors created in .claude/agents/ |
DO NOT:
The setup is NOT complete until Step 4 (discovery) has run.
Ask the user or auto-detect from package.json/pyproject.toml.
Do NOT skip this. Do NOT assume a default. Do NOT proceed without the user's explicit choice.
AskUserQuestion(
questions=[{
"question": "How should read-only agents (scout, detective, architect, scribe, code-reviewer) be executed?",
"header": "Providers",
"options": [
{"label": "Claude only (Recommended)", "description": "All agents run via Claude Task(). Simpler setup, no external dependencies."},
{"label": "External providers", "description": "Delegate to Codex CLI (with Gemini fallback). Requires codex login and optional gemini CLI."}
],
"multiSelect": false
}]
)
After user answers:
--claude-only flag in bootstrap--claude-only flag
DO NOT proceed to Step 2 until you have the provider choice from the user.
git clone --depth=1 https://github.com/AvivK5498/The-Claude-Protocol "${TMPDIR:-/tmp}/beads-orchestration-setup"
# If user selected "Claude only":
python3 "${TMPDIR:-/tmp}/beads-orchestration-setup/bootstrap.py" \
--project-name "{{PROJECT_NAME}}" \
--project-dir "{{PROJECT_DIR}}" \
--claude-only
# If user selected "External providers":
python3 "${TMPDIR:-/tmp}/beads-orchestration-setup/bootstrap.py" \
--project-name "{{PROJECT_NAME}}" \
--project-dir "{{PROJECT_DIR}}"
The bootstrap script will:
.beads/ directory.claude/agents/.claude/hooks/.claude/settings.json.mcp.json for provider_delegatorCLAUDE.md with orchestrator instructions.gitignoreVerify bootstrap completed successfully before proceeding.
Tell the user:
Setup phase complete. You MUST restart Claude Code now.
The new hooks and MCP configuration will only load after restart.
After restarting:
- Open this same project directory
- Tell me "Continue orchestration setup" or run
/create-beads-orchestrationagain- I will run the discovery agent to complete setup
Do not skip this restart - the orchestration will not work without it.
DO NOT proceed to Step 4 in this session. The restart is mandatory.
.claude/agents/scout.md)Task(
subagent_type="discovery",
prompt="Detect tech stack and create supervisors for this project"
)
Discovery will:
.claude/agents/Orchestration setup complete!
Created supervisors: [list what discovery created]
You can now use the orchestration workflow:
- Create tasks with
bd create "Task name" -d "Description"- The orchestrator will delegate to appropriate supervisors
- All work requires code review before completion
rm -rf "${TMPDIR:-/tmp}/beads-orchestration-setup"
With --claude-only (default):
With external providers:
Claude only mode (default):
External providers mode:
codex login for authentication (primary provider)See the full documentation: https://github.com/AvivK5498/The-Claude-Protocol