Execute Plan

Step 2: Execute Per-Phase Loop

For each phase in order:

1. Skip Completed

   • If status is [x], continue to next phase.

2. Mark In Progress

   • Update phase status to [-] before making changes.

3. Execute Exactly

   • Implement only the tasks defined in that phase.
   • Do not expand scope without approval.

4. Verify Phase

   • Run the phase-specific verification commands from the plan.
   • At minimum, run relevant tests/checks tied to touched files.

5. Handle Failures

   • If verification fails:
     • Attempt focused fixes within phase scope.
     • Re-run verification.
   • If still failing or root cause is outside scope, stop and report blocker.

6. Mark Complete

   • Update phase status to [x] only after verification passes.

7. Progress Report

   • Interactive mode: report and wait for confirmation before next phase.
   • Batch mode: report briefly and continue immediately.

Step 3: Final Verification

After all phases are complete:

1. Project-Wide Validation

   • Run full lint/type-check suite
   • Run all relevant tests (or full test suite if required by the plan)
   • Run build verification if applicable

2. Stabilize

   • Fix regressions introduced during execution.
   • Re-run failed checks until green or blocked.

3. Manual Validation Checkpoint

   • If user/manual QA is required, ask explicitly and pause:
     • Verified to accept
     • or provide feedback for follow-up iteration

Step 4: Completion Artifacts

1. Documentation Sync

   • If behavior/architecture/codebase expectations changed, update the docs artifacts.

2. Create Execution Report

   • File: docs/plans/YYMMDD-HHmm-<plan-slug>/EXECUTION-REPORT.md
   • Include all required sections below.

3. Archive Plan Folder

   • Move the plan folder to docs/plans/archived/ after the execution report is created.
   • Command: mkdir -p docs/plans/archived && mv docs/plans/YYMMDD-HHmm-<plan-slug> docs/plans/archived/

4. Announce Completion

   • Output: Execution complete. Report archived at docs/plans/archived/YYMMDD-HHmm-<plan-slug>/EXECUTION-REPORT.md.

Step 5: Final Confirmation Gate

After completion artifacts are done, ask the user for a final confirmation using the Question Tool with exactly these options:

• Confirm: End session
• Confirm and Auto commit git
• Need verify

Handle the selected option as follows:

1. Confirm: End session

   • End the execution session.

2. Confirm and Auto commit git

   • Trigger the git-commit skill and complete an automatic commit flow.
   • After commit succeeds, end the execution session.

3. Need verify

   • Allow the user to provide verification feedback/details.
   • Continue the execution loop to address feedback, then re-run verification and completion steps as needed.

Execution Report Standard

EXECUTION-REPORT.md must use this structure:

Execution Report: <Plan Title>

Date: YYYY-MM-DD HH:mm:ss
Mode: Batch | Interactive

Summary

• Overall result (Completed | Completed with follow-ups | Blocked)
• High-level outcome in 2-4 bullets

Phase Results

• Phase 1: <name> — ✅/⚠️
  • Implemented:
  • Verification:
  • Notes:
• Phase 2: ...

Verification Matrix

• Lint: pass/fail (command)
• Type-check: pass/fail (command)
• Tests: pass/fail (command)
• Build: pass/fail (command)
• Manual QA: pass/fail/pending

Deviations

• List any approved deviations from the original plan.
• If none: None.

Blockers and Resolutions

• Blocker:
• Impact:
• Resolution:
• Status:

Follow-ups

• Remaining tasks, if any
• Recommended owner/next action

Changed Files

• Relative path list (grouped by area if large)

Rules

• Follow the plan strictly: no silent scope changes.
• Stop on blocker: missing dependency, contradictory instructions, or unexplained failures.
• No guessing: ask for clarification when uncertain.
• Verify before complete: never mark phase done without passing checks.
• Idempotency: prefer safe/re-runnable operations.
• Respect project standards: follow docs/code-standard.md and related project docs.
• Do not skip workflow steps: initialization, per-phase verification, final verification, and reporting are all mandatory.