ТЗ, промты и правила для ИИ-агентов
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 и других. Чем точнее задача, тем меньше агент додумывает и тем меньше правок после него.
- 01ТЗСформулировать задачу
ТЗ.mdЦель: одностраничный сайт студии йоги… - 02ПравилаЗафиксировать контекст
project.mdcalwaysApply: true - 03ПромтДать инструкции агенту
промт.mdПрочитай ТЗ ниже и правила… - 04ПроверкаПросмотреть результат
Готово, когда[x] npm run build проходит без ошибок
Ваш агент и его правила
Все форматы ->Cursor
.cursor/rules/project.mdcClaude Code
CodexCLAUDE.mdAGENTS.mdOpenCodeAGENTS.mdGitHub Copilot
.github/copilot-instructions.mdGemini CLI
GEMINI.mdQwen Code
QWEN.mdGigaCode
GIGACODE.mdЗадачи
- СайтСайт с помощью нейросети по шагам: ТЗ, правила для агента, промты, форма заявок и публикация. Пример ТЗ на сайт и чек-лист, если что-то не работает.
ТЗ.md · примерЦель: одностраничный сайт студии йоги…ТЗправилапромптыпроверка - Telegram-ботКак создать Telegram-бота с помощью нейросети в Cursor или Claude Code: ТЗ, промты, AGENTS.md для aiogram 3, токен в .env, polling, запуск и «бот молчит».
AGENTS.mdТокен только в .env, переменная BOT_TOKEN. ID чата администратора — ADMIN_CHAT_ID.Telegramaiogram 3AGENTS.md
Промты
- Создание сайтаГотовый промт, который просит агента написать код сайта, а не текст лендинга: план, вёрстка, форма, публикация. Переменные, проверка и вариант в один шаг.
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 строк
Статьи
blog/kak-napisat-prompt-dlya-cursor.mdКак писать промпты для Cursor: структура, где писать и готовые шаблоныКак написать промпт для Cursor: из чего состоит промт, когда брать Agent, Ask или Plan, как давать контекст через @, плюс готовые шаблоны и чек-лист.blog/kak-proverit-kod-ot-nejroseti.mdКак проверить код от нейросети: чек-лист перед тем, как принять правкуКак проверить код, который написала нейросеть: запуск, тесты, дифф, зависимости, секреты и безопасность. Чек-лист и промты для агента.blog/vajbkoding-chto-eto.mdВайбкодинг: что это такое простыми словами и где он заканчиваетсяЧто такое вайбкодинг простыми словами: откуда термин, чем он отличается от разработки с ИИ, где он уместен, а где опасен, и с чего начать.