Субагент сдаёт волну: отчёт на страницу, тесты зелёные, «можно собирать». Запускаю сборку, она падает на компиляции. Открываю упомянутый файл: половины классов из отчёта в нём нет. Это не единичный случай, это нормальное поведение. В память проекта легла формула, вокруг которой построилась вся дальнейшая работа: субагент принял задачу, не значит код работает.
Контекст для тех, кто не читал первые две части: у меня небольшое производство электродвигателей, и под него я собрал свою систему вместо ERP (вводная здесь): Python-сервер, Android-планшеты в цеху, семь ИИ-агентов внутри системы (вторая часть). Писал я её не руками, а командой субагентов Claude Code. В этой статье техника: как настроены агенты, что у них в промптах, как устроен релизный конвейер и приёмка, после которой в цех больше не уезжает недоделанное.
Субагент: файл с фронтом и системным промптом
В Claude Code субагент это markdown-файл в .claude/agents/ репозитория. Фронт определяет, что он умеет делать и на чём думает, тело это системный промпт. Вот фронт контролёра релиза, дословно:
---name: app-motors-release-controllerdescription: Проверяет, что релиз (Android APK + backend) реально готов по критериям Definition of Done — по уликам, а не по отчётам субагентов. Never writes code or edits files.tools: Read, Glob, Grep, Bashmodel: opus---
Три решения в четырёх строках. Список tools белый: у контролёра нет Write и Edit, он физически не может поменять код, который проверяет. Модель подбирается под роль: семь агентов команды работают на Opus, семь на Sonnet. Правило у меня простое: рассуждение и решения это Opus, исполнение по ясному плану это Sonnet.
Всего таких файлов в проекте пятнадцать:
Агент
Модель
Зона
tech-lead
opus
планы релизов, соответствие ТЗ, конфликты спецификаций
backend-developer
sonnet
FastAPI, Pydantic, SQLAlchemy, сервисы
android-developer
opus
Kotlin, Compose, навигация
db-engineer
opus
миграции Alembic, триггеры, представления
ai-agent-engineer
opus
продуктовые агенты внутри системы
devops / worker / integration / web
sonnet
Docker, Celery, стыковки, админка
qa-engineer
sonnet
pytest, testcontainers, golden datasets
build-verifier
sonnet
сборки APK в Docker, тесты, smoke
security-reviewer
opus
security gate перед релизом
prod-auditor
opus
аудит боевого сервера
release-controller
opus
вердикт по DoD
Над ними главный агент (Claude Code в основной сессии): он интегрирует куски и делает все коммиты. Субагент в git не пишет никогда, свой результат он сдаёт отчётом. Автор в истории один, APP Motors Team, и по логу git не отличить, где работал агент, а где я.
Тех-лид: документы вместо памяти
Первый агент, промпт которого пришлось переписывать всерьёз, был тех-лид. Проблема оказалась не в коде, а в источниках: если агент «помнит» требования по себе, каждый волен додумывать. Решение: пять документов спецификации объявлены single source of truth, и в промпте это прошито жёстко:
В рабочей директории Docs/ лежат пять документов. Они утверждены заказчиком,и команда не возвращается к их обсуждению — только реализует.1. tz_app_motors_v2.md — главное ТЗ: цель, архитектура, стек, роли, план релизов.2. db_schema_v1.md — полная схема PostgreSQL: 35+ таблиц, FK, индексы, триггеры.3. api_v1.md — REST API v1: 100+ endpoint-ов, идемпотентность, optimistic locking....Перед любой задачей прочитай релевантные разделы этих документов.Не работай по памяти — читай конкретный файл и раздел.
Дальше в промпте одиннадцать архитектурных принципов, нарушение любого означает откат кода. Три из них:
- Реляционное и событийное ядро. AI — слой автоматизации поверх бизнес-правил, не вместо.- Идемпотентность входящих через external_id + Redis + UNIQUE constraint.- Critical AI actions FORBIDDEN_FOR_AGENT — выпуск ревизий, потребление материалов, релиз work_order — только человеком.
И формат, в котором тех-лид отдаёт план. Каждая задача спринта выглядит так, дословно:
### Task R0-02: SQLAlchemy 2 baseline + naming conventions- Владелец: app-motors-db-engineer- Acceptance: app/db/base.py с naming_convention, пустая Alembic-конфигурация, baseline миграция применяется- Зависимости: R0-01-
Источник: habr.com