arndvs/plan-archive
skills/plan-archive/SKILL.md
Use after merging a PR or during periodic cleanup to archive plan-mode files by linking them to merged PRs.
tools
Updated May 21, 2026
$ install --global
skillsauthnpx skillsauth add arndvs/ctrlshft plan-archiveInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 21, 2026, 2:16 AM142.5s2 files scanned
SKILL.md
- name:
- plan-archive
- description:
- Use after merging a PR or during periodic cleanup to archive plan-mode files by linking them to merged PRs.
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.
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:
# 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:
# 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 filenames
- Cross-references to other PRs that matched the same plans
Options
| Flag | Description |
|------|-------------|
| --mode | audit, archive-pr, or backfill (required) |
| --pr | PR number (required for archive-pr) |
| --since | Time window for backfill: 30d, 2w, 12h (default: 30d) |
| --execute | Actually move files (default: dry-run) |
| --repo | Override GitHub repo (default: cwd's repo) |
| --plans-dir | Override plans directory (default: ~/.claude/plans) |
| --limit | Max PRs to fetch for backfill (default: 200) |
How Plan Matching Works
- Fetches the PR's diff file list via
gh pr diff --name-only - Parses each plan's
## Filessection for declared file paths - Normalizes paths to repo-relative form
- Matches plans with >= 1 file overlap with the PR diff
- Plans are assigned to the earliest-merged PR that claims them (no double-archive)
Related Skills
arndvs/visual-feedback
development
VerifiedTrustedCommunity
Use when implementing UI, checking dark/light mode, or validating animations — adds a visual feedback loop via browser screenshots so frontend changes are verified, not assumed.
SKILL.mdUpdated May 21, 2026
arndvs/press1-check
development
VerifiedTrustedCommunity
Use when Claude Code sessions had many manual approval ("press 1") prompts or when auditing hook permissions; identifies which Bash commands required approval.
SKILL.mdUpdated May 21, 2026
arndvs/grill-with-docs
testing
VerifiedTrustedCommunity
Use when stress-testing a plan against the project's domain model — grills the design, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.
SKILL.mdUpdated May 21, 2026
arndvs/session-close
testing
VerifiedTrustedCommunity
Pre-flight checklist that runs quality gates before ending a coding session.
SKILL.mdUpdated May 19, 2026