diff --git a/rules/common/coding-style.md b/rules/common/coding-style.md index fd6345a87..dd947d89e 100644 --- a/rules/common/coding-style.md +++ b/rules/common/coding-style.md @@ -31,9 +31,11 @@ Rationale: Immutable data prevents hidden side effects, makes debugging easier, - Do not build features or abstractions before they are needed - Avoid speculative generality - Start simple, then refactor when the pressure is real -- No abstraction before the second caller: no interface with a single - implementation, no factory for one product, no config option for a value - that never varies +- No speculative abstraction before the second caller: no interface extracted + from a single implementation, no factory for one product, no config option + for a value that never varies. A deliberate boundary is not speculative: a + repository interface that isolates business logic from storage (see + `patterns.md`) earns its place at the first implementation ## File Organization