Конспект: Фреймворк Intent.md от Anthropic: Как ставить задачи Claude Code без ошибок и сломанного кода — VibCoderZ - VibeCoderz

Загрузка...

Саммари

🎯 О чём этот конспект: Разбор официального плейбука Anthropic по оркестрации AI-агентов (Claude Code, Cursor, Codex) через цепочку артефактов планирования: Intent.md, Spec.md и Plan.md. Видео объясняет, почему прямые промпты ломают кодовую базу сложных проектов, и даёт готовую 6-этапную петлю для предсказуемой генерации функций и автоматизаций без галлюцинаций.

👤 Кому будет полезно: Вайбкодерам, разработчикам и техническим фаундерам, использующим Claude Code, Cursor или Codex, у которых нейросеть при написании нового функционала ломает существующий код или уходит в неверную архитектуру.

✨ Что получите: Готовые промпты и пошаговый алгоритм для внедрения трёхфайловой структуры планирования (Intent.md → Spec.md → Plan.md), технику стресс-тестирования плана агента и методику запуска задач в изолированном контексте.

1. Концепция артефактно-ориентированной разработки: переход от промптов к файловой петле

Контекст: С развитием современных AI-агентов время непосредственно на написание кода сократилось в разы, однако планирование, архитектурный дизайн, тестирование и выкладка по-прежнему отнимают большую часть ресурсов. Когда разработчик даёт агенту прямую команду сделать сложную фичу одной инструкцией, агент заполняет любые пробелы в контексте собственными догадками. Это неизбежно приводит к нарушению безопасности, поломке соседних модулей и накоплению технического долга. Anthropic предложила заменить линейный промптинг циклической петлей из 6 этапов, где каждый шаг завершается созданием Markdown-документа, а следующий шаг начинается с чтения этого документа отдельным изолированным агентом.

Тайминг: , ,

Выгода: Исключение случайных поломок архитектуры и сокращение времени на ручной дебаг некорректно написанного AI-кода до 80%.

Как применить:

Шаг 1: Разделение глобального и локального контекста — В корне проекта используйте CLAUDE.md исключительно для неизменяемых глобальных правил репозитория (кодстайл, стек, команды сборки). Для каждой отдельной задачи или фичи создавайте изолированный подкаталог с локальными файлами намерений.
Шаг 2: Организация 6-этапной петли агентов — Выстройте процесс разработки по цепочке: Планирование намерений (Intent.md) → Спецификация требований и архитектуры (Spec.md) → Детальный план реализации (Plan.md) → Генерация кода → Автоматизированное тестирование → Деплой и поддержка.
Шаг 3: Передача состояния через файлы, а не контекст чата — Завершайте каждый этап фиксацией MD-файла в репозитории. Следующий агент должен стартовать с очищенным контекстом, получая на вход только релевантные MD-документы предыдущего шага.

Результат: Прозрачный процесс разработки, где агент лишён возможности додумывать бизнес-логику и жёстко ограничен зафиксированными артефактами.

2. Формирование Intent.md через глубокое интервью агентом

Контекст: Intent.md — это разовый документ намерений под конкретную задачу, который формируется до написания первой строчки кода или архитектурного плана. В отличие от стандартного ТЗ, он строится через процедуру «прожарки» (интервью): нейросеть задаёт пользователю серию уточняющих вопросов, пока не закроет все пробелы в требованиях, рисках и зависимостях. Файл служит «компасом» для агентов на всех последующих этапах — если дальнейшие правки противоречат изначальной цели из Intent.md, агент обязан остановиться и запросить подтверждение.

Тайминг: , , ,

Выгода: Предотвращение отклонения агента от бизнес-цели в процессе длинных диалогов и правок.

Как применить:

Шаг 1: Подготовка папки задачи — Создайте отдельную директорию под фичу внутри репозитория (например, features/niche-analysis/ или tasks/payout-status/).
Шаг 2: Запуск интервьюирующего промпта — Отправьте агенту задачу через улучшатель промптов или напрямую в Claude Code с инструкцией провести жесткое интервью по 5 ключевым блокам: проблема, желаемый результат, затронутые пользователи, затронутые системы, ограничения и открытые вопросы.

У меня стоит задача: [опиши задачу своими словами, например: найти нишу для MVP соло-продукта / создать модуль проверки статуса страховых выплат]. 
 
Твоя задача:
1. Проведи со мной глубокое интервью. Задавай вопросы по одному или блоками, изучи мой опыт, контекст, технические ограничения и цели.
2. Прожаривай мои ответы и задавай уточняющие вопросы до тех пор, пока не закроешь все слепые зоны и пробелы в знаниях, необходимые для 100% автономного выполнения задачи.
3. Оцени задачу реалистично, выдели риски и открытые вопросы.
4. Сформируй по итогам единый файл Intent.md, по которому в дальнейшем будут работать все агенты.

Шаг 3: Сохранение результатов без домыслов — После завершения интервью заставьте агента зафиксировать сырые факты в файл, исключив галлюцинации и непрошенные идеи.

Запиши итог интервью в файл intent.md внутри текущей папки задачи.
Пиши строго моими словами, без преждевременных выводов, идей и предложений.
Всё, в чём ты не уверен на 100% или где не хватает данных, не додумывай, а внеси в раздел "Открытые вопросы".

Шаг 4: Ручная вычитка и валидация — Обязательно прочитайте сгенерированный Intent.md лично. Исправьте все смысловые неточности, так как любая ошибка в этом файле масштабируется на этапах кода.

Результат: Готовый файл Intent.md с пятью обязательными разделами (Проблема, Требуемый результат, Кого касается, Системы, Ограничения), утверждённый человеком.

3. Трансформация намерений в техническую спецификацию: Spec.md

Контекст: После фиксации бизнес-намерений необходимо перевести их на язык системных требований и технического дизайна. В терминологии Anthropic «дизайн» включает в себя не визуальные интерфейсы, а архитектуру компонентов, схемы данных, интерфейсы взаимодействия и правила безопасности. Spec.md объединяет правила из скиллов/линтеров проекта с требованиями из Intent.md и явно вскрывает архитектурные конфликты.

Тайминг:

Выгода: Готовое строгое техническое задание, пригодное для передачи любому исполнителю — AI-агенту (Claude Code, Cursor) или живому разработчику.

Как применить:

Шаг 1: Запуск генерации спецификации — В терминале или интерфейсе Claude Code скормите агенту ссылку на Intent.md и подключите локальные правила проекта.

Прочитай файл намерений intent.md и составь полную спецификацию системных требований и архитектурного дизайна (Spec.md) для этого проекта.
Если в проекте настроены скилы/правила оформления, безопасности или интерфейсов — примени их.
Запиши спецификацию целиком в файл spec.md так, чтобы её можно было сразу отдать на реализацию любому исполнителю (человеку или AI-агенту).
Отдельно и явно выдели спорные места и архитектурные развилки, особенно там, где требования потенциально противоречат друг другу.

Шаг 2: Анализ спорных мест — Изучите раздел противоречий в сгенерированном Spec.md. Если агент обнаружил конфликты в логике или безопасности, согласуйте компромиссное решение до перехода к планированию работ.

Результат: Файл Spec.md, содержащий структуру компонентов, модели данных, ограничения по безопасности и правила интеграции.

4. Составление и стресс-тестирование плана реализации: Plan.md

Контекст: Наличие спецификации не гарантирует правильную последовательность действий. Для предотвращения хаотичных правок создается Plan.md, где детально описывается пошаговый порядок манипуляций с файлами, оценка рисков каждого шага и критерии приемки. Перед утверждением плана автор рекомендует применить технику «допроса плана» (Plan Interrogation) от инженеров Anthropic — задать нейросети три жестких проверочных вопроса для выявления скрытых рисков.

Тайминг: , ,

Выгода: Снижение вероятности деградации существующего функционала и 100% прозрачность того, как агент собирается проверять собственную работу.

Как применить:

Шаг 1: Генерация базового плана реализации — Запустите режим планирования в Claude Code с опорой на созданные ранее артефакты.

Изучи файлы intent.md и spec.md. 
Составь детальный пошаговый план реализации (Plan.md):
1. Какие файлы появятся, а какие будут изменены?
2. Точный порядок выполнения работ.
3. Понятные и проверяемые критерии проверки (Checklist), которые однозначно докажут, что бизнес-цель из intent.md достигнута и требования spec.md выполнены.
Анализ и написание кода пока не начинай.

Шаг 2: Стресс-тестирование («допрос») плана — Отправьте три проверочных вопроса из официального плейбука Anthropic:

Ответь на три вопроса по твоему плану перед утверждением:
1. Что именно этот план может сломать в текущей системе?
2. Какой шаг из предложенных является самым рискованным и почему?
3. Какие альтернативные технические решения ты отбросил в процессе планирования и по какой причине?

Шаг 3: Сохранение и фиксация артефакта — Зафиксируйте финальную версию документа:

Сохрани согласованный план в файл plan.md. 
Структура: Затронутые файлы, Порядок работ, Риски и митигации, Критерии проверки.
В заголовке файла укажи точную ссылку на intent.md, на базе которого составлен план.
Написание кода пока не начинай.

Результат: Выверенный и устойчивый к рискам документ Plan.md, содержащий пошаговый чек-лист имплементации и тестирования.

5. Исполнение в чистой сессии (Clean Context) и самоконтроль агента

Контекст: Самая частая ошибка при работе с AI-агентами — попытка писать код в том же диалоге, где шло долгое обсуждение и планирование. Раздутый контекст заполнен мусорными токенами, устаревшими гипотезами и рассуждениями, что снижает качество кодогенерации и приводит к потере фокуса модели. Официальная рекомендация Anthropic — начинать имплементацию в полностью очищенной сессии терминала, передавая агенту только ссылки на три готовых файла (Intent.md, Spec.md, Plan.md).

Тайминг: , ,

Выгода: Максимальное качество генерации кода за счет чистого контекстного окна и автоматическая верификация фичи по чек-листу.

Как применить:

Шаг 1: Очистка контекста — Откройте новое окно терминала с Claude Code или выполните команду сброса сессии (/clear / /compact в зависимости от среды).
Шаг 2: Запуск агента на исполнение — Передайте стартовый промпт со строгим требованием синхронизации плана при любых отклонениях:

Реализуй задачу строго по файлу plan.md. 
Контекст и архитектурные требования смотри в spec.md, бизнес-цели — в intent.md.
Правила работы:
1. Если по ходу разработки возникнет необходимость отойти от плана, сначала обнови plan.md в том же коммите/изменении.
2. После завершения кода пройди по каждому пункту из раздела "Критерии проверки" в plan.md и предоставь подробный отчет с доказательствами работоспособности по каждому пункту.

Шаг 3: Финальная верификация по матрице намерений — Сверьте отчет агента с изначальным Intent.md: подтвердите статус реализации каждого намерения, проверьте логи, тестовые прогоны и артефакты в кодовой базе.

Результат: Чисто реализованный функционал, протестированный по заранее утверждённым критериям, с актуализированной документацией изменений в репозитории.

FAQ

В: В чём принципиальное различие между CLAUDE.md и Intent.md? О: CLAUDE.md — это постоянный глобальный файл конфигурации репозитория, который агент подгружает в каждой сессии (содержит стек, команды сборки, правила форматирования). Intent.md — это временный локальный документ под конкретную задачу или фичу, фиксирующий бизнес-намерения и рамки текущей итерации.

В: Зачем нужно создавать три отдельных файла (Intent, Spec, Plan), если можно объединить всё в один промпт? О: Объединение приводит к размыванию контекста и галлюцинациям при сложных задачах. Разделение на артефакты позволяет разделить ответственности: Intent.md отвечает на вопрос «Зачем и в каких границах?», Spec.md — «Что именно строим технически?», а Plan.md — «В каком порядке и как проверяем?».

В: Почему критично открывать новую сессию перед непосредственным написанием кода? О: В процессе интервью и планирования контекстное окно забивается промежуточными рассуждениями и отвергнутыми вариантами. Чистая сессия с готовыми MD-файлами даёт агенту максимальный объём свободного внимания модели на архитектуру кода и синтаксис без когнитивного шума.

В: Что делать, если во время кодинга агент понимает, что архитектуру нужно изменить? О: По правилу фреймворка агент обязан сначала внести правки в Plan.md (или Spec.md), зафиксировать изменения и только после этого приступать к модификации кодовой базы, чтобы сохранить связь между замыслом и реализацией.

В: Когда можно обойтись стандартным простым промптом без создания Intent.md? О: Обычного промпта достаточно для типовых тривиальных задач (правка опечатки, мелкий рефакторинг одной функции, генерация шаблонного скрипта), где не требуется высокая точность и нет риска сломать связанную архитектуру.

Ресурсы и ссылки

Claude Code — Консольный AI-агент от компании Anthropic для автономной разработки и работы с кодовой базой — упомянут в видео.
Официальный Playbook Anthropic по агентной разработке — Документация и методология постановки задач агентам через артефакты — упомянут в видео.
Telegram-канал «Нейропросвещение» — Перевод оригинальной статьи Anthropic и шаблоны промптов — упомянут автором в видео.

Конспект создан на основе видео «Как ставить задачи Claude Code: фреймворк Intent.md от Anthropic» канала Нейропросвещение. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=WbTeKNsFHLw