AgentStack
SKILL verified MIT Self-run

Plan Archive

skill-christophecapel-claude-mechanisms-tools-plan-archive · by christophecapel

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.

No reviews yet
0 installs
2 views
0.0% view→install

Install

$ agentstack add skill-christophecapel-claude-mechanisms-tools-plan-archive

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • Prompt-injection patterns
  • Secret / credential exfiltration
  • Dangerous shell & filesystem operations
  • Untrusted network calls
  • Known-malicious package signatures

What it can access

  • Network access No
  • Filesystem access No
  • Shell / process execution No
  • Environment & secrets No
  • Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Plan Archive? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

/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--/ 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 same plan_files_lib parsing to match PR diffs to plans

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Versions

  • v0.1.0 Imported from the upstream source.