Designs deep modules with small interfaces placed at clean, testable seams.
npx skills add https://github.com/yamcodes/the-hat --skill codebase-design-yamcodes
Please help me install this Agent Skill. Skill: codebase-design Source: https://github.com/yamcodes/the-hat/tree/main/skills/codebase-design Command: npx skills add https://github.com/yamcodes/the-hat --skill codebase-design-yamcodes
High-intent search queries and answers about installing and using this skill.
A deep module puts a large amount of behavior behind a small interface. Reduce the number of methods, simplify parameters, and hide complexity inside the implementation so callers get more leverage per unit of interface they must learn.
An interface is everything a caller must know to use a module, including invariants, ordering, and error modes. A seam is the location where that interface lives, a place where behavior can be altered without editing in that place.
Introduce a port only when at least two adapters are justified, typically production plus test. One adapter means a hypothetical seam and is just indirection; two adapters mean a real seam where something actually varies.
Accept dependencies as parameters instead of constructing them, return results instead of producing side effects, and keep the surface area small. Tests should assert observable outcomes through the interface and survive internal refactors.
No. Once tests exist at the deepened module's interface, old unit tests on the shallow modules become waste and should be deleted. The interface is the test surface, so replace tests rather than layering new ones on top.
GregM1991Designs deep modules with small interfaces, clean seams, and testable adapters.
kashman001Designs deep modules with small interfaces, clean seams, and testable adapters.
Arete-ConsortiumScores candidates against a weighted rubric and produces an evidence-cited decision verdict.
efekrbasDesign deep module interfaces with clean seams for codebase restructuring.
