spec-compound-refresh

spec-compound-refresh is a command for Claude Code from ronronner02/codepilot-agent. It costs 7 tokens per session (12,159 once invoked), scanned A, original, MIT.

A command for refreshing outdated Spec-First solution documents.

In plain words
What is it for?
Use it when Spec-First documentation has become stale and needs a refresh.
Why use it?
It helps bring solution documentation back up to date when it no longer reflects the current work.

Command for Claude Code

Written for Claude Code: argument-hint in frontmatter. Also seen: mentions CLAUDE.md; mentions subagents; names the AskUserQuestion tool.

Good fit Use it when Spec-First documentation has become stale and needs a refresh.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/ronronner02/codepilot-agent/spec-compound-refresh
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.

Clone the repo
git clone --depth 1 https://github.com/ronronner02/codepilot-agent

Made for: Claude Code.

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.

agentmods badge for spec-compound-refresh

README.md
[![agentmods](https://agentmods.dev/badge/commands/ronronner02/codepilot-agent/spec-compound-refresh/github.svg)](https://agentmods.dev/commands/ronronner02/codepilot-agent/spec-compound-refresh)
Your own site
<a href="https://agentmods.dev/commands/ronronner02/codepilot-agent/spec-compound-refresh"><img src="https://agentmods.dev/badge/commands/ronronner02/codepilot-agent/spec-compound-refresh/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.

agentmods 80×15 button for spec-compound-refresh

Your own site · 80×15
<a href="https://agentmods.dev/commands/ronronner02/codepilot-agent/spec-compound-refresh"><img src="https://agentmods.dev/badge/commands/ronronner02/codepilot-agent/spec-compound-refresh.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 7 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 12,159 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00007 $0.12159
Opus 5.5 $0.00003 $0.04864
Sonnet 5.5 $0.00001 $0.02432
Haiku 4.5 $0.00001 $0.01216

Measured 1mo ago against content hash c1928dd6bf81, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

spec-compound-refresh 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 1mo ago.

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.

.claude/commands/spec-compound-refresh.md · 709 lines

How it starts

The opening of the file, as written. The whole thing — 709 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Command support root: .claude/spec-first/workflows/spec-compound-refresh. Treat it as the loaded skill directory whenever this inlined workflow refers to SKILL_DIR or the directory containing SKILL.md.

Compound Refresh

Maintain the quality of docs/solutions/ over time. This workflow reviews existing learnings against the current codebase, then refreshes any derived pattern docs that depend on them.

Workflow Contract Summary

  • 输入: docs/solutions/、CONCEPTS.md、可选 scope hint,以及当前 source/test/doc evidence。
  • 输出: Keep/Update/Consolidate/Replace/Delete/Stale 分类、已应用的知识维护变更和完整 Applied/Recommended 报告。
  • 硬出口: source truth、目标 repo、写入范围或语义分类无法确认时不得把猜测写成 current knowledge;headless 只能把歧义标 stale。
  • 权威: 当前代码与验证证据优先于旧 learning;本地 mutation、commit 和 landing 分别需要独立授权,mode:headless 只改变交互方式。
  • 消费者: 项目维护者,以及读取 docs/solutions//CONCEPTS.md 的规划、实现、调试和审查 workflow。

Mode Detection

Check whether the invocation arguments supplied by the current host contain the exact token mode:headless. If present, strip only that token (preserving the remainder, quoted paths, and token order as the scope hint) and run in headless mode.

Mode When Behavior
Interactive (default) User is present and can answer questions Ask for decisions on ambiguous cases, confirm actions
Headless mode:headless in arguments No user interaction. Apply all unambiguous actions (Keep, Update, Consolidate, auto-Delete, Replace with sufficient evidence). Mark ambiguous cases as stale. Generate a summary report at the end.

Resolve mutation and landing authority

Record three independent run-local facts before any write or Git action:

mutation_authorization: authorized | missing
commit_authorization: authorized | missing
landing_authorization: authorized | missing

A direct request to refresh or maintain docs/solutions/ authorizes only the bounded local document mutations described by this workflow. Set commit_authorization only when the current user or visible upstream handoff separately requests a commit. Set landing_authorization only when push or PR creation/update is separately explicit. mode:headless, a feature branch, writable permissions, successful edits, or a clean tree do not grant commit, branch creation, push, or PR authority. Without commit authorization, preserve verified edits as uncommitted work; without landing authorization, do not push or open a PR.

Read the full file on GitHub · 709 lines

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.

  1. 1mo ago First seen · 709 lines · 7 tokens per session scan A c1928dd6bf81

Subscribe to this mod's changes

spec-compound-refresh is a command published in the GitHub repository ronronner02/codepilot-agent (0 stars, last pushed 1mo ago), licensed MIT. It adds 7 tokens to every session and 12,159 once invoked, about $0.0000 per session on Opus 5.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-31.