feat(doctrine): YAGNI decision ladder + shortcut marker in § Code style

Case 1 of the 6-repo review (ponytail, chisle): both rejected as plugins, the ordered ladder borrowed as 6 doctrine lines. 287 -> 293, budget 320.
2026-09-27 15:06:20 +02:00
parent 642fea826e
commit 9315c6cb39
1 changed files with 6 additions and 0 deletions
@@ -9,6 +9,12 @@ Apply unless repo-specific instructions override.
 - One responsibility per function/method.
 - Preserve existing behavior unless asked.
 - Scope changes to task — no unrelated edits.
 - Before writing code, stop at the first rung that applies: not needed
  (YAGNI) → reuse what the codebase has → stdlib → platform/runtime
  feature → dependency already installed → one line → the minimum that
  works. Runs after understanding the problem, never instead of it.
 - Assumed shortcut → `shortcut:` comment at the site (limit + upgrade
  path), harvested into TODO.md so "later" stays findable.
 ## Limits (adapt to language)
 - Max 25 logic lines/function (executable statements; comments and