AACWorkflow Docs

Стартап с AI-отрядом

Управляйте нежной инженерной командой: 1–2 человека и 4–6 AI-агентов, каждый отвечает за свой домен. Лучшие практики маршрутизации задач, контроля и масштабирования.

Ранние стартапы живут по принципу скорости. Два основателя, пять функций, бесконечно много работы. AI-агенты могут стать вашими первыми нанимаемыми сотрудниками — каждый отвечает за домен (бэкенд, фронтенд, QA, документация, DevOps, безопасность) и работает 24/7 рядом с вашей человеческой командой.

Этот гайд показывает, как структурировать нежный AI-отряд, четко определить домены и держать людей в курсе, не создавая узких мест.

Структура команды

Типичный стартап-отряд выглядит так:

РольИмя агентаЧто входит в обязанности
Основатель / CTO(человек)Видение, архитектурные решения, внешние коммуникации
Лид бэкенда@backend-botСерверный код, API-дизайн, базы данных, миграции
Лид фронтенда@frontend-botWeb UI, мобильные представления, библиотека компонентов, стили
Лид QA / DevOps@qa-botПокрытие тестами, CI/CD, развёртывания, наблюдаемость
Лид документации / контента@docs-botПользовательская документация, API-доки, чейнджлоги, уроки
Лид безопасности / инфраструктуры@security-botАудиты зависимостей, сканирование безопасности, секреты, контроль доступа

Почему это работает:

  • Каждый агент узконаправленный (одна кодовая база, чёткий домен) — ошибки изолированы
  • 1–2 человека проверяют, одобряют и отправляют в продакшн (не ждут код-ревью от 5 человек)
  • Агенты могут работать параллельно (бэкенд и фронтенд независимо)
  • Люди фокусируются на стратегии, а не на разблокировании ревью

Как подключить агента

Шаг 1: Определить область

Напишите одностраничный устав для каждого агента. Пример:

Агент: @backend-bot
Домен: server/ (Go-бэкенд)

Отвечает за:
- Chi HTTP-обработчики в server/internal/handler/
- sqlc-запросы в server/pkg/db/queries/
- PostgreSQL-миграции
- Контрактные тесты API

НЕ отвечает за:
- Код фронтенда (в ведении @frontend-bot)
- DevOps / развёртывание (в ведении @qa-bot)
- Документацию (в ведении @docs-bot)

Рабочий процесс:
- Назначьте задачу из доски → агент её берёт
- Агент открывает draft PR (для ревью)
- @backend-bot пишет в #engineering Slack: "PR #123 готов к ревью"
- Человек проверяет в течение 2–4 часов (асинхронно OK)
- Мерж при одобрении

Шаг 2: Дать каждому агенту MCP-сервер

Каждый агент должен иметь доступ к инструментам для своего домена:

АгентMCP-серверы / APIsИнструменты
@backend-botGitHub (код), Go CLI, sqlc, PostgreSQLBash, git, Go-тулчейн
@frontend-botGitHub (код), npm/pnpm, Next.js, TypeScriptBash, npm, Node.js CLI
@qa-botGitHub (CI/CD-логи), Docker, kubectl, мониторингBash, docker, CI logs API
@docs-botGitHub (репо), Markdown-инструменты, проверка ссылокBash, grep, curl
@security-botGitHub, npm audit, OWASP ZAP, Snyk APIBash, curl, audit CLIs

Шаг 3: Создать общий Slack-канал

Напишите тред с уставом, доменом и текущим статусом каждого агента:

🤖 Engineering Squad
Frontend: @frontend-bot (available) ✅ Последняя задача: Dark mode
Backend: @backend-bot (available) ✅ Последняя задача: Workspace API pagination
QA/DevOps: @qa-bot (running) 🔄 Последняя задача: Deploy v1.1 to production
Docs: @docs-bot (available) ✅ Последняя задача: API changelog
Security: @security-bot (available) ✅ Последняя задача: npm audit weekly

Рабочий процесс назначения задач

Трёхшаговая передача

  1. Человек пишет задачу (5 минут)

    Название: Add dark mode toggle to sidebar
    
    Описание:
    Users need a way to switch between light and dark themes.
    Store preference in localStorage and sync across tabs.
    Use existing Tailwind dark: variants in packages/ui/.
    
    AC:
    - [ ] Dark mode toggle in sidebar
    - [ ] Respects system preference on first visit
    - [ ] Persists across sessions
    - [ ] All components render in dark mode
    
    Reference: Figma design link
  2. Человек назначает агенту (1 минута)

    • Для фронтенда: назначьте @frontend-bot
    • Для бэкенда: назначьте @backend-bot
    • Неясно? Назначьте @orchestrator (мета-агент) для маршрутизации
  3. Агент выполняет end-to-end (1–4 часа)

    • Читает задачу
    • Планирует реализацию
    • Открывает draft PR с кодом
    • Пишет в Slack: "Dark mode PR is ready for review → #123"
    • Человек проверяет, одобряет, мержит

SLA ревью

Установите ожидания заранее:

Тип PRВремя ревьюВремя мержаAuto-action
БагфиксВ тот же день2–4 часа после одобренияНет
Маленький фичер (<100 LOC)4–8 часов1 день после одобренияНет
Большой фичер (>200 LOC)1–2 дня2 дня после одобренияНет
Документация2–4 часаСразу после одобренияAuto-merge
Зависимости (patch)В тот же деньСразу, если тесты пройдутAuto-merge

Предотвращение неконтролируемых агентов

Агенты мощные, но нуждаются в страховке:

1. Код-ревью обязателен

  • Все PR агентов требуют человеческого одобрения перед мержем
  • Используйте GitHub branch protection: require 1 approval
  • Права на мерж имеют только люди, не агенты

2. Один домен на агента

  • Чёткие границы предотвращают расширение области
  • Агент придерживается устава (например, @frontend-bot не трогает server/)
  • Если задача охватывает несколько доменов, разбейте её

3. Следить за ошибками

  • Проверьте PR агентов на:
    • Опечатки, граммотику комментариев, именование переменных
    • Упущенные тест-кейсы или edge cases
    • Изменения контракта API (запустите parseWithFallback checks)
    • Версии зависимостей (избегайте случайных major bumps)

4. Откатите элегантно

Если агент промержил плохой PR (редко, но случается):

git revert <commit-sha>
git push
# Назначьте revert тому же агенту с контекстом
# Агент учится и не повторит ошибку

5. Приостановите агентов при отправке критичных фич

Перед крупным релизом (v1.0, запуск продукта):

  • Архивируйте агентов временно (или установите режим "review-only")
  • Люди напрямую проверяют критичный путь
  • Возобновите агентов после запуска

Пример недели в стартап-отряде

Понедельник 9 AM: CTO пишет 5 задач на неделю (dark mode, API pagination, deployment automation, security audit, docs refresh).

Понедельник 10 AM: Назначьте отряду:

  • Issue #1 (UI) → @frontend-bot
  • Issue #2 (API) → @backend-bot
  • Issue #3 (DevOps) → @qa-bot
  • Issue #4 (security) → @security-bot
  • Issue #5 (docs) → @docs-bot

Понедельник 11 AM – Пятница 5 PM: Агенты работают параллельно. Люди проверяют PRs асинхронно, 2–4 раза в день. Каждый агент открывает 1–3 PR за неделю.

Пятница 4 PM: Все задачи мержены. Агенты пишут в Slack:

✅ Weekly squad recap (2025-06-20)
📊 Stats: 12 PRs, 0 rollbacks, 23 commits

🎯 Shipped:
- Dark mode toggle + system preference detection
- Workspace API pagination (tested with 100k issues)
- Deploy automation (v1.2.0 now deployable via CLI)
- npm audit + security patches (3 CVEs fixed)
- API docs updated + tutorial started

⏳ Next week:
- Mobile dark mode (WIP, high priority)
- Database query optimization
- E2E tests for invite flow

Пятница 5:30 PM: CTO пишет release notes, тагирует v1.2.0, отправляет. Отряд выходной (буквально — они агенты, отпуска не нужны).


Советы и лучшие практики

Агенты работают на вас, а не наоборот. Если агент создаёт больше оверхеда ревью, чем экономит, это не подходит. Переориентируйте его домен или временно снимите его.

Начало работы

  • Начните с 2 агентов — бэкенд и фронтенд. Изучите рабочий процесс.
  • Добавляйте по 1 в неделю — QA, потом документация, потом безопасность. Не варите окрошку сразу.
  • Мониторьте качество агентов — отслеживайте процент принятия PR (цель: >90% мержено с первой попытки)
  • Еженедельная ретро — потратьте 15 мин в пятницу, чтобы обсудить, что прошло хорошо и что улучшить

Долгосрочное масштабирование

  • Агенты как менторы — юные люди учатся из кода агентов; это учебный материал
  • Документация от агентов — агенты генерируют доки, которые люди полируют; экономит время на написание
  • Параллельные треки — 2–3 агента могут работать над независимыми фичами; люди проверяют каждый
  • Реагирование на инциденты — назначьте баг агенту, владеющему тем доменом; они триажируют 24/7

Командный дух

  • Кредитуйте агентов в PR и relase notes ("Thanks @frontend-bot for the dark mode implementation")
  • Celebrируйте победы агентов в Slack (e.g., "Agent shipped 50 PRs this month!")
  • Будьте прозрачны о ограничениях агентов (они не могут делать дизайн, стратегию, или общение со стейкхолдерами)
  • Держите людей в курсе важных решений (не давайте агентам решать цены, направление фич и т.д.)

Типичные ошибки

ОшибкаЧто идёт не такИсправление
Без кода-ревьюАгенты допускают ошибки, которые попадают в продакшнВсегда требуйте человеческое одобрение
Нечёткие назначенияАгент гадает, что делать, и тратит время впустуюНапишите чёткие AC в задаче
Слишком много агентов на один доменАгенты конфликтуют, дублируют работу, путаницаОдин агент на домен
Агенты никогда не ошибаютсяВы думаете, они идеальны, и перестаёте проверятьОни всё ещё ошибаются в ~10%; будьте бдительны
Люди rubber-stamp PRsНикакого реального ревью; теряет смыслЧитайте код; задавайте вопросы; заботьтесь

Связанные гайды