Plan archive

Skill christophecapel/claude-mechanisms-tools/skills/plan-archive

Archive completed plan-mode files in ~/.claude/plans/ by linking them to their merged PR. Use when plans accumulate and you want the list to show only active work.From its SKILL.md

Install

npx -y skills add christophecapel/claude-mechanisms-tools --skill plan-archive

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 3 commands, including `python3 plan-archive.py --mode=audit` and 2 more.

SKILL.md

1.6 KB, 379 tokens by cl100k_base, as published. Nobody here has run it

/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

plan-review-gate (in this toolkit, hooks/plan-review-gate.py) — Phase 2 of the gate uses the same plan_files_lib parsing to match PR diffs to plans

What ships with it: 1 file

14.1 KB alongside SKILL.md, 1 of them executable

plan-archive.pyruns14.1 KB