HYPERARCПопробовать первым

Блог, руководство

ТЗ для Claude Code: шаблон задачи из пяти строк

Кирилл Мишанихин,

Коротко: задаче агенту нужны пять строк. Цель, что считать готовым, что не трогать, как проверить и что делать, если не выходит. Шаблон и пример ниже.

Чаще всего агент делает не то по простой причине: задача была одной фразой. «Добавь запись на приём» можно понять двадцатью способами, и агент выберет свой.

Длинное техническое задание тут не поможет. Хватает пяти строк.

Шаблон

Цель: что должно появиться и для кого.
Готово, когда: что я увижу своими глазами.
Не трогать: что должно остаться как было.
Проверка: сначала напиши тест на «готово» и покажи, что он падает.
Если не выходит: остановись и спроси, а не обходи.

Пример

Плохо:

Добавь запись на приём.

Хорошо:

Цель: клиент выбирает время и записывается к мастеру.
Готово, когда: я выбираю свободное время, нажимаю «Записаться»
и вижу подтверждение. Занятое время выбрать нельзя.
Не трогать: вход и страницу мастера.
Проверка: сначала напиши тест на эти три условия
и покажи, что он падает.
Если не выходит: остановись и спроси.

Зачем нужна каждая строка

Цель. Агент выбирает между десятком решений. Когда он знает, для кого это, он выбирает точнее.

Готово, когда. Самая важная строка. Без неё у слова «готово» нет смысла: агент сам решает, когда закончил. Пиши то, что можно увидеть на экране, а не «всё должно работать».

Не трогать. Агент не знает, что для тебя ценно. Назови это прямо. Одна строка здесь экономит вечер починки.

Проверка. Тест до кода превращает «готово» из мнения в факт. Тест сначала падает, потом проходит, и оба запуска ты видишь сам.

Если не выходит. Без этой строки упёршийся агент ищет обход: удаляет мешающий код или ослабляет проверку. С ней он возвращается к тебе с вопросом.

Где хранить то, что повторяется

Правила, одинаковые для всех задач, не нужно писать каждый раз. У Claude Code для них есть файл CLAUDE.md в папке проекта: агент читает его в начале каждой сессии. Положи туда три вещи:

  • как запустить проект и проверки;
  • что нельзя трогать никогда;
  • правило «тест до кода».

Файл должен быть коротким. Длинный агент прочитает, но половину не учтёт.

Что дальше

Задача поставлена, агент написал «готово». Теперь его работу надо принять: для этого есть чек-лист из десяти проверок. Почему агенты вообще ломают рабочее, я разобрал в отдельном руководстве.

Этот шаблон упрощает формат, в котором HyperArc ставит задачи агентам. Там задача это файл, и его проверяет программа: без цели, границ и проверки задача в стройку не уйдёт. Пишет такие задачи Архитектор, а нужные файлы для агента он подбирает сам. Весь цикл описан на главной.

Я делаю HyperArc. Учитывай это, когда читаешь мои тексты о нём.