Instructions for ReinaMacCredy/maestro: TypeScript on Bun, released as v0.108.0 (the first TypeScript release; 0.107.x was the Rust line, whose stores are preserved under legacy/rust/). Work happens on main; the rewrite-maestro-in-typescript branch and the .maestro/worktree/rewrite-ts worktree are retired.
Turn filed lessons into the smallest doctrine edit - group pending lessons by target, make one commit per target carrying their evidence ids, mark each lesson processed by that commit or answered with the reason it was rejected, and hand back for the challenge lane.
Verify and close - cross-check coverage, run the VERIFY table, deliver the verdict, harvest durable lessons into decisions, close the bundle, and never claim remote state from local evidence.
Generate beautiful, self-contained HTML blueprint pages that visually plan implementations with architecture diagrams, phased task breakdowns, file change maps, dependency graphs, risk matrices, and verification checklists. Use this skill whenever the user asks for a blueprint, implementation plan, feature spec…
Parallel read-only multi-agent root-cause investigation for bugs, regressions, crashes, flaky behavior, or unexplained failures. Use when the user asks to investigate a bug, find the root cause, trace a regression, understand why something broke, or wants a ranked diagnosis with the fastest proof path without making…
Designs or reviews CLIs so coding agents can run them reliably: non-interactive flags, layered --help with examples, stdin/pipelines, fast actionable errors, idempotency, dry-run, and predictable structure. Use when building a CLI, adding commands, writing --help, or when the user mentions agents, terminals, or…
Deep codebase audit that first reads project docs (AGENTS.md, README.md) and investigates the architecture, then systematically finds hardcoded constants that should be dynamic and unfinished code (TODOs, "will"/"would" in comments). Use this skill when the user wants a thorough code review for hygiene issues, asks to…
Isolated Codex goal-loop skill that combines spec-to-plan, goal-loop-native phase planning, and gated phase-by-phase execution. Use when the user asks to turn a spec into a goal-loop plan, run a goal-loop plan, or package the spec-to-goal-plan, goal-loop-planner, and goal-loop flow as one Codex skill. Planner work…
Use when the user asks to consult ChatGPT Pro, ask chatgpt.com, get an external ChatGPT second opinion, have GPT Pro review a plan, codebase, diff, design, architecture, bug, or "ask your big brother" through the Codex in-app browser. This skill uses browser-use:browser with the iab backend, prepares an allowlisted…
Use when the user asks to consult ChatGPT Pro, ask chatgpt.com, get an external ChatGPT second opinion, have GPT Pro review a plan, codebase, diff, design, architecture, bug, or "ask your big brother". This skill builds an allowlisted sanitized review packet, shows the exact packet and active ChatGPT account/workspace…
Distill the current session — conversation, decisions, corrections, repo state, and recent history — into a single paste-ready /goal prompt that drives an autonomous phase-by-phase loop (decompose → Plan-subagent on Opus → main-thread execute → re-measure → repeat) until the success criterion is met or a stop…
Autonomous phase-by-phase plan execution for Claude Code. A single self-contained skill (goal-loop) that decomposes each phase via Plan-subagent, dispatches parallel implementation waves through the inlined orchestrator pattern, gates every phase with advisor + /code-review + the inlined review-swarm protocol, and…
Autonomous phase-by-phase plan execution loop. Plan-subagent decomposes each phase into a dependency-tagged wave graph, parallel Opus sub-agents implement via the inlined orchestrator pattern (main thread plans/synthesizes, sub-agents do all edits), advisor + /code-review --effort extra-high + the inlined review-swarm…
Generates AGENTS.md file using the WHAT/WHY/HOW framework. Explores the codebase and produces a minimal (<100 line) context file with progressive disclosure.
Designs or reviews MCP servers so AI agents can use them reliably: outcome-oriented tools, flat constrained parameters, actionable errors via isError, token-efficient responses, composable outputs, and disciplined tool surfaces. Use when building an MCP server, adding tools to one, reviewing MCP tool design, or when…
Deep strategic analysis of a project to identify the single highest-leverage, most innovative addition. Use this whenever the user asks what to build next, what the most impactful improvement would be, what the "next big thing" is for their project, what's the smartest thing to add, or any question about strategic…
Enter orchestration-only mode where Claude plans, delegates to sub-agents, and synthesizes results instead of implementing directly. Use whenever the user says they want to act as tech lead, wants Claude to orchestrate, wants sub-agents to do the work, says things like "you orchestrate, I brainstorm", "don't code…
Parallel read-only multi-agent review of a current git diff or explicit file scope to find behavioral regressions, security or privacy risks, performance or reliability issues, and contract or test coverage gaps. Use when the user asks for a review swarm, parallel review, diff review, regression review, security…
Review a git diff or explicit file scope for reuse, code quality, efficiency, clarity, and standards issues, then optionally apply safe Codex-driven fixes. Use when the user asks to "simplify code", "review changed code", "check for code reuse", "review code quality", "review efficiency", "simplify changes", "clean up…
Disciplined bug-fix-and-lock-down workflow: catalog every issue, fix each one with verification, then create comprehensive e2e integration tests that would have caught each fixed issue plus similar failure modes. Use this skill whenever the user has just identified multiple bugs or problems to fix, wants to fix…