minimal-modular-code
Minimal Modular Code
Keep code minimal and right-sized for AI coding agents — anti-slop in the small, modular
boundaries in the large. Provenance lives in skill.json; this file is runtime routing only.
Produces: a change-plan.md (DO), an audit-report.md plus a findings-ledger +
workflow-state when tracked (REVIEW), or a design-doc.md / refactor-runbook.md /
explanation.md (DESIGN).
Core principle
Invest in interfaces, not implementations; enforce with gates, not prose; delete scaffolding as models improve. The scarce resource is accountable review, not code generation — so the bar for any line, abstraction, or boundary is whether it earns the attention it will cost. Minimal is not fewest lines or smallest units; it is nothing left to take away — powerful behavior behind a simple interface, reused before rebuilt, legible to a reader with a finite context window.