Почему ваш проект разваливается после 3-го промпта? 🤡Всё очень просто - потому что у вас нет нормальной документации. Вы начинаете на энтузиазме вайбкодить, а потом получаете вот такую картину 😩
🟣 Каждый раз заново объясняете нейронке, что это вообще за проект и зачем он нужен
🟡 Контекст чата раздувается до неадекватных размеров — модель тупо теряет фокус и начинает ловить жесткие галлюцинации
🔵 Фичи конфликтуют друг с другом, потому что в проекте нет единого источника правды
🟢 AI принимает абсолютно рандомные решения вместо нормальных и обоснованных
А теперь представьте, как работают гигачады: у вас есть дока, вы кидаете короткий промпт из разряда «Реализуй фичу Х по документации» и получаете ровно то, что просили. Нейронка сама хавает весь нужный контекст из файлов, а вы экономите кучу времени и нервов 😎
Я собрал для вас два файла, которые решают эту проблему:
1️⃣ CREATE-DOCS.md
Это интерактивный промпт для Claude Code или другого хайпового вайб-кодинг инструмента (его просто нужно тогда чуть подредачить). Просто закидываете его в проект, говорите агенту следовать инструкциям из этого файла - и он сам ведёт вас через 7 этапов: от голой идеи до полностью готовой документации. Он сам задаёт вопросы, сам пишет файлы и показывает прогресс. Ваша задача - просто отвечать и подтверждать, ну чисто роль тимлида, короче вы крутой
2️⃣ ai-docs-guide.md
Это руководство, где расписано всё: структура папок, шаблоны всех типов документов (фичи, экраны, API-контракты), принципы промптинга и чеклисты. Эту штуку можно смело скармливать в качестве контекста любой LLM 🧠
Как этот сетап юзать, чтобы стать кабан-кабанычем:
🟣 Кидаете CREATE-DOCS.md и ai-docs-guide.md в папку, которая отвечает за промпты и контекст для вашего агента. В Claude Code я кидаю в docs, а в Cursor можно кинуть в папку .cursor
🟡 Открываете ваш хайповый инструмент для хайп-кодинга
🔵 Даёте ему понять: «Прочитай CREATE-DOCS.md и следуй инструкциям, также в качестве контекста держи ai-docs-guide.md. Вот мой проект: [рассказываете ему про свой проект]». Тут я рекомендую сначала включить plan mode, потом проверить его, а дальше чтобы агент писал доку.
🟢 Отвечаете на его вопросы - агент сам сгенерит всю документацию.
🟣 ПРОВЕРЯЕТЕ ВСЮ ДОКУМЕНТАЦИЮ, а после этого спокойно вайбкодите по готовым спекам, не ловя шизу от кривых генераций
Все нужные файлы оставил в комментариях 👇