ReinaMacCredy/maestro
Agent Skills (compatible with Claude Code, Codex, and more—for details visit: https://agentskills.io/home) with Conductor planning, Beads tracking, and TDD for AI-assisted development
Deep Analysis
面向AI编码代理的上下文驱动开发框架，强调"先计划后编码"的TDD工作流
Core Features
Technical Implementation
- 结构化四步工作流：设计-计划-实现-完成
- 支持多AI代理平台兼容
- 多代理并行执行能力
- 会话状态跨重启保留
- 完善的文档体系（Tutorial/Setup/Reference）
- 复杂功能开发需要先期规划
- 团队使用AI代理进行协作开发
- 需要TDD规范的项目
- 长周期任务需要持久化追踪
- 多AI代理协同工作场景
- 学习曲线较陡，需理解Double Diamond等方法论
- 命令较多需要记忆
- 主要适合规模较大的开发任务
- 对简单任务可能过度工程化
Maestro
Context-driven development for AI coding agents. Plan first, code once.
Install
Claude Code:
/plugin install https://github.com/ReinaMacCredy/maestro
Amp:
amp skill add https://github.com/ReinaMacCredy/maestro --global
Other agents (Codex, Cursor, Gemini CLI)
Codex CLI:
# Add to .codex/AGENTS.md
git clone https://github.com/ReinaMacCredy/maestro ~/.codex/plugins/maestro
Cursor:
# Copy skills to .cursor/skills/
git clone https://github.com/ReinaMacCredy/maestro ~/.cursor/plugins/maestro
Gemini CLI:
# Add to GEMINI.md
git clone https://github.com/ReinaMacCredy/maestro ~/.gemini/plugins/maestro
Quick Start
graph LR
A[ds] --> B[/conductor-newtrack]
B --> C[/conductor-implement]
C --> D[/conductor-finish]
ds— Start a design session (Double Diamond methodology)/conductor-newtrack— Generate spec, plan, and beads from design/conductor-implement— Execute with TDD checkpoints/conductor-finish— Archive track and extract learnings
Skills
| Skill | Trigger | Purpose |
|---|---|---|
| conductor | /conductor-* |
Implementation execution, TDD |
| designing | ds |
Double Diamond design sessions |
| tracking | fb, rb, bd |
Persistent issue tracking |
| orchestrator | /conductor-orchestrate |
Multi-agent parallel execution |
| handoff | /conductor-handoff |
Session context preservation |
| maestro-core | (auto) | Routing and fallback policies |
| creating-skills | — | Skill authoring guide |
| sharing-skills | — | Contribute skills upstream |
| using-git-worktrees | /worktree |
Isolated dev environments |
Key Rules
- Design before code — Run
dsto explore before implementing - TDD by default — Never write production code without a failing test
- Beads track work — Use
bdCLI for persistent task management - Handoffs preserve context — Session state survives across restarts
- One question at a time — Design sessions ask focused questions
Documentation
| Topic | Path |
|---|---|
| Tutorial | TUTORIAL.md |
| Setup Guide | SETUP_GUIDE.md |
| Reference | REFERENCE.md |
| Changelog | CHANGELOG.md |
| Workflow Chain | skills/maestro-core/references/workflow-chain.md |
| Routing Table | skills/maestro-core/references/routing-table.md |
Credits
Maestro builds on the shoulders of giants:
- BMAD-METHOD — Multi-agent design methodology
- conductor — Context-driven development patterns
- beads — Issue tracking for AI agents
- Agent Mail — Multi-agent coordination
License
Related Skills
wshobson/agents
wshobsonIntelligent automation and multi-agent orchestration for Claude Code
The most comprehensive Claude Code plugin ecosystem, covering full-stack development scenarios with a three-tier model strategy balancing performance and cost.
ComposioHQ/awesome-claude-skills
ComposioHQA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
The most comprehensive Claude Skills resource list; connect-apps is a killer feature.
code-yeongyu/oh-my-opencode
code-yeongyuThe Best Agent Harness. Meet Sisyphus: The Batteries-Included Agent that codes like you.
Powerful multi-agent coding tool, but note OAuth limitations.
nextlevelbuilder/ui-ux-pro-max-skill
nextlevelbuilderAn AI SKILL that provide design intelligence for building professional UI/UX multiple platforms
Essential for designers; comprehensive UI/UX knowledge base.
thedotmack/claude-mem
thedotmackA Claude Code plugin that automatically captures everything Claude does during your coding sessions, compresses it with AI (using Claude's agent-sdk), and injects relevant context back into future sessions.
A practical solution for Claude's memory issues.
OthmanAdi/planning-with-files
OthmanAdiClaude Code skill implementing Manus-style persistent markdown planning — the workflow pattern behind the $2B acquisition.
Context engineering best practices; an open-source implementation of Manus mode.