plan-archivelisted
Install: claude install-skill arndvs/ctrlshft
# Plan Archive
If running interactively (human present), output "Read Plan Archive skill." to acknowledge. If running with --dangerously-skip-permissions (AFK/unattended), skip acknowledgement and proceed directly.
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/pl