Designs deep modules with small interfaces placed at clean, testable seams.
npx skills add https://github.com/filippolmt/skills --skill codebase-design-filippolmt
Please help me install this Agent Skill. Skill: codebase-design Source: https://github.com/filippolmt/skills/tree/main/skills/codebase-design Command: npx skills add https://github.com/filippolmt/skills --skill codebase-design-filippolmt
High-intent search queries and answers about installing and using this skill.
Start by minimizing the number of methods and simplifying parameters while hiding more complexity inside the implementation. A deep module gives callers high leverage: lots of behavior behind a small interface that also serves as the test surface.
A seam is the location where a module's interface lives and where behavior can be altered without editing in place. 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. A single-adapter seam is just indirection; one adapter means a hypothetical seam, two means a real one.
Write tests at the deepened module's interface and delete old unit tests on the shallow modules it absorbed. Use local stand-ins like PGLite or in-memory adapters for substitutable dependencies, and mocks only for true external services.
Avoid deepening when the module is a genuine pass-through that fails the deletion test, or when merging would force a seam with only one adapter. Also avoid exposing internal seams through the public interface just because tests use them.
janpeterdLocate shallow modules and propose deepened interfaces for codebase architecture.
kashman001Designs deep modules with small interfaces, clean seams, and testable adapters.
haryelramalhoDesign deep modules with small interfaces and clean seams for complex codebases.
StepowskiEricMap software architecture to business-domain concepts with bounded contexts and context maps.
