plan-archivelisted
Install: claude install-skill arndvs/ctrlshft
# Plan Archive
Archives `~/.claude/plans/*.md` files by matching them to merged PRs via
file-overlap analysis, then moves them into organized directories with
metadata linking back to the PR, Linear tickets, and commits.
## When to Use
- After merging a PR: archive the plans it consumed
- Periodically: backfill to clean up accumulated plan files
- Before auditing: see what active plans exist and flag orphans
## Modes
### Audit (read-only)
List all active plans with last-modified dates. Good for seeing what's
accumulated.
```bash
python3 skills/plan-archive/plan-archive.py --mode=audit
```
### Archive one PR (dry-run by default)
Match plans to a specific merged PR and archive the bundle:
```bash
# Dry-run — see what would move
python3 skills/plan-archive/plan-archive.py --mode=archive-pr --pr=42
# Execute — actually move files
python3 skills/plan-archive/plan-archive.py --mode=archive-pr --pr=42 --execute
```
### Backfill (scan recent merged PRs)
Scan all merged PRs within a window and archive matching plans:
```bash
# Dry-run — see what would be archived
python3 skills/plan-archive/plan-archive.py --mode=backfill --since=30d
# Execute
python3 skills/plan-archive/plan-archive.py --mode=backfill --since=2w --execute
```
## Output
Archived plans go to `~/.claude/plans/archive/by-pr/PR-<num>-<branch-slug>/`
with a `_meta.yaml` containing:
- PR number, URL, title, branch, merge date, merge SHA
- Linear ticket references (CC-NNN pattern)
- List of archived plan fi