temavorobeyУ Anthropic вышел курс из четырнадцати уроков про Claude Code и про то, чего обычно не хватает: не как заставить агента писать код, а что делать с процессами вокруг кода. Наблюдение в основе простое и неприятное. Команды подключили агентов, набор кода ускорился в разы, а планирование, ревью, тесты и деплой остались на прежней скорости. Узкое место никуда не делось, оно просто переехало.
Курс написан для крупных и зарегулированных компаний, но половина приёмов работает в команде из трёх человек и в одиночном проекте. Разберём то, что переносится.
Идея становится файлом, а не строчкой в трекере
Первый приём — intent.md. Идея, тикет или сработавший алерт превращаются в короткий файл в репозитории: что хотим, зачем и при каких ограничениях. Черновик набрасывает Claude в диалоге, владелец продукта правит и коммитит.
Разница с привычным порядком не в форме, а в том, кто чего ждёт. Обычно идея проходит через бэклог, истории, оценки и пару встреч, прежде чем кто-то опишет её словами. Здесь описание появляется сразу, оно читаемо человеком, лежит под контролем версий и его можно передать в следующий шаг без пересказа. Из intent.md в одну рабочую сессию собирается спека с требованиями и дизайном.
Приём переносится в любой размер команды. Даже в личном проекте файл на пятнадцать строк «что делаю и чего не делаю» экономит потом часы, потому что агент перестаёт додумывать за вас.
Сначала план, потом код
Второй приём — начинать сессию в режиме планирования. Claude читает кодовую базу, ничего в ней не меняя, задаёт вопросы, а вы правите план, пока он не станет верным. Утверждённый вариант коммитится как plan.md.
Смысл в том, чтобы вынести наружу то, что раньше жило в голове разработчика. В обычном порядке первое, что видит ревьюер, — готовый дифф, и переделывать на этом этапе уже дорого. Когда план написан заранее, спорить о подходе можно там, где спор стоит десять минут, а не два дня.
Если вы только начинаете, отдельно про сам инструмент у нас есть первый день с Claude Code.
Знания команды переезжают в файлы
Дальше курс говорит о двух местах, где живёт контекст.
CLAUDE.md — то, что понадобилось бы новому человеку в первый день: команды сборки, тестов и линтера, принятые в проекте соглашения, архитектура в двух абзацах и список того, в чём агент регулярно ошибается. Заводится командой /init, после чего сгенерированный файл нужно безжалостно сократить до действительно нужного. Лежит в корне репозитория, правится как обычный код, через ревью.
Рабочее правило оттуда стоит выписать: ошибся дважды — правка идёт в файл. Не в устное замечание, не в голову, а в текст, который агент прочитает в начале следующей сессии. Подробный разбор — в статье про настройку CLAUDE.md.
Навыки — папка с файлом SKILL.md, где во вступлении указано, когда навык срабатывает, а в теле лежит сама инструкция. Правило разграничения простое: навык пишут для знаний, которые обязаны применяться единообразно и меняются централизованно, — стандарт безопасности, соглашение по API, требования бренда. То, что относится к одному проекту, остаётся в CLAUDE.md. Как это устроено, мы показывали в статье про навыки в Claude Code.
Проверки и ворота
Две вещи из второй половины курса, которые чаще всего пропускают.
Проверки в CI. Это набор из двадцати-пятидесяти реальных задач из недавней работы, у каждой записан ожидаемый результат. Суите гоняют, когда меняется конфигурация агента: подключили другую модель, переписали инструкцию. Набор живой: со временем часть задач перестаёт что-либо различать, и её заменяют новыми, которые нашлись в работе.
Хуки как ворота одобрения. Хук умеет не только молча разрешать и блокировать, но и останавливать действие до тех пор, пока конкретный человек не подтвердит. Так закрывают выкатку в бой, правки миграций и инфраструктуры без тикета, изменение тестов во время починки бага. Работают они везде, где действует агент, а не только на релизе.
Замыкает всё то же, с чего начали: превышенный порог из мониторинга возвращается в систему новым intent.md. Цикл закольцовывается.
Что забрать, если у вас не корпорация
Минимум, который окупается в любой команде: держать CLAUDE.md в репозитории и дописывать его после каждой второй одинаковой ошибки, начинать заметные задачи с плана, а не с кода, и закрыть хуком то, что нельзя менять без вашего ведома. Проверки и ворота согласования подключайте, когда агент начнёт трогать то, где ошибка стоит денег.
Где купить Claude
Claude Code идёт вместе с подпиской, а оплатить её из России напрямую не получится: карты российских банков Anthropic не принимает. У нас в каталоге есть Claude Pro за 2 090 ₽/мес, Max 5x за 11 010 ₽/мес, Max 20x за 22 010 ₽/мес и пополнение API от $20. Оплата картой РФ или по СБП, поддержка на русском. Для ежедневной работы агента берут Max, на пробу хватает Pro.
Обсуждение
0 комментариев