Design deep modules with small interfaces, clean seams, and testable adapters.
npx skills add https://github.com/Yassimba/loom --skill codebase-design-yassimba
Please help me install this Agent Skill. Skill: codebase-design Source: https://github.com/Yassimba/loom/tree/main/skills/codebase-design Command: npx skills add https://github.com/Yassimba/loom --skill codebase-design-yassimba
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 rather than creating them, and return results instead of producing side effects.
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 place.
Introduce a port only when at least two adapters are justified, typically a production adapter and an in-memory test adapter. A single-adapter seam is just indirection and should be avoided.
Write tests at the deepened module's interface, treating the interface as the test surface. Delete old unit tests on the shallow modules, and assert on observable outcomes so tests survive internal refactors.
Treat true external services like Stripe or Twilio as injected ports, with tests providing mock adapters. For remote services you own, define a port with an HTTP adapter for production and an in-memory adapter for tests.
vtgiang-dotcomAnalyze module boundaries and output ranked refactor candidates.
kashman001Designs deep modules with small interfaces, clean seams, and testable adapters.
haryelramalhoDesign deep modules with small interfaces and clean seams for complex codebases.
AlteriomConvert PRDs into DDD models with bounded contexts, aggregates, and domain events.
