| name | plan-archive |
| description | Archive completed plans, extract lessons learned, and write journey journals to long-term memory |
| layer | hub |
| category | workflow |
| triggers | ["/plan-archive","archive this plan","plan is done","wrap up the plan","write a retrospective"] |
| inputs | [{"plan":"The completed (or abandoned) implementation plan"},{"outcome":"What actually happened -- successes, deviations, failures (optional, will be inferred from context)"},{"journalNotes":"User-provided reflections or notes (optional)"}] |
| outputs | [{"archive":"Structured archive entry with plan summary, outcome, and metadata"},{"journeyJournal":"Narrative lessons-learned document for long-term memory"},{"patterns":"Extracted reusable patterns or anti-patterns"}] |
| linksTo | ["kanban","research"] |
| linkedFrom | ["plan","cook","team","ship"] |
| preferredNextSkills | ["kanban","brainstorm"] |
| fallbackSkills | ["plan"] |
| riskLevel | low |
| memoryReadPolicy | selective |
| memoryWritePolicy | selective |
| sideEffects | ["Writes archive entry to memory","Writes journey journal to memory","Updates kanban board status if applicable"] |
Plan-Archive Skill
Purpose
Close the loop on completed or abandoned plans by extracting what happened, why it happened, and what future plans should learn from it. This skill transforms lived experience into institutional memory.
Without archiving, every plan starts from zero. With archiving, each plan benefits from all prior plans.
Workflow
Phase 1: Outcome Capture
- Locate the plan -- Find the plan being archived from context, memory, or user reference.
- Determine plan status:
- Completed: All phases delivered as planned
- Completed with deviations: Delivered, but the path diverged from the plan
- Partially completed: Some phases delivered, others not
- Abandoned: Plan was discarded before completion
- For each phase, document:
- Was it completed? (Yes / Partial / No / Skipped)
- Did it match the plan? (Yes / Deviated / Completely Changed)
- What was the actual complexity vs. estimated?
- Any surprises or blockers encountered?
Phase 2: Deviation Analysis
- Map plan vs. reality -- For every deviation between planned and actual:
- What changed?
- Why did it change? (bad assumption, new info, scope change, technical constraint)
- Was the change an improvement or a compromise?
- Assess assumption accuracy -- Go through the original assumptions list:
- Which were correct?
- Which were wrong? What was the actual truth?
- Which were never tested?
- Assess risk accuracy -- Go through the original risks list:
- Which risks materialized?
- Which did not?
- Were there risks that actually happened but were not on the list?
Phase 3: Lesson Extraction
- Identify patterns -- Reusable insights that apply beyond this specific plan:
- Positive patterns: "When we did X, it worked well because Y"
- Anti-patterns: "When we assumed X, it caused Y; instead do Z"
- Process patterns: "Breaking phase N into smaller chunks would have helped"
- Identify decision points -- Key moments where choices were made:
