Codebase Design

by rengwu

Codebase Design is a Quality skill for Claude Code, published by rengwu in wayfinder-maps.

95 stars1 forkson rengwu/wayfinder-mapsAdded 2026/07/16+2% in starsRepository updated 2026/07/14

View source on GitHub Download repo ZIP

agent-skillsgo

Install in seconds

Install Codebase Design

Copy Codebase Design into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/rengwu/wayfinder-maps/tree/main/skills/.optional/codebase-design ~/.claude/skills/codebase-design

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/rengwu/wayfinder-maps.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/.optional/codebase-design/SKILL.md in rengwu/wayfinder-maps
Installs to: ~/.claude/skills/codebase-design
Collection: One of 14 skills cataloged from this repository
Category: Quality — 1897 skills

What Codebase Design does

Provides a shared vocabulary and principles for designing deep modules with small interfaces and high leverage. Use when structuring code for testability, maintainability, and AI-navigability.

Codebase Design is cataloged under Quality on DirSkills. Codebase Design comes from a repository tagged agent-skills and go.

Documentation

README

Excerpt

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.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Codebase Design

What else does rengwu publish alongside Codebase Design?
Codebase Design is one of 14 skills that DirSkills catalogs from rengwu/wayfinder-maps, the repository it ships in. Its siblings there include Domain Modeling, Grill Me and Grill with Docs. Each one is a separate skill with its own page in this directory, installs the same way Codebase Design does, and is maintained by rengwu in that same repository. The rest of the collection is listed on the rengwu/wayfinder-maps page.
How does Codebase Design compare to other Quality skills?
Codebase Design ranks #1830 by stars among the 1897 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Codebase Design against them. Open each page to compare what they document and how they install.