Волшебные слова для Claude Code, Codex и иже с ними

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

Пишешь specs, roadmap, vision, tests, PRD или harness — и модель достаёт из этого одного слова целый набор правил, документов и привычных инженерных практик.

Возможно, все эти слова давно знают. Но использовать их регулярно почему-то забывают.

Небольшой дисклеймер: на темы разработки я общаюсь с LLM только по-английски. Поэтому не обученному языкам пользователю придётся либо мириться с англицизмами, либо писать эти слова прямо латиницей. Это тот случай, когда перевод иногда теряет часть смысла.

Самое волшебное слово — specs.

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

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

Если спецификация сохранена в репозитории, агент может сверяться с ней во время работы и проверять, не потерял ли он часть требований.

Разумеется, сам файл ничего не гарантирует. Но с ним вероятность получить именно задуманную систему становится заметно выше.

Спецификацию желательно сохранять всегда и поддерживать в актуальном состоянии. Это один из самых полезных артефактов, которые остаются после общения с LLM.

Roadmap строит общую картину реализации.

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

Полезно попросить агента сделать roadmap живым документом:

Тогда новая сессия начинается не с археологии по истории чатов, а с понятного состояния проекта.

Vision отвечает на вопрос: зачем вообще всё это делается?

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

Это особенно полезно в длинных проектах. Агент может добросовестно реализовывать отдельные задачи, но постепенно увести продукт в сторону. Vision помогает проверить, соответствует ли очередное технически красивое решение первоначальной задумке.

Иногда достаточно одной страницы.

Слово tests тоже запускает довольно большой механизм.

Важно просить агента не просто «написать тесты», а определить, какие свойства системы они должны защищать. Полезные тесты фиксируют ожидаемое поведение и не дают следующей сессии случайно сломать уже работающую часть.

Для кодового агента тесты — ещё и способ самостоятельно проверить результат. Без них он часто заканчивает работу на стадии «код выглядит правдоподобно».

PRD, или Product Requirements Document, описывает продукт с точки зрения пользователя и бизнеса.

Кто будет этим пользоваться? Какую проблему решает функция? Какие сценарии считаются основными? Что входит в первую версию, а что пока не входит?

Specs чаще объясняют, что и как строить, а PRD — что именно нужно пользователю и почему.

Для небольшого инструмента PRD может занимать несколько абзацев. Но даже такой документ помогает не начать строить сложную систему там, где пользователю нужна одна кнопка.

Harness — более модное слово. И оно в общем-то обо всём сразу.

В контексте AI-разработки это окружение, которое удерживает агента в рабочем процессе: инструкции, инструменты, тесты, проверки, правила запуска, доступ к документации и механизм повторных попыток.

Грубо говоря, хороший harness позволяет агенту не просто написать код, а пройти весь цикл:

Чем лучше организован этот контур, тем меньше приходится вручную контролировать каждый шаг. Обсуждайте harness своего проекта с моделью - узнаете много интересного. :-)

Эти слова полезны не из-за какой-то скрытой функции Claude Code или Codex.

За каждым из них стоит сложившаяся инженерная практика. Модель встречала спецификации, продуктовые документы, дорожные карты и тестовые контуры в огромном количестве проектов. Одно слово поднимает весь этот контекст.

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

Волшебных слов, конечно, намного больше: architecture, acceptance criteria, constraints, invariants, definition of done, migration plan.

Главное — иногда вспоминать, что агенту можно дать не просто задачу, а знакомую и проверенную годами форму организации работы.
Колдуйте!