Бывало ли такое, что вы ведете долгий проект вместе с агентом, ставите задачи ИИшке, а она только и делает, что топчется на месте, создавая выдуманные переменные и плодя кучу дубляжей файлов с приставками _fix, _final, _corrected?

На самом деле, таким болеют модели и на начальных стадиях, просто баги и мелочи проще отследить, но когда проект переходит за 10к+ строк, ситуация меняется, и хочется иметь агента, способного быть в теме, на какой стадии проект и как грамотно фиксить код.

Сегодня я поделюсь своим личным опытом, который я заработал, благодаря многочасовым перепискам с Claude Code, но которые ни к чему не привели, пока я системно не подошел к этому вопросу.

№1.1 CURRENT_STAGE.MD — Имейте файл с вашими текущими задачами к ИИ

ИИ модели не позволяют иметь длинные переписки в одном чате, и делают «авто-схлопывание» (auto-compact) при достижении N токенов. На будущее, я вообще рекомендую избегать сжатия переписки, поскольку контекст к задачам теряется на процентов 40%, а это критично при объемном проекте. Именно в такие моменты возникают выдуманные функции и переменные.

В связи с этим, постоянно мучайте ИИ заполнить или создать файл с текущей ситуацией вашего проекта, какие ближайшие шаги вы сделали, где вы сейчас и что вам предстоит сделать.

Также, данный файл поможет вам в случае чего именно очищать переписку и начинать ее заново, тем самым сэкономив ваши драгоценные токены.

№1.2 CURRENT_STAGE.MD — Сделайте референсы на другие файлы внутри

Фишка CURRENT_STAGE.MD заключается в том, что вы можете сделать ссылки на файлы, чтобы быстрее посвятить в свой проект вашу ИИшку. И это не просто CLAUDE.MD и подобное, а именно те референсы, которые нужны здесь и сейчас, не затрагивая при этом 100% всего контекста проекта.

№1.3 CURRENT_STAGE.MD — Начинайте переписку с обязательного прочтения этого файла

Напишите вашей ИИ модели что-то подобное:

> Перед тем, как начать работу, прочти CURRENT_STAGE.MD и все файлы, на которые он ссылается, по порядку.
>
> Затем, выпиши кратко наши задачи и я дам команду для следующего шага.

Одной командой, вы посвятили в свой проект модель, сэкономив токены и время на пояснения особенностей и тонкостей.

№2 .claude/ & .cursor/ — Заведите себе модульную документацию

К этому рано или поздно приходят все, у кого проект дошел до стадии, когда ты сам не можешь объяснить код, который нагенерил ИИ. Обычно делают папку docs, но я рекомендую создать директорию вашего агента в формате, который я указал в названии, потому что они его лучше распознают за документацию.

Хочу скинуть ссылку на хороший промт, который я нашел на просторах Reddit, для создания документации и приведении в соответствующий вид вашей базы знаний + бонус ссылка — вставьте ее в вашу ИИшку и она поймет что сделать:

а) https://www.acmconsulting.eu/post/hello-world/

б) https://www.reddit.com/r/ClaudeAI/comments/1laby6h/i_discovered_a_powerful_way_to_continuously/

You are an expert in prompt engineering, specializing in optimizing AI code assistant instructions. Your task is to analyze and improve the instructions for Claude Code found in u/CLAUDE.md. Follow these steps carefully:

1. Analysis Phase:
Review the chat history in your context window.

Then, examine the current Claude instructions:

u/CLAUDE.md


Analyze the chat history and instructions to identify areas that could be improved. Look for:
- Inconsistencies in Claude's responses
- Misunderstandings of user requests
- Areas where Claude could provide more detailed or accurate information
- Opportunities to enhance Claude's ability to handle specific types of queries or tasks

2. Interaction Phase:
Present your findings and improvement ideas to the human. For each suggestion:
a) Explain the current issue you've identified
b) Propose a specific change or addition to the instructions
c) Describe how this change would improve Claude's performance

Wait for feedback from the human on each suggestion before proceeding. If the human approves a change, move it to the implementation phase. If not, refine your suggestion or move on to the next idea.

3. Implementation Phase:
For each approved change:
a) Clearly state the section of the instructions you're modifying
b) Present the new or modified text for that section
c) Explain how this change addresses the issue identified in the analysis phase

4. Output Format:
Present your final output in the following structure:


[List the issues identified and potential improvements]



[For each approved improvement:
1. Section being modified
2. New or modified instruction text
3. Explanation of how this addresses the identified issue]



[Present the complete, updated set of instructions for Claude, incorporating all approved changes]


Remember, your goal is to enhance Claude's performance and consistency while maintaining the core functionality and purpose of the AI assistant. Be thorough in your analysis, clear in your explanations, and precise in your implementations.

№3 Встроенные плагины — просто скачивайте и пользуйтесь (MCP, PLUGINS итд.)

Не стоит недооценивать open-source решения, которые помогают сделать как минимум хороший скелет для вашей новой задачи в проекте. Я, лично, активно пользуюсь MCP от Figma, чтобы перенести дизайн на фронт. Не скажу, что ИИшка делает это идеально, но с этим уже можно работать.

№4 Резервные копии — сделайте политику бэкапов в вашем проекте

Агент не знает, как держать баланс, между бесконечным созданием файлов _fix, _corrected, _lastone итд., и редактированием основы, поэтому, чтобы не возникало разочарований, когда ИИшка исправляла ошибку 500 часов, а в итоге все сломала и надо откатывать на версию двухдневной давности, заведите политику резервных копий.

№5 PHILOSOPHY.MD — Заведите файл с философией работы над проектом

Звучит дико — где философия и ИИ, но тут скорее подойдет русское слово «подход» — заставить прочитать агента, как вести свой проект, чтобы исправления шли логично, последовательно и плавно, а задачи закрывались быстрее и без потенциальных багов.

Вот примеры моих пунктов к работе с проектом:

а) Перед тем как начать — сделай резервные копии

б) Проверь связь и imports от других файлов, чтобы не создавать выдуманные переменные

в) Задавай по 5-7 вопросов самому себе и отвечай на них, чтобы понимать, как именно нужно исправить тот или иной модуль. Сделай 3 симуляции с процессами, которые находятся вокруг исправляемого модуля.

Буду рад за лайк и подписку на канал :) https://t.me/notes_from_cto