Ten tenets of minimal, spec-driven design. No code. No process. Just text.
- The specification is never the source of truth — only source code is.
- One up-to-date README.md will always beat dozens of obsolete specs.
- A code repository is not an issue-tracking system.
- Source code is not a place for discussions.
- If you cannot describe a new feature in five sentences, you will fail — no exceptions.
- If you cannot describe the implementation design in five sentences, you will fail — no exceptions.
- Fit the framework and tools to your project, not your project to the framework. You own your code.
- Never grant an AI agent permission to modify production infrastructure — no exceptions.
- Always do a code review and manual testing before merging a PR. You defined the feature, so you must validate it.
- An AI agent can hallucinate and fail — there is no "best model".
Zehn Grundsätze minimalen, spezifikationsgetriebenen Designs. Kein Code. Kein Prozess. Nur Text.
- Die Spezifikation ist niemals die Quelle der Wahrheit — das ist allein der Quellcode.
- Eine aktuelle README.md schlägt immer Dutzende veralteter Spezifikationen.
- Ein Code-Repository ist kein Issue-Tracking-System.
- Quellcode ist kein Ort für Diskussionen.
- Wenn du ein neues Feature nicht in fünf Sätzen beschreiben kannst, wirst du scheitern — keine Ausnahmen.
- Wenn du das Implementierungsdesign nicht in fünf Sätzen beschreiben kannst, wirst du scheitern — keine Ausnahmen.
- Passe Framework und Tools an dein Projekt an, nicht dein Projekt an das Framework. Dein Code gehört dir.
- Gib einem KI-Agenten niemals die Berechtigung, die Produktionsinfrastruktur zu ändern — keine Ausnahmen.
- Mache vor jedem PR-Merge immer ein Code-Review und manuelle Tests. Du hast das Feature definiert, also musst du es validieren.
- Ein KI-Agent kann halluzinieren und scheitern — es gibt kein „bestes Modell“.
Десять принципов минимального дизайна, управляемого спецификацией. Без кода. Без процессов. Только текст.
- Спецификация никогда не является источником истины — им является только исходный код.
- Один актуальный README.md всегда лучше десятков устаревших спецификаций.
- Репозиторий кода — это не система отслеживания задач.
- Код проекта — не место для дискуссий.
- Если вы не можете описать новую фичу в пяти предложениях — вы потерпите неудачу, без исключений.
- Если вы не можете описать дизайн реализации в пяти предложениях — вы потерпите неудачу, без исключений.
- Подстраивайте фреймворк и инструменты под свой проект, а не проект под правила фреймворка. Вы — владелец своего кода.
- Никогда не давайте ИИ-агенту права изменять продакшен-инфраструктуру — без исключений.
- Всегда проводите код-ревью и ручное тестирование перед мержем PR. Вы сформулировали фичу — вам её и проверять.
- ИИ-агент может галлюцинировать и ошибаться — «лучшей модели» не существует.
极简规范驱动设计的十条信条。没有代码,没有流程,只有文字。
- 规范永远不是事实的来源——只有源代码才是。
- 一份保持最新的 README.md 永远胜过几十份过时的规范。
- 代码仓库不是问题跟踪系统。
- 源代码不是讨论的场所。
- 如果你无法用五句话描述一个新功能,你注定失败——没有例外。
- 如果你无法用五句话描述实现设计,你注定失败——没有例外。
- 让框架和工具适应你的项目,而不是让项目迁就框架。代码的主人是你。
- 永远不要授予 AI 代理修改生产基础设施的权限——没有例外。
- 在合并 PR 之前,务必进行代码评审和手动测试。功能是你定义的,就必须由你来验证。
- AI 代理可能产生幻觉并出错——不存在“最好的模型”。
Diez principios de diseño minimalista guiado por especificaciones. Sin código. Sin procesos. Solo texto.
- La especificación nunca es la fuente de la verdad — solo lo es el código fuente.
- Un README.md actualizado siempre vencerá a docenas de especificaciones obsoletas.
- Un repositorio de código no es un sistema de seguimiento de incidencias.
- El código fuente no es un lugar para discusiones.
- Si no puedes describir una nueva funcionalidad en cinco frases, fracasarás — sin excepciones.
- Si no puedes describir el diseño de la implementación en cinco frases, fracasarás — sin excepciones.
- Adapta el framework y las herramientas a tu proyecto, no tu proyecto al framework. El código es tuyo.
- Nunca concedas a un agente de IA permisos para modificar la infraestructura de producción — sin excepciones.
- Haz siempre revisión de código y pruebas manuales antes de fusionar un PR. Tú definiste la funcionalidad, así que debes validarla.
- Un agente de IA puede alucinar y fallar — no existe el «mejor modelo».