What is project-plan-archive?

A tool for archiving completed dated plan files from the root of .agents/plans/. It checks the project’s issue tracker first, previews proposed moves, and can repair references to the old file paths.

Use it to inspect eligible plan files, match them with completed issue keys, produce a dry-run archive report, and—when explicitly enabled—move completed plans into the archive and update old links.

It prevents plans from being archived before their tracked work is actually complete. The preview mode lets you review changes before files are moved or references are rewritten.

project-plan-archive — Skill for Codex by SisyphusSQ

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add SisyphusSQ/harness-template --skill project-plan-archive

Clone the repo

git clone --depth 1 https://github.com/SisyphusSQ/harness-template

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/sisyphussq/harness-template/project-plan-archive/github.svg)](https://agentmods.dev/skills/sisyphussq/harness-template/project-plan-archive)

Your own site

<a href="https://agentmods.dev/skills/sisyphussq/harness-template/project-plan-archive"><img src="https://agentmods.dev/badge/skills/sisyphussq/harness-template/project-plan-archive/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/sisyphussq/harness-template/project-plan-archive"><img src="https://agentmods.dev/badge/skills/sisyphussq/harness-template/project-plan-archive.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 692 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00049	$0.00692
Opus 5	$0.00024	$0.00346
Sonnet 5	$0.00010	$0.00138
Haiku 4.5	$0.00005	$0.00069

Measured 11d ago against content hash d1f9491837e9, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

project-plan-archive scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/project_plan_archive.py, tests/test_project_plan_archive.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

template/.agents/skills/project-plan-archive/SKILL.md · 64 lines

What it actually says

Project Plan Archive

用于项目内 .agents/plans/ 计划文件的归档与旧路径修复。

核心规则：先查 Issue provider，再归档；默认只做 dry-run，只有显式 --write 才允许移动文件和改写引用。

第一步

先读取根级 AGENTS.md 和 .agents/PLANS.md；
确认当前 issue_provider 和需要查证的 issue key；
先做只读检查：

python3 .agents/skills/project-plan-archive/scripts/project_plan_archive.py inspect \
  --repo "$PWD" --json

固定执行链

先运行 inspect，只看 .agents/plans/*.md 根级日期计划文件；
从每个候选计划按顺序提取 execution_issue、master_issue；
agent 按当前 issue provider 查证 issue 完成态；脚本不直接连接外部系统；
把已完成 issue 列表传给 archive 做 dry-run；只有确认后才加 --write；
写入后运行项目要求的文档或测试检查。

快速命令

python3 .agents/skills/project-plan-archive/scripts/project_plan_archive.py inspect \
  --repo "$PWD" --json

python3 .agents/skills/project-plan-archive/scripts/project_plan_archive.py archive \
  --repo "$PWD" \
  --done-issue ISSUE-123 \
  --json

python3 .agents/skills/project-plan-archive/scripts/project_plan_archive.py archive \
  --repo "$PWD" \
  --done-issue ISSUE-123 \
  --write --json

归档规则

项目	固定规则
候选范围	只看 `.agents/plans/` 根目录下带 `YYYY-MM-DD-` 前缀的 `.md` 文件
永不移动	`TEMPLATE.md`、`EXAMPLE-implementation.md`、已经在 `completed/` 下的文件
目标路径	`.agents/plans/completed/<ISO周>/<原文件名>`
引用修复	只做旧计划路径到新路径的精确字符串替换
扫描面	所有 git-tracked 文本文件，以及存在时的 `.agents/runs/*/.md`、`.agents/state/*/.md`
禁止行为	不做标题模糊修复，不碰二进制、日志、构建产物，不直接查询或修改 Issue provider

红线

Issue provider 不可用且存在带 issue 的候选计划时，不允许直接执行 --write；
不允许把未完成 issue 对应的计划移动到 completed/；
不允许顺手归档模板、示例、日志、二进制或其它非计划文件。

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

11d ago First seen · 64 lines · 49 tokens per session scan A d1f9491837e9

Subscribe to this mod's changes

project-plan-archive is a skill published in the GitHub repository SisyphusSQ/harness-template (11 stars, last pushed 19d ago), licensed MIT. It adds 49 tokens to every session and 692 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Planning Project management

recipe-create-meet-space

Create a Google Meet meeting space and share the join link.

googleworkspace/cli · 18 tokens

workthreads

SpecStory Workthreads - a weekly work-thread rollup across a team's repos from SpecStory coding histories (any agent - Claude Code, Codex, Cursor, Gemini, and more). It groups the window's sessions into threads of work per project and labels each new / open / recently closed, so a lead sees what shipped, what is still…

specstoryai/getspecstory · 126 tokens

atmos-config

Atmos root configuration: atmos.yaml discovery, precedence, deep merging, basepath, imports, minimal bootstrap, and routing to narrower Atmos skills.

cloudposse/atmos · 31 tokens

story-readiness

Validate that a story file is implementation-ready. Checks for embedded GDD requirements, ADR references, engine notes, clear acceptance criteria, and no open design questions. Produces READY / NEEDS WORK / BLOCKED verdict with specific gaps. Use when user says 'is this story ready', 'can I start on this story', 'is…

Donchitos/Claude-Code-Game-Studios · 77 tokens

autotask-creator

Rules for automation CRUD from the group-chat commander. The commander does not call mutation tools and does not edit cloud/autotasks files directly. It emits one or more top-level ... containers in its final text; the bus parses and applies them after the turn.

Orkas-AI/Orkas · 5 tokens

remove

Remove a deployed framework or addon from the current workspace.

jmagly/aiwg · 12 tokens