Synthesize project documentation and codebase into comprehensive roadmap status, gaps analysis, and blockers. Use when assessing project health, identifying blockers, tracking progress, comparing plan vs reality, documenting risks, or planning next milestones. Triggers: "roadmap", "project status", "blockers", "risks", "progress", "next milestone", "gaps", "what's done".
Synthesize project documentation and codebase state into actionable status reports.
Run the shared context discovery protocol in CONTEXT_DISCOVERY.md. Use the scan depth appropriate for the mode:
| Mode | Required Phases | Scan Depth |
|------|----------------|------------|
| plan show | 1 (config) | None — reads {plan_file} directly |
| next (cached) | 1 (config) | None — reads cached file + git drift check |
| update --dry-run | 1, 5, 7 | Medium — config, docs, codebase scan (no write) |
| status (with or without --focus) | 1-7 | Thorough — full protocol |
| next (recalc) | 1-7 | Thorough — full protocol |
| update, update --incremental | 1-7 | Thorough — full protocol |
| plan scaffold, plan sync | 1-7 | Thorough — full protocol |
Store results for analysis below.
Parse from $ARGUMENTS:
| Mode | Description |
|------|-------------|
| status | Overall dashboard — modules, phases, completion + drift detection. Renders Gaps, Blockers, Risks, and Specs as inline sections. Add --focus=<gaps\|blockers\|risks\|specs> to render only one section |
| update | Git-aware status doc update (Phase A: what shipped + Phase B: full scan + auto-chains plan sync). Add --dry-run to preview the diff without writing. Add --incremental for post-sprint targeted edits only |
| next | Prioritized recommendations with caching and smart merge. Saves to {output_dir}/next-actions.md. Returns cached results if <3 feat/fix commits and status doc unchanged; otherwise merge-based recalculation that preserves uncompleted items and user additions. Add --force to recalculate (still merges; delete file manually for clean slate) |
| plan | Project roadmap lifecycle — scaffold (create), show (read), sync (update). Defaults to show if roadmap exists, scaffold if not |
| (none) | Defaults to status. Footer suggests /roadmap next if next-actions.md is stale |
Rate each module using the shared vocabulary in MATURITY_SCALE.md.
statusProduce a status dashboard with module maturity table, then detail: What's working, What's planned, What's missing.
After producing the dashboard, render four focus sections inline:
{plan_file} exists, cross-reference to show which phase each spec belongs to and flag unlinked specsWith --focus=<gaps|blockers|risks|specs>, render only that section (skip the dashboard preamble and other sections).
After producing the dashboard, run drift detection: if 3+ feat/fix commits exist since last {status_file} update, append a staleness notice suggesting /roadmap update.
updateGit-aware status document update. See WORKFLOW.md § update for the full Phase A (git history scan) + Phase B (codebase scan + write) protocol.
Key behaviors:
+/-/~ markers, requires confirmation before writingplan sync when phase/spec status changes detected/roadmap next will detect status doc changes and trigger merge-based recalculation (preserves uncompleted items)--dry-run variant: runs Phase A + Phase B but stops at the diff preview without prompting or writing — read-only comparison of status doc vs current codebase--incremental variant: surgical targeted edits only (skips Phase B full scan)nextPrioritized recommendations with git-aware caching and smart merge. See WORKFLOW.md § next for the full merge protocol.
Key behaviors:
{output_dir}/next-actions.md### User-Added section always preserved across recalculations+/-/~/= markers before writing (confirmation required)planConsolidated project roadmap lifecycle. Read plan_file from .arkhe.yaml (default: docs/PROJECT-ROADMAP.md).
| Subcommand | Description |
|------------|-------------|
| scaffold | Create initial PROJECT-ROADMAP.md using hybrid linking algorithm — see WORKFLOW.md § plan scaffold |
| show | Read-only summary with timeline, progress stats, active phases, drift detection |
| sync | Git-aware update with auto-detected links — see WORKFLOW.md § plan sync |
| (none) | Default to show if roadmap exists; scaffold if not |
Legacy file fallback: If {plan_file} is unset in .arkhe.yaml and docs/PROJECT-PLAN.md exists while docs/PROJECT-ROADMAP.md does not, treat the legacy path as {plan_file} for this run and emit a one-time migration notice suggesting mv docs/PROJECT-PLAN.md docs/PROJECT-ROADMAP.md (or pinning plan_file in .arkhe.yaml).
update and plan scaffold/plan sync show unified diff preview and require explicit confirmation before writing--deep reports are saved by default to {output_dir}/reports/; user can opt out--deep)When $ARGUMENTS contains --deep, run the full multi-agent pipeline with parallel cross-perspective analysis. Three Sonnet agents analyze the project simultaneously from PM, Architect, and Roadmap perspectives, then a synthesizer merges findings and surfaces contradictions.
See WORKFLOW.md § Deep Pipeline for the 5-phase execution protocol.
Phase 4 produces a Confidence Scoreboard table with independent scores per finding. Findings below 70 are removed; 70-89 are tagged [NEEDS VALIDATION].
Patterns applied: Pipeline, Supervisor-Worker, Parallel Execution, Confession, Confidence-Gated Completion.
See the Roadmap Analyst section of LANE_DISCIPLINE.md. Stay in your lane.
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer