codebase-design is agent-read markdown (skill) from asymmetric-al/core: Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Codebase Design
Design **deep modules**: a lot of behaviour behind a small interface, placed at a clean seam, testable through that interface. Use this language and these principles wherever code is being designed or restructured. The aim is leverage for callers, locality for maintainers, and testability for everyone.
## Glossary
Use these terms exactly — don't substitute "component," "service," "API," or "boundary." Consistent language is the whole point.
**Module** — anything with an interface and an implementation. Deliberately scale-agnostic: a function, class, package, or tier-spanning slice. _Avoid_: unit, component, service.
**Interface** — everything a caller must know to use the module correctly: the type signature, but also invariants, ordering constraints, error modes, required configuration, and performance characteristics. _Avoid_: API, signature (too narrow — they refer only to the type-level surface).
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_4nvix6tpy3xqrwhs
GET https://markdownregistry.com/api/v1/resolve?ref=asymmetric-al/core/codebase-design
GET https://markdownregistry.com/api/v1/blob/ab24353b4db20400b6d2ffe752a93770ec53adde072edc6cf0bb65caf4c5c427
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
asymmetric-al/core · .agents/skills/accessibility-review/SKILL.md · Audit and fix accessibility in Core UI. Use when changing or reviewing buttons, links, forms, validation, dialogs…
asymmetric-al/core · .agents/skills/agent-browser/SKILL.md · Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages…
asymmetric-al/core · .agents/skills/agent-email-inbox/SKILL.md · Use when building any system where email content triggers actions — AI agent inboxes, automated support handlers…
asymmetric-al/core · .agents/skills/anim/SKILL.md · Tasteful, subtle web UI animation following Emil Kowalski / animations.dev principles. Use when adding or reviewing…
asymmetric-al/core · .agents/skills/animation-vocabulary/SKILL.md · Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the…
asymmetric-al/core · .agents/skills/api-design-principles/SKILL.md · Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight…
asymmetric-al/core · .agents/skills/apple-design/SKILL.md · Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing…
asymmetric-al/core · .agents/skills/babysit/SKILL.md · Orchestrate via @babysitter. Use this skill when asked to babysit a run, orchestrate a process or whenever it is called…
asymmetric-al/core · .agents/skills/base-ui/SKILL.md · Build accessible, composable UI with @base-ui/react primitives and project styling tokens. Use when creating or…
asymmetric-al/core · .agents/skills/bats-testing-patterns/SKILL.md · Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell…
librechat-ai/librechat · .claude/skills/codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
danny-avila/librechat · .claude/skills/codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
mxyhi/ok-skills · codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
dcouple/pane · main/src/services/paneChatBundle/skills/codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
akillness/jeo-skills · .agent-skills/codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
eltmon/overdeck · sync-sources/skills/codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
vodailocz/kilo-kit-mcp · skills/engineering/codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
