Designs deep modules with small interfaces placed at clean seams.
npx skills add https://github.com/Chau165/local_skill --skill codebase-design-chau165
Please help me install this Agent Skill. Skill: codebase-design Source: https://github.com/Chau165/local_skill/tree/main/codex/skills/codebase-design Command: npx skills add https://github.com/Chau165/local_skill --skill codebase-design-chau165
High-intent search queries and answers about installing and using this skill.
A deep module hides a large implementation behind a small interface. Reduce the number of methods, simplify parameters, and hide complexity inside. Accept dependencies as parameters and return results rather than producing side effects so the interface stays testable.
A seam is the location where a module's interface lives, a place where behavior can change without editing that spot. The interface is everything a caller must know to use the module, including invariants, ordering, and error modes.
Introduce a port only when at least two adapters are justified, typically a production adapter and a test adapter. One adapter means a hypothetical seam, which is just indirection without payoff.
Write tests at the deepened module's interface, asserting observable outcomes rather than internal state. Delete old unit tests on the shallow modules once interface-level tests exist, since tests should survive internal refactors.
Depth measured as implementation-lines to interface-lines rewards padding, so this Skill uses depth-as-leverage instead. Over-merging can also hide legitimate variation, so seams should only exist where behavior actually varies across adapters.
vtgiang-dotcomAnalyze module boundaries and output ranked refactor candidates.
kashman001Designs deep modules with small interfaces, clean seams, and testable adapters.
Ramprasad4121Prepare codebases for security review with static analysis and documentation.
SlevoDevDecompose monolithic claude-flow v3 orchestrators into bounded contexts.
