development-principles
Development Principles
Section titled “Development Principles”Principles
Section titled “Principles”SSOT — No Duplicates. NEVER create duplicates serving one purpose; search, reuse, consolidate; no derived fields (code-conventions.md).
Errors Over Silent Fallbacks. NEVER use silent fallbacks (throw with a clear message; a fallback is documented, logged, surfaced).
Automate Over Manual — Git Is Truth. Repetitive work in CI/CD committing back to git; no hidden state (docs/replicate-and-automate.md).
Test Pass Gate — Zero Failures Before Done. ALL tests pass before “done”; skips justified; full suite once per PR on the merged head. Merge-tree: heavy run gated once, at the root (modules/t1k-parallel/rules/merge-first-gate-once.md).
Pre-Delete Reference Check. Before deleting or renaming: grep its name across ALL source files.
Update Skills After Every Error. Gotcha entry first, then /t1k:sync-back; twice = ship a mechanism, not prose (kit-wide-fix-discipline.md, skills/t1k-rsi/SKILL.md).
AI-Native by Default. Design every tool/hook/CLI/doc for an agent; plan as agent-executable work with an automated check (see t1k-ax). Full text: docs/development-principles.md.