ai-readable-docsWrite, convert, or validate technical documentation in a dual-audience Markdown convention (HADS) where every block is tagged as verified fact, human context, confirmed failure with fix, or unverified claim, and a reading manifest at the top tells a model what to read and skip. Use when documentatio
codebase-designShared vocabulary and method for designing deep modules — much behaviour behind a small interface, placed at a real seam, tested through that interface. Use when designing or reshaping a module's interface, deciding where a seam belongs, finding shallow pass-through code worth merging, making code e
codebase-onboardingSurvey an unfamiliar repository and produce an onboarding guide — stack, architecture shape, entry points, one traced request path, conventions, common commands — plus a starter or refreshed project CLAUDE.md. Use on first contact with a repository, when the user asks to be walked through a codebase
crafting-readmesWrite, extend, refresh, or review a README so it answers the questions its actual readers will bring, with a section set matched to the project type instead of one generic template. Use when a project has no README, a capability changed and the README went stale, a new section is needed, or the user
domain-modelingBuild and sharpen a project's domain glossary while design is happening — challenge vague or conflicting terms, probe relationships with concrete scenarios, check claims against the code, and record each resolved term in CONTEXT.md as it crystallises. Use when the conversation is defining or renamin
inherit-legacy-styleExtract the implicit conventions of a hand-written codebase into an enforceable rules file so generated code follows the project's own idioms instead of mainstream defaults. Use when onboarding an AI agent onto a legacy project, when generated code keeps drifting from house style, or when the user w
living-docs-governanceAssign a long-lived project's existing documents four non-overlapping roles — constitution, map, status, history — link them from the project CLAUDE.md, and set the update rules that keep each fact with one owner. Use when docs drift from code, when the same structure is rediscovered every session,