momentum

Begin a new implementation phase. Activates when the user invokes /start-phase or asks momentum to run the start-phase recipe.

Work with concurrent workstreams (Rule 15). Activates when the session involves multiple active branches, cross-lane coordination, or when starting work that should not live on the current branch.

Record a new backlog item (bug, feature, tech debt, or enhancement) when you discover work that needs tracking. Activates when the session identifies unplanned work that should be tracked in the backlog.

Check spec structure health of the momentum project. Activates when the user runs `/validate`, asks for a health check, or when spec changes need verification before phase completion.

>-

Drive a single repo through its phase as part of a swarm. Activates when spawned by the conductor (the user's primary session) with a spawn directive. State lives in files; the conductor reads board.json between turns. Loads on the swarm-supervisor invocation only — not invoked directly by the user.

Read specs/status.md before starting any work in a momentum-managed project. Activates at the start of every new task to ensure the agent has current phase context. Codifies Rule 1 (Orient First).

Review a code diff for architectural fit, rule compliance, and pattern consistency. Returns Critical/Important/Minor findings only — does not modify code, does not refactor. Loaded by the review-code workflow alongside the security and QA reviewers.

Explore any idea through structured dialogue before committing to anything. Activates when the user invokes /brainstorm-idea or asks momentum to run the brainstorm-idea recipe.

Brainstorm the next phase before creating it. Activates when the user invokes /brainstorm-phase or asks momentum to run the brainstorm-phase recipe.

Verify, finalize, and release a completed phase. Activates when the user invokes /complete-phase or asks momentum to run the complete-phase recipe.

Pick up a pending handoff in this repo. Reads `.momentum/inbox/handoff-NNN.md`, parses the structured context block, marks the inbox file as read, and emits a `[NOTE]` in the receiving repo's active phase history. Activates when the user invokes /continue or asks momentum to run the continue recipe.

Parallel multi-repo fan-out + synthesis. One sub-agent per listed repo with auto-tailored prompts; all results synthesised into a single answer to the user's high-level intent. Writes one dispatch-NNN.md artifact and one session log line. Activates when the user invokes /dispatch or asks momentum to run the dispatch recipe.

Cross-repo ecosystem coordination (Phase 9 Tier 1). Activates when the user invokes /ecosystem or asks momentum to run the ecosystem recipe.

Cross-session control transfer with a structured context block. Writes `<toRepo>/.momentum/inbox/handoff-NNN.md` so a fresh agent session in that repo can pick up where you left off, and emits a `[DECISION]` in this repo's active phase history. Activates when the user invokes /handoff or asks momentum to run the handoff recipe.

Manage cross-repo initiatives in an ecosystem. Activates when the user invokes /initiative or asks momentum to run the initiative recipe.

Record a manual entry in the active phase history file. Activates when the user invokes /log or asks momentum to run the log recipe.

Onboard an existing project with a manual or outdated momentum-like structure into proper momentum format. Activates when the user invokes /migrate or asks momentum to run the migrate recipe.

Read specs/status.md before starting any work in a momentum-managed project. Activates at the start of every new task to ensure the agent has current phase context. Codifies Rule 1 (Orient First).

Review and groom the backlog between phases. Activates when the user invokes /review or asks momentum to run the review recipe.

Read-only context fetch from one ecosystem member repo. Returns a structured summary, writes a scout-NNN.md run artifact, and appends one line to the ecosystem session log. Activates when the user invokes /scout or asks momentum to run the scout recipe.

Append a manual narrative entry to today's ecosystem session log. Activates when the user invokes /session or asks momentum to run the session recipe.

Scaffold a new project from a clear idea. Activates when the user invokes /start-project or asks momentum to run the start-project recipe.

Sync all relevant documents based on the active phase's history log. Activates when the user invokes /sync-docs or asks momentum to run the sync-docs recipe.

Systematically isolate, reproduce, and resolve task execution failures. Activates when the user invokes /systematic-debug or asks momentum to run the systematic-debug recipe.

Track a backlog item — bug, feature, tech debt, or enhancement. Activates when the user invokes /track or asks momentum to run the track recipe.

Check the spec structure health of the current momentum project. Activates when the user invokes /validate or asks momentum to run the validate recipe.

Review a code diff for test coverage, edge cases, and regression risk. Returns Critical/Important/Minor findings only — does not modify code, does not write tests. Loaded by the review-code workflow alongside the security and architecture reviewers.

Review a code diff through a security lens (OWASP Top 10, STRIDE threat categories). Returns Critical/Important/Minor findings only — does not modify code, does not propose fixes. Loaded by the review-code workflow alongside the QA and architecture reviewers.