/plan

Archive completed plans with optional journal documentation.

Syntax

/plan:archive                  # Archive all plans
/plan:archive [plan-path]      # Archive specific plan

Workflow

  1. Read Plans - Analyzes plan directory structure and phase files
  2. Journal Entries (Optional) - Document key events, decisions, impacts
  3. Confirm Action - Choose specific plans or all completed plans
  4. Archive Method - Move to ./plans/archive/ or delete permanently
  5. Commit Changes (Optional) - Stage and commit via /git:cm or /git:cp

Journal Documentation

If enabled, creates entries in ./docs/journals/ directory:

  • Concise summaries of plan progress
  • Key changes and impacts
  • Important decisions made
  • Lessons learned

Archive Options

Move to archive:

  • Preserves plan history
  • Organized in ./plans/archive/
  • Searchable and accessible

Delete permanently:

  • Removes plan files completely
  • Recommended only for abandoned/duplicate plans

Output Summary

After archiving:

  • Number of plans archived/deleted
  • Table of affected plans (title, status, created date, LOC)
  • Table of journal entries created
  • Commit status if changes committed

Examples

/plan:archive
# Prompts for journal → selects plans → archives

/plan:archive plans/260128-auth-implementation/
# Archives specific plan only