Borrowing it
Nothing to install: this file belongs to cluesmith/codev. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/cluesmith/codev/main/.claude/skills/update-arch-docs/SKILL.mdgit clone --depth 1 https://github.com/cluesmith/codevWrote 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.
[](https://agentmods.dev/skills/cluesmith/codev/update-arch-docs)<a href="https://agentmods.dev/skills/cluesmith/codev/update-arch-docs"><img src="https://agentmods.dev/badge/skills/cluesmith/codev/update-arch-docs/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.
<a href="https://agentmods.dev/skills/cluesmith/codev/update-arch-docs"><img src="https://agentmods.dev/badge/skills/cluesmith/codev/update-arch-docs.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.00237 | $0.04248 |
| Opus 5.5 | $0.00095 | $0.01699 |
| Sonnet 5.5 | $0.00047 | $0.00850 |
| Haiku 4.5 | $0.00024 | $0.00425 |
Grade B, and why
update-arch-docs scanned grade B with 1 finding 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 15d 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.
Recursive force deletemediumDestructive command
rm -rf with a variable or a broad path is one typo away from removing the wrong tree.
- **Destructive shell commands**. The skill must not invoke `rm -rf`, `git rm`, or destructive `sed` scripts. All edits go through the normal Edit tool. The MAINTAIN PR diff is the human-confirmation step; that's enough. Downgraded: this mod is about security review, or the phrase is quoted, so it is likely naming the pattern rather than instructing it.
How it starts
The opening of the file, as written. The whole thing — 159 lines — stays where its author put it; the contents beside it link to each section on GitHub.
update-arch-docs
This skill maintains the project's governance docs, each split into two tiers (Spec 987):
- COLD reference archives —
codev/resources/arch.md(architecture) andcodev/resources/lessons-learned.md(durable wisdom). Full, on-demand; grepped/read for depth. - HOT always-on companions —
codev/resources/arch-critical.mdandcodev/resources/lessons-critical.md. Tiny, hard-capped, always injected into every porch prompt and into CLAUDE.md/AGENTS.md. Each holds capped facts/lessons plus a bounded "consult when…" map of its cold doc's top-level topics.
It is invoked by the MAINTAIN protocol's documentation step, and ad-hoc whenever someone updates, audits, or prunes any of these files. The skill is opinionated about what does not belong in each tier and polices the hot-tier cap, displacement, and map accuracy. Use it whenever a doc change touches any of the four files.
What this skill does NOT do
These are the patterns that have, in practice, caused arch.md and lessons-learned.md to grow without bound. Treat them as bright-line rejections in every mode (diff, audit, and bootstrap).
In arch.md
- Per-file enumerations that go stale the moment they're written. Document the shape of a directory and the handful of load-bearing files; do not list every file.
git ls-filesis authoritative; the doc is for orientation. - Per-spec changelog sections ("Spec 0042 added X, Spec 0073 changed Y"). Architecture is current state, not history. The git log + the spec/review documents own the changelog framing.
- Specs/plans tables that mirror the contents of
codev/specs/andcodev/plans/. These are duplicative and rot quickly. Link to the directory; do not paginate it into the doc. - Aspirational state ("we plan to…", "in the next phase we'll…"). That belongs in the relevant meta-spec or roadmap doc, not in the architecture body. arch.md describes what is, not what might be.
- Date-stamped narrative ("As of 2026-Q2, the system uses…"). Dates make the doc look fresh while making it harder to maintain. Use git log + commit dates for temporal context.
- Duplication of meta-spec content. If a subsystem has its own meta-spec under
codev/architecture/<domain>.mdor undercodev/specs/, arch.md should carry a 1-paragraph summary plus a pointer — not a copy. - Retired-component graveyards. When a component is removed, delete its section.
git logretains history; an arch.md that describes things that no longer exist is misleading.
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.
- 15d ago Changed · +26 lines · +25 tokens per session 6342097b2c7f
- 2mo ago First seen · 133 lines · 212 tokens per session scan B 88b726a39f94
update-arch-docs is a skill published in the GitHub repository cluesmith/codev (297 stars, last pushed 2d ago), licensed Apache-2.0. It adds 237 tokens to every session and 4,248 once invoked, about $0.0009 per session on Opus 5.5. A static security scan graded it B with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
update-arch-docs compared with skills from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| update-arch-docscluesmith/codev | Skill | 297 | 2d ago | Apache-2.0 | B | 237 | Claude Code |
| hns-lsel-curatormodu-ai/moai-adk | Skill | 1.3k | 3d ago | Apache-2.0 | A | 135 | Claude Code |
| moai-workflow-worktreemodu-ai/moai-adk | Skill | 1.3k | 3d ago | Apache-2.0 | A | 41 | Claude Code |
| moai-lane-watchdogmodu-ai/moai-adk | Skill | 1.3k | 3d ago | Apache-2.0 | A | 86 | Claude Code |
| hns-workflow-ci-loopmodu-ai/moai-adk | Skill | 1.3k | 3d ago | Apache-2.0 | A | 76 | Claude Code |
| hns-moaiadk-patternsmodu-ai/moai-adk | Skill | 1.3k | 3d ago | Apache-2.0 | A | 116 | Claude Code |
| moai-harness-learnermodu-ai/moai-adk | Skill | 1.3k | 3d ago | Apache-2.0 | A | 61 | Claude Code |