Генератор

ТЗ, промты и правила для ИИ-агентов

Cursor · Claude Code · OpenCode · GigaCode · GitHub Copilot · Qwen Code и другие

терминал
? Инструмент > Cursor? Тип проекта > Сайт? Стек > Astro собираю файлы [####################] 100%[ok] ТЗ.md[ok] .cursor/rules/project.mdc[ok] промт.md готово>
ТЗ.md
1Цель: одностраничный сайт студии йоги, чтобы новые клиенты увидели 2расписание и цены и записались через Telegram. 3 4Что входит: 5- первый экран с названием, коротким описанием и кнопкой «Записаться»; 6- расписание занятий по дням недели; 7- цены на разовое занятие и абонементы; 8- блок «Как нас найти» с адресом и картой-картинкой; 9- кнопка записи, которая открывает Telegram-чат студии. 10 11Что не входит: 12- онлайн-оплата и личный кабинет; 13- админка для редактирования расписания; 14- блог. 15 16Технические требования: 17- Astro, статическая сборка, без бэкенда; 18- расписание и цены лежат в одном файле данных, чтобы их было просто менять; 19- адаптивная вёрстка от 360 px. 20 21Готово, когда: 22- npm run build проходит без ошибок; 23- страница нормально выглядит на телефоне и на компьютере; 24- кнопка «Записаться» открывает Telegram; 25- все тексты заполнены, пометок [ЗАПОЛНИ] не осталось. 26 27Название студии: [ЗАПОЛНИ: название] 28Ссылка на Telegram: [ЗАПОЛНИ: t.me/...] 29Адрес: [ЗАПОЛНИ: адрес]
.cursor/rules/project.mdc
1--- 2description: Правила проекта: лендинг студии йоги на Astro 3alwaysApply: true 4--- 5- Стек: Astro, статическая сборка. Бэкенд не добавляй. 6- Страница: src/pages/index.astro, блоки в src/components/. 7- Расписание и цены храни в src/data/, не в разметке. 8- Новые зависимости ставь только с объяснением, зачем они нужны. 9- Не трогай файлы, о которых тебя не просили. 10- Секреты и ключи в код не пиши. 11- Перед тем как сказать «готово», запусти npm run build. 12- В конце коротко перечисли, какие файлы изменил и зачем.
промт.md
1Прочитай ТЗ ниже и правила в .cursor/rules/project.mdc. 2Код пока не пиши. Сначала задай вопросы обо всём, что неясно 3или не хватает. Потом предложи план по шагам: какие файлы создашь 4и в каком порядке. Начнём после того, как я подтвержу план. 5 6[вставь сюда ТЗ]
Пример результата. Генератор ещё в работе.

Как это работает

ProtoSpec — русская библиотека для разработки с ИИ-агентами: шаблоны ТЗ, промты и файлы правил (AGENTS.md, CLAUDE.md, .cursor/rules) для Cursor, Claude Code и других. Чем точнее задача, тем меньше агент додумывает и тем меньше правок после него.

Промты

Все промты ->
  • Создание сайтаГотовый промт, который просит агента написать код сайта, а не текст лендинга: план, вёрстка, форма, публикация. Переменные, проверка и вариант в один шаг.sozdanie-sajta.txtСобери сайт: [тип сайта, например одностраничный сайт студии йоги].Стек: [Astro, статическая сборка, без бэкенда]. ТЗ: @[docs/spec.md].Работай по шагам и после каждого шага останавливайся:1. План. Код пока не пиши. Задай вопросы по всему, что неясно в ТЗ. Потом перечисли страницы и блоки, файлы, которые создашь, и как я проверю каждый шаг.2. Вёрстка. Блоки строго из ТЗ, по порядку. Тексты бери из ТЗ, где их нет — ставь [ЗАПОЛНИ]. Сайт должен нормально выглядеть на телефоне.3. Форма заявок через [Netlify Forms / Formspree]. Адрес формы — из переменной окружения.4. Публикация на [Vercel / Netlify / GitHub Pages]: что настроить в проекте и что сделать мне.Правила:- Не добавляй страницы, блоки и библиотеки, которых нет в ТЗ.- Не придумывай отзывы, цены и контакты.- После каждого шага запусти [npm run build], пришли вывод и список изменённых файлов.15 строк
  • Сначала планПромт, после которого агент сначала задаёт вопросы и пишет план с файлами и проверкой, а код меняет только после вашего «ок». Как включить режим плана.plan-pered-kodom.txtСначала план, код пока не пиши и файлы не меняй.Задача: [что нужно сделать].Контекст: [ТЗ, файл или папка, например @docs/spec.md].1. Изучи проект и найди, где это делается сейчас.2. Задай вопросы по всему, что неясно. Не додумывай за меня.3. Напиши план: - какие файлы изменишь или создашь и зачем; - шаги по порядку, каждый маленький; - для каждого шага — как я проверю результат (команда, страница, сценарий); - что может сломаться и что ты не будешь трогать.4. Жди моего «ок». После «ок» делай по одному шагу и останавливайся после каждого.Если по ходу работы план придётся менять — остановись и скажи, а не меняй молча.15 строк
  • Исправление ошибкиПромт, когда агент повторяет один и тот же фикс: собрать контекст, назвать разные гипотезы, проверить одну и вовремя откатить. Где взять логи.ispravlenie-oshibki.txtСтоп. Прошлые исправления не помогли, не повторяй их.Ошибка (полный текст):[вставить сообщение об ошибке или лог целиком]Как воспроизвести:[шаги: что запустить или нажать, что ожидалось, что получилось]Что уже пробовали и что вышло:[список]Последнее рабочее состояние: [коммит или «до изменения X»].1. Код пока не меняй. Прочитай файлы, которые относятся к ошибке.2. Назови три разные причины, а не три варианта одного фикса. Для каждой — как проверить её, не меняя код (лог, команда, вывод значения).3. Начни с самой вероятной. Если проверка её не подтвердила — скажи и переходи к следующей.4. Когда причина подтверждена, исправь минимально: только нужные файлы, без новых библиотек и рефакторинга.5. Покажи, как я проверю, что ошибка ушла и ничего рядом не сломалось.20 строк