Plan Retrospective Skill

Role: Opt-in plan quality audit. Analyzes a plan's artifacts, logs, metrics, chat history, and invariant outcomes; compiles a quality-verification-report.md (or quality-verification-report-audit-{timestamp}.md in archived mode) and proposes lessons-learned drafts.

Design intent: Python scripts produce deterministic TOON fragments (facts). The orchestrator loads aspect reference docs on-demand so the LLM can synthesize judgement from those facts. Scripts never judge; references never run code.

Enforcement

Execution mode: Select a mode (finalize-step live, user-invocable live, archived) from the Input Contract, dispatch the 14 aspect references in the documented order, compile the report, propose lessons, then emit the mode-appropriate termination (mark-step-done tail for finalize-step mode only).

Prohibited actions:

• Never re-run invariant capture. Read status.metadata.phase_handshake or status.metadata.invariants directly — invariants are already captured by phase transitions.
• Never write to archived plan directories. Archived mode writes the report next to the archived plan, but the plan state itself is read-only.
• Never call mark-step-done in archived mode or user-invocable live mode — only the finalize-step mode emits the handshake tail.
• Never silently skip aspect dispatch. If a script fails, record the failure in the report under "Script failure analysis" and continue.
• Do not modify any .plan/ files directly — all plan state access goes through manage-* scripts and the scripts in this skill.