раздел 03

Что настроить на практике

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

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

Направляющие: задать контекст заранее

  • Файл инструкций. Главный рычаг. Опишите стек, структуру, соглашения, чего не делать. Подробно - в мануалах AGENTS.md и CLAUDE.md и стартовый набор агента.
  • Skills и rules. Готовые навыки и правила под повторяющиеся задачи: как у вас оформляют коммиты, как пишут тесты, какой стиль. Мануал Skills и rules.
  • MCP-серверы. Дают агенту доступ к вашим данным и системам - базе, документации, трекеру. Мануал MCP-серверы.

Датчики: ловить ошибки сразу

  • Линтеры и тесты как обратная связь. Это не бюрократия, а сигнал агенту. Линтер и тест-раннер, подключённые в обвязку, сообщают агенту об ошибке, и он исправляется сам.
  • Pre-commit hooks. Запускают быстрые проверки автоматически перед коммитом, не дожидаясь человека. Ошибка не уезжает дальше.

Безопасность и состояние

  • Разрешения агента. Что агенту можно делать без спроса, а что только с подтверждением. Мануал Разрешения агента.
  • Память агента. Что агент помнит между сессиями: предпочтения, решения, контекст. Мануал Память агента.
  • Управление контекстом. Что подавать модели на каждом шаге, чтобы окно не забивалось мусором. Мануал Управление контекстом.

Принцип «сдвиг проверок влево»

Главный принцип расстановки датчиков - shift-left: чем раньше поймали ошибку, тем дешевле её исправить. Опечатку, пойманную pre-commit hook, чинят за секунды. Ту же ошибку, всплывшую на проде, - часами. Поэтому проверки распределяют по процессу: дешёвые и быстрые - в самое начало, дорогие - дальше.

1
До коммита - быстрые проверки
Линтеры, type-check, быстрые тесты в pre-commit hook. Миллисекунды-секунды, ловят опечатки и явные дефекты.
2
После интеграции - детальный разбор
Полный прогон тестов, AI-ревью смысла, мутационное тестирование. Дороже, но ловят сложное.
3
Постоянно - мониторинг
Следим за поведением в работе: что ломается на практике, какие ошибки повторяются.

Самокоррекция вместо контроля вручную

Цель обвязки - не убрать человека, а направить его внимание туда, где оно нужнее. Если сообщения об ошибках и отчёты проверок написаны понятно, агент исправляет рутину сам. Человек подключается там, где нужно решение, а не там, где можно было автоматизировать. Хорошая обвязка не устраняет участие человека, а адресует его в самое важное.