christophecapel /plan-archive
Plans accumulate every time you enter plan mode. This skill groups them by the PR that executed them and moves the bundle into ~/.claude/plans/archive/by-pr/PR-<num>-<branch-slug>/ with a _meta.yaml linking back to PR + Linear tickets + commits.
Usage
# Audit only — list active plans, flag orphans
python3 plan-archive.py --mode=audit
# Archive a specific merged PR
python3 plan-archive.py --mode=archive-pr --pr=123 --execute
# Backfill: scan recent merged PRs and archive matches
python3 plan-archive.py --mode=backfill --since=14d --execute
All modes default to --dry-run. Add --execute to actually move files.
Configuration
| Env var | Purpose | Default |
|---|---|---|
CLAUDE_PLAN_REPO_PREFIXES |
Path prefixes treated as repo-relative when matching plan files to PR diffs | auto-detect via git rev-parse --show-toplevel |
CLAUDE_PLAN_PR_URL_TEMPLATE |
GitHub PR URL template with {number} placeholder |
auto-detect from git remote get-url origin |
Both auto-detect from the cwd's git repo, so the defaults work in any repo. Set the env vars only if you need to override (e.g. running from outside a repo).
Implements
Mechanism #5 — Deferred work needs persistent markers. See https://github.com/christophecapel/claude-mechanisms
Related
plan-review-gate(in this toolkit,hooks/plan-review-gate.py) — Phase 2 of the gate uses the sameplan_files_libparsing to match PR diffs to plans