Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

TENET

Ten tenets of minimal, spec-driven design. No code. No process. Just text.

  1. The specification is never the source of truth — only source code is.
  2. One up-to-date README.md will always beat dozens of obsolete specs.
  3. A code repository is not an issue-tracking system.
  4. Source code is not a place for discussions.
  5. If you cannot describe a new feature in five sentences, you will fail — no exceptions.
  6. If you cannot describe the implementation design in five sentences, you will fail — no exceptions.
  7. Fit the framework and tools to your project, not your project to the framework. You own your code.
  8. Never grant an AI agent permission to modify production infrastructure — no exceptions.
  9. Always do a code review and manual testing before merging a PR. You defined the feature, so you must validate it.
  10. An AI agent can hallucinate and fail — there is no "best model".

Deutsch

Zehn Grundsätze minimalen, spezifikationsgetriebenen Designs. Kein Code. Kein Prozess. Nur Text.

  1. Die Spezifikation ist niemals die Quelle der Wahrheit — das ist allein der Quellcode.
  2. Eine aktuelle README.md schlägt immer Dutzende veralteter Spezifikationen.
  3. Ein Code-Repository ist kein Issue-Tracking-System.
  4. Quellcode ist kein Ort für Diskussionen.
  5. Wenn du ein neues Feature nicht in fünf Sätzen beschreiben kannst, wirst du scheitern — keine Ausnahmen.
  6. Wenn du das Implementierungsdesign nicht in fünf Sätzen beschreiben kannst, wirst du scheitern — keine Ausnahmen.
  7. Passe Framework und Tools an dein Projekt an, nicht dein Projekt an das Framework. Dein Code gehört dir.
  8. Gib einem KI-Agenten niemals die Berechtigung, die Produktionsinfrastruktur zu ändern — keine Ausnahmen.
  9. Mache vor jedem PR-Merge immer ein Code-Review und manuelle Tests. Du hast das Feature definiert, also musst du es validieren.
  10. Ein KI-Agent kann halluzinieren und scheitern — es gibt kein „bestes Modell“.

Русский

Десять принципов минимального дизайна, управляемого спецификацией. Без кода. Без процессов. Только текст.

  1. Спецификация никогда не является источником истины — им является только исходный код.
  2. Один актуальный README.md всегда лучше десятков устаревших спецификаций.
  3. Репозиторий кода — это не система отслеживания задач.
  4. Код проекта — не место для дискуссий.
  5. Если вы не можете описать новую фичу в пяти предложениях — вы потерпите неудачу, без исключений.
  6. Если вы не можете описать дизайн реализации в пяти предложениях — вы потерпите неудачу, без исключений.
  7. Подстраивайте фреймворк и инструменты под свой проект, а не проект под правила фреймворка. Вы — владелец своего кода.
  8. Никогда не давайте ИИ-агенту права изменять продакшен-инфраструктуру — без исключений.
  9. Всегда проводите код-ревью и ручное тестирование перед мержем PR. Вы сформулировали фичу — вам её и проверять.
  10. ИИ-агент может галлюцинировать и ошибаться — «лучшей модели» не существует.

中文

极简规范驱动设计的十条信条。没有代码,没有流程,只有文字。

  1. 规范永远不是事实的来源——只有源代码才是。
  2. 一份保持最新的 README.md 永远胜过几十份过时的规范。
  3. 代码仓库不是问题跟踪系统。
  4. 源代码不是讨论的场所。
  5. 如果你无法用五句话描述一个新功能,你注定失败——没有例外。
  6. 如果你无法用五句话描述实现设计,你注定失败——没有例外。
  7. 让框架和工具适应你的项目,而不是让项目迁就框架。代码的主人是你。
  8. 永远不要授予 AI 代理修改生产基础设施的权限——没有例外。
  9. 在合并 PR 之前,务必进行代码评审和手动测试。功能是你定义的,就必须由你来验证。
  10. AI 代理可能产生幻觉并出错——不存在“最好的模型”。

Español

Diez principios de diseño minimalista guiado por especificaciones. Sin código. Sin procesos. Solo texto.

  1. La especificación nunca es la fuente de la verdad — solo lo es el código fuente.
  2. Un README.md actualizado siempre vencerá a docenas de especificaciones obsoletas.
  3. Un repositorio de código no es un sistema de seguimiento de incidencias.
  4. El código fuente no es un lugar para discusiones.
  5. Si no puedes describir una nueva funcionalidad en cinco frases, fracasarás — sin excepciones.
  6. Si no puedes describir el diseño de la implementación en cinco frases, fracasarás — sin excepciones.
  7. Adapta el framework y las herramientas a tu proyecto, no tu proyecto al framework. El código es tuyo.
  8. Nunca concedas a un agente de IA permisos para modificar la infraestructura de producción — sin excepciones.
  9. Haz siempre revisión de código y pruebas manuales antes de fusionar un PR. Tú definiste la funcionalidad, así que debes validarla.
  10. Un agente de IA puede alucinar y fallar — no existe el «mejor modelo».

About

Minimalistic spec driven design framework

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors