maestro-dev

Maestro

Complete development workflow for Claude Code and Codex: issue pipeline, tracked development with specs and plans, UAT, codebase review, and session wrap-up. Uses Superpowers as the execution engine for brainstorming, planning, TDD, and subagent-driven development.

Install

Claude Code plugin (recommended)

# Add as a marketplace source
claude plugin marketplace add owebboy/maestro

# Install the plugin
claude plugin install maestro@maestro-dev

Via project settings

Add to your project's .claude/settings.json so collaborators get Maestro (and recommended plugins) automatically when they trust the project folder:

{
  "enabledPlugins": {
    "maestro@maestro-dev": true,
    "superpowers@superpowers-marketplace": true,
    "elements-of-style@superpowers-marketplace": true,
    "code-simplifier@claude-plugins-official": true,
    "claude-md-management@claude-plugins-official": true
  },
  "extraKnownMarketplaces": {
    "maestro-dev": {
      "source": {
        "source": "github",
        "repo": "owebboy/maestro"
      }
    },
    "superpowers-marketplace": {
      "source": {
        "source": "github",
        "repo": "obra/superpowers-marketplace"
      }
    },
    "claude-plugins-official": {
      "source": {
        "source": "github",
        "repo": "anthropics/claude-plugins-official"
      }
    }
  }
}

Project-scoped (manual)

# Both harnesses at once
./bin/setup-project --both /path/to/your/project

# With Superpowers (recommended — powers brainstorming, planning, and execution)
./bin/setup-project --both --with-superpowers /path/to/your/project

Codex: See codex/INSTALL.md

Architecture

Maestro provides organization and coordination. Superpowers provides execution.

Maestro (WHAT and WHEN)                    Superpowers (HOW)
├── /setup          → project context      ├── brainstorming → design
├── /new-track      → spec + invokes ────► ├── writing-plans → plan
├── /implement      → track mgmt + ──────► ├── subagent-driven-development
├── /status         → progress view        ├── test-driven-development
├── /manage         → lifecycle            ├── systematic-debugging
├── /triage         → issue pipeline       ├── verification-before-completion
├── /issue-review   → codebase explore     └── finishing-a-development-branch
├── /issue-advance  → issue → track
├── /issue-close    → archive issue
├── /codebase-review → 6+6 agents
├── /uat-create     → UAT checklist
├── /uat-run        → interactive proctor
├── /session-wrap-up → session cleanup
└── /agents-md-sync → Codex interop

Skills

Track Management

Skill	Command	Purpose
setup	/setup	Initialize project context (product, tech stack, workflow)
new-track	/new-track <type> <name>	Create spec → brainstorm → plan (via Superpowers)
implement	/implement [track-id]	Execute plan with TDD + subagent review (via Superpowers)
status	/status [track-id]	Project progress, current focus, next actions
manage	/manage [--archive|--restore|--delete]	Track lifecycle management

Issue Pipeline

Skill	Command	Purpose
triage	/triage	INBOX.md bullets → structured issue files
issue-review	/issue-review <path>	3 parallel agents enrich issue with codebase context
issue-advance	/issue-advance <path|all>	Issue → new track (spec + brainstorm + plan)
issue-close	/issue-close <path>	Archive as wont-fix, deferred, or duplicate

Flow: INBOX.md → /triage → /issue-review → /issue-advance → /implement

Quality

Skill	Command	Purpose
codebase-review	/codebase-review [scope]	6+6 parallel agents: review wave then audit wave
uat-create	/uat-create	Completed tracks → UAT checklist
uat-run	/uat-run [file|date]	Interactive UAT proctor with failure capture
session-wrap-up	/session-wrap-up	End-of-session: quality review, issue capture, context updates, commit

Routing & Interop

Skill	Invocation	Purpose
workflow-router	Auto-activates	Routes to the right skill based on task type
agents-md-sync	/agents-md-sync	Generate AGENTS.md from CLAUDE.md for Codex

Hooks

Two lifecycle hooks auto-activate when the plugin is installed (via hooks/hooks.json). No manual settings.json configuration needed.

Hook	Event	What it does
session-start-issues.sh	SessionStart	Shows inbox/triaged/reviewed counts at session start
validate-issue-frontmatter.sh	PostToolUse (Write/Edit)	Validates issue file frontmatter (status, type, priority, filed)

Codex