Кодекс · 8 фаз · стартовый шаблон
Правила разработки с AI-агентами
Старт — это не «сделай классный SaaS». Это шаблон, идея в inputs/idea.md и движение по 8 фазам. Работает в OpenCode, Cursor и Reasonix.
С чего начинается проект
Старт — это не «сделай классный SaaS»
❌ Так не надо
Написать агенту «сделай классный SaaS-проект» и ждать. Агент угадывает, выдумывает, прыгает и теряет контекст — получается бардак.
✅ Так надо
Скачать шаблон → положить идею в inputs/idea.md → идти по 8 фазам. Шаблон даёт закон, команды и заготовки документов.
7 правил, которые агент обязан соблюдать
Кодекс AI-агента
Сначала читай AGENTS.md
Правила проекта важнее общих привычек модели.
Одна линия истории в git
Работай в main, не оставляй ветки разъехавшимися.
Инкременты
Один шаг = код + проверка + коммит. Никаких «сделаю всё сразу».
Не выдумывай
Нет данных → спроси или оставь [уточнить: …].
Scratch вне репозитория
Пробы и сгенерированный мусор не коммитим.
Не разрушай данные
Без force-reset БД, без удаления прода.
Проверяй сам себя
После каждого шага — тест/билд, перед финалом — дифф.
От идеи до деплоя
Восемь фаз разработки
Идея
inputs/idea.md · готово, когда: Идея записана своими словами
Бриф/brief
outputs/brief.md · готово, когда: 5 категорий раскрыты в диалоге
Ресёрч/research
outputs/research.md · готово, когда: 5–7 реальных конкурентов, синтез
PRD/prd
outputs/prd.md · готово, когда: Одна страница, скоп MVP с MoSCoW
Дизайн/design
outputs/ui-kit.md · готово, когда: Палитра, типографика, сетка, состояния
Окружение/setup
git, стек, .env.example, README · готово, когда: Проект запускается с нуля
План/plan
outputs/plan.md · готово, когда: Шаги с критериями приёмки
Разработка/build
код инкрементами · готово, когда: Каждый шаг закрыт коммитом
Ревью и деплой/review
outputs/review.md + публикация · готово, когда: Чек-лист приёмки зелёный
Фаза 4 — визуальный язык до кода
Дизайн: скиллы Anthropic + Emil Kowalski
После PRD агент не бросается писать код. Сначала он читает четыре скилла и собирает UI-кит — палитру, типографику, сетку и состояния.
Anthropic
Правила продакшн-интерфейсов: типографика ≤2 семейств, цвет 60-30-10, сетка 4/8px, состояния и запреты «AI-скуфа».
Anthropic
Вкус: собрать референсы, сделать 2–3 варианта, сравнить по характеру, иерархии и ритму, обосновать без слова «красиво».
Anthropic
Безупречная полировка: выравнивание, контраст, пустые состояния, микрокопия, переходы 150–250 мс.
Adding Product Design
Emil Kowalski
Продакт-дизайн для инженеров: дизайн как система, качество = сумма деталей, меньше но лучше.
Как строить проект с нуля
Правила окружения
git init, ветка main, .gitignore (node_modules, .env, .next, dist, логи).
Стек по типу проекта: SaaS/веб → Next.js + TS; лендинг → Vite/Next.js; Telegram-бот → Node.js + grammY.
Секреты: .env.example в git, реальный .env — никогда.
Всё проверяемое — командой: npm run build, npm test, lint.
README: как запустить, собрать и проверить — до начала разработки.
Что внутри до скачивания
Стартовый шаблон: анатомия
Каждый файл отвечает на три вопроса: что это → зачем → когда трогать. Не качайте zip «вслепую» — вот вся структура:
ai-project-starter/├── README.md ← как начать за 3 шага (твой вход)├── AGENTS.md ← кодекс: что агенту можно и нельзя├── inputs/idea.md ← сюда кладёшь свою идею├── commands/ ← 8 команд-фаз, агент запускает по очереди│ ├── 00-brief.md ← агент допрашивает: ЦА, боль, монетизация│ ├── 01-research.md ← агент идёт в веб, изучает конкурентов│ ├── 02-prd.md ← агент собирает одностраничный PRD│ ├── 03-design.md ← агент задаёт визуальный язык по дизайн-скиллам│ ├── 04-setup.md ← окружение: git, стек, .env, README│ ├── 05-plan.md ← PRD → план работ│ ├── 06-build.md ← код инкрементами (шаг → проверка → коммит)│ └── 07-review.md ← самопроверка диффа и сдача проекта├── skills/ ← дизайн-скиллы: Anthropic + Emil Kowalski├── templates/ ← заготовки: бриф, PRD, план├── outputs/ ← результаты каждой фазы├── adapters/ ← команды в формате твоей среды│ ├── opencode/ ← OpenCode: .opencode/commands/│ ├── cursor/ ← Cursor: .cursor/rules/│ └── reasonix/ ← Reasonix: .reasonix/skills/└── docs/rules.md ← полный текст правил в markdown
Как запустить в своей среде
Распакуй архив, открой папку в OpenCode, введи /brief.
Распакуй, скопируй adapters/cursor/.cursor в корень проекта, попроси агента прочитать правило 00-brief.
Распакуй, скопируй adapters/reasonix/.reasonix в корень, вызови skill brief.
Как понять, что проект готов
Чек-лист приёмки
- Проект запускается с нуля: clone → установка → npm run dev.
- npm run build проходит без ошибок.
- В диффе нет мусора, секретов и node_modules.
- Каждый шаг плана закрыт коммитом с понятным сообщением.
- README описывает запуск, сборку и проверку.
- Интерфейс соответствует UI-киту (не «примерно похоже»).