maestro

Verify planning docs, build parallelization plan, orchestrate agents in worktrees — only when it actually makes sense.

Source modes

Pick one with the user before scanning:

1. Auto-scan (default) — py -3 scripts/scan_plans.py --root . (Windows; use python3 on POSIX) finds docs/plans/*.md, docs/prds/*.md, docs/adrs/*.md, plus common variants.
2. User paths — user passes file globs or absolute paths.
3. Conversation context — when the current chat already contains a settled plan/PRD/ADR, use that text directly (write it to a temp file under the repo's .claude/tmp/ so the parsers can read it).

Always confirm the source set with the user before extraction.

Workflow

All scripts run on Python 3. On Windows use py -3 (this user's default python is Py2.7); on POSIX use python3. Examples below show py -3.