This is how you keep architecture docs honest and current without them becoming fantasy fiction. It runs in three modes: backfill writes the first doc for a module that's running but never documented, update syncs existing docs to match code changes, and check catches drift between designs and reality or between multiple architecture files. The hard rule is it only documents what exists in code right now, with file:line anchors for every claim. No roadmaps, no aspirational "we'll refactor to" statements. It explicitly won't let you write six docs at once or check everything in one pass because that's how details get sloppy. Worth running after each feature lands to keep your system map from rotting into historical fiction.

skills.sh installs
1.1K
GitHub stars
1.1K
last updated
Jul 14, 2026

Install

$ npx -y skills add liuzhengdongfortest/codestable --skill cs-arch --agent claude-code

Installs into .claude/skills of the current project.

Files

This is how you keep architecture docs honest and current without them becoming fantasy fiction. It runs in three modes: backfill writes the first doc for a module that's running but never documented, update syncs existing docs to match code changes, and check catches drift between designs and reality or between multiple architecture files. The hard rule is it only documents what exists in code right now, with file:line anchors for every claim. No roadmaps, no aspirational "we'll refactor to" statements. It explicitly won't let you write six docs at once or check everything in one pass because that's how details get sloppy. Worth running after each feature lands to keep your system map from rotting into historical fiction.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/liuzhengdongfortest/codestable
First seen
May 16, 2026

More from liuzhengdongfortest/codestable

All 26

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs