implement-next

Implement Next

Purpose

Advance exactly one ready task from the TASKS.md ledger through a single implementation cycle, using its persisted issue brief as context. One invocation advances at most one task; it never iterates. Repeat the command for the next task.

Preconditions

• TASKS.md exists and is an index-only ledger whose rows link to issue briefs.
• If TASKS.md is missing or contains no ready task, stop and report the ledger state; do not invent work.

Flow

1. Read TASKS.md and select the first task in state ready.
   • Stop at a human-gate task and explain the approval it needs; do not proceed past it.
   • Skip blocked and sequenced tasks; they are not ready.
   • If no ready task exists, stop and report.
2. Mark the selected task in-progress in TASKS.md through the client's write-approval flow.
3. Load the linked issue brief and run subagent-driven-change with the brief as Fresh Context. Its owner runs code-quality-reviewer before change-risk-reviewer; initiate or resume the closed change-risk handoff and report its current state, but do not independently invoke another review, redefine budgets, or reset counters.
4. Mark the task done only after the owner returns a validated terminal CLEAN handoff and required tests run green. Validate the closed ChangeRiskOrchestrationStateV1 record; its snapshot matches the current snapshot (modulo docs/review-learning/) and its terminal status is CLEAN. Do not infer completion from free-form prose or an unvalidated status. The next task requires a new invocation.
5. If the validated handoff reports NO_PROGRESS or NEEDS_HUMAN_REVIEW, report that outcome and its required escalation; do not mark the task done or start another review. Keep the task out of done until a human resolves the escalation.

Failure Path

Stop and report BLOCKED when any of these holds:

• implementer returns BLOCKED or NEEDS_CONTEXT,
• a review finding cannot be resolved within the brief's scope,
• GREEN is unreachable within the brief's declared seam.