Контур гильдии

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

Замысел как файл

Переписка — плохой носитель требований: её нельзя ни отревьюить, ни сослаться на версию. Рабочий приём — заставить агента вытащить требования из вас и записать их.

Хочу построить <краткое описание>. Проинтервьюируй меня подробно
через инструмент AskUserQuestion. Спрашивай про реализацию, интерфейс,
краевые случаи и компромиссы. Не задавай очевидных вопросов, копай
в сложное. Когда покроем всё — запиши спецификацию в SPEC.md.

Готовую спецификацию исполняют в новой сессии: у неё чистый контекст, целиком занятый реализацией, а спецификация лежит на диске, и её можно перечитать (Котёл).

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

Второй носитель командного знания — скиллы и правила: негласная договорённость, переведённая в машиночитаемый вид, работает и у того, кто про неё не слышал (Раздача артефактов).

Ревью в потоке пул-реквестов

Здесь два разных продукта, и выбор между ними — вопрос контроля.

Управляемый сервис Code Review. Ничего писать не нужно: владелец включает его в админ-настройках, выбирает репозитории и режим (на открытие PR, на каждый пуш или только по запросу). Ревью идёт на инфраструктуре Anthropic, находки приходят инлайн с маркерами серьёзности, проверка всегда завершается нейтрально и слияние не блокирует. Подробности и настройка через REVIEW.md — Вторые глаза.

Собственный воркфлоу. Действие anthropics/claude-code-action@v1, устанавливается командой /install-github-app или руками. Секрет — ANTHROPIC_API_KEY либо CLAUDE_CODE_OAUTH_TOKEN (создаётся командой claude setup-token).

Режима работы два, и определяются они наличием одного поля:

Ключевые входы: prompt (текст или вызов скилла), claude_args (любые аргументы CLI — --max-turns, --model, --allowedTools), plugin_marketplaces и plugins для установки плагина перед запуском, settings, trigger_phrase.

Две проверки происходят до запуска Claude, и о них лучше знать заранее: у инициатора должно быть право записи в репозиторий, а бот-акторы отклоняются, если не перечислены в allowed_bots — это защита от петли, где один бот бесконечно вызывает другого.

Тонкость с публикацией находок: даже если у скилла в allowed-tools уже назван нужный инструмент, действие поднимает MCP-сервер для инлайн-комментариев только тогда, когда тот назван в --allowedTools внутри claude_args.

Ворота, которые нельзя обойти

Правило в инструкции — рекомендация, правило в хуке — исполнение. PreToolUse срабатывает до любой проверки режима разрешений, в любом режиме, включая bypassPermissions, и его вердикт deny блокирует инструмент. Обратное не работает: allow от хука не отменяет запрещающих правил (Стражи).

Отсюда практическая раскладка, что где должно жить:

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

Стоимость контура

Каждый прогон в CI тратит минуты раннера и токены. Дешевле его делают конкретные формулировки запросов, короткий CLAUDE.md (он читается на каждом прогоне), ограничитель --max-turns, таймаут на уровне воркфлоу и контроль параллельности. Выбор режима ревью влияет сильнее всего: на каждый пуш — самый дорогой вариант.

Замкнуть контур на измеримом результате помогает то же, что и в одиночной работе: критерий сдачи, который проверяет машина (Замкнутый цикл).