15 субагентов Claude Code писали систему. Принял её по уликам, а не по отчётам

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

Контекст для тех, кто не читал первые две части: у меня небольшое производство электродвигателей, и под него я собрал свою систему вместо 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

0 0 голоса
Рейтинг новости
1
0
Подписаться
Уведомить о
0 комментариев