claude-code-orchestrator-kit

Claude Code Orchestrator Kit transforms Claude Code into an intelligent orchestration system by delegating specialized tasks to 39 domain-expert agents while preserving context and enabling indefinite work sessions. The toolkit includes 38 reusable skills covering validation, reporting, senior-level code review, and DevOps expertise, plus 25 slash commands for health checks, issue tracking via Beads, and multi-agent coordination via Gastown. Key innovations include an inline skills architecture that reduces token overhead from 10,000+ to 500, auto-optimized MCP configuration across 6 servers, and mandatory quality gates after every delegation. Teams building production projects with Claude Code can maintain lean main sessions (10-15K tokens vs 50K+ standard) while leveraging specialized agents for bugs, security, database, frontend, testing, and DevOps tasks.

[{"step":1,"action":"Initialize the orchestrator in your project root. Run: `claude-code-orchestrator-kit init` and select your tech stack (Node.js, Python, etc.). This generates a `.claude-orchestrator/` directory with MCP configs and slash command templates.","tip":"Use `/init --preset=full` for the most comprehensive setup, including security scanning and dependency management."},{"step":2,"action":"Define your workflow in `workflows.json`. Example: `{ \"name\": \"nightly-build\", \"steps\": [\"update-deps\", \"security-scan\", \"run-tests\", \"deploy-staging\"] }`.","tip":"Leverage the 19 built-in slash commands (e.g., `/update-deps`, `/security-scan`) to avoid writing custom scripts. Use `--auto-approve` for non-critical steps."},{"step":3,"action":"Set up quality gates in `quality-gates.toml`. Configure thresholds for test coverage, linting errors, and security scores. Example: `[coverage] minimum = 85` or `[security] max_critical = 0`.","tip":"Run `/health-check --dry-run` to simulate the workflow and validate gate configurations before execution."},{"step":4,"action":"Trigger the workflow manually or via CI. Use `/orchestrate --workflow=nightly-build` or integrate with GitHub Actions using the `claude-code-orchestrator-action`.","tip":"Monitor progress in real-time via the built-in dashboard (accessible at `http://localhost:3000/orchestrator`). Use `/logs --tail=50` to fetch recent logs."},{"step":5,"action":"Review the final report and act on failures. Use `/rollback --last-deploy` if the deployment fails quality gates. Investigate agent logs for root causes.","tip":"Enable MCP health monitoring (`mcp-health-monitor.toml`) to receive Slack/email alerts for agent failures or resource constraints."}]