← [Раздел](README.md) · [Главная](../README.md)

# Командный workflow с AI

## Цель

Выстроить **повторяемый процесс** разработки в команде: ветки, Plan/Agent, ECC commands, code review, CI и роли людей vs агентов.

## Предварительно

- [06 — Agents](../06-agents/README.md), [11 — ECC](../11-ecc/README.md)
- Опыт PR в GitHub/GitLab

## Время

~90 минут чтения + пилот на одном спринте.

---

## Принцип: человек в контуре

AI ускоряет, но **не снимает ответственность**:

| Решение | Кто владеет |
|---------|-------------|
| Архитектура, trade-offs | Human + Plan mode |
| Реализация | Agent под rule/skill |
| Merge в main | Human после review |
| Prod deploy | Human + CI gates |

---

## Веточная модель

```text
main (protected)
  └── feature/PROJ-123-short-name
        ├── Plan doc (опционально docs/plans/)
        ├── commits (agent + human)
        └── PR → review → CI
```

**Rule** в репо: агент не пушит в `main`, не force-push.

---

## Спринт-цикл с ECC

| Фаза | Действие | ECC |
|------|----------|-----|
| Refinement | Уточнение задачи | Chat, Tracker MCP |
| Plan | Декомпозиция | `/plan`, architect agent |
| Implement | Код + тесты | Agent, `tdd-workflow` skill |
| Verify | Lint, test, security | `/quality-gate`, verification-loop |
| Review | AI + human | `/code-review`, `ecc-code-reviewer` |
| Docs | Changelog | `/update-docs` |

---

## Pull Request policy

Минимальный шаблон описания PR (храните в `.github/pull_request_template.md`):

```markdown
## Summary
- …

## AI usage
- [ ] Agent used: yes/no
- Commands/skills: /plan, tdd-workflow
- Human verified: tests, security-sensitive paths

## Test plan
- [ ] …
```

**Зачем секция AI usage:** аудит и обучение команды, не стыд.

---

## Параллельные агенты (осторожно)

ECC: `/multi-plan`, `/multi-execute`, worktrees.

**Правила команды:**

1. Только на feature-ветках.
2. Не два агента в одних файлах без координации.
3. Один «интегратор» собирает результаты.
4. Лимит времени и стоимости на эксперимент.

---

## CI + AI

| Gate | Что проверяет |
|------|---------------|
| Unit/integration tests | Поведение |
| Lint / typecheck | Стиль (дублирует afterFileEdit) |
| SAST / secret scan | То, что агент мог пропустить |
| AI regression (продвинуто) | skill `ai-regression-testing` |

Hooks **не заменяют** CI — они ускоряют feedback до push.

---

## Onboarding нового разработчика

1. Cursor + доступ к репо.
2. `configure-ecc` или готовый `.cursor/` из репо.
3. Прочитать `docs/ai-workflow.md` (создайте в команде).
4. Пройти [Lab 01–02](../12-praktikum/README.md) на копии репо.
5. Первый PR — с ментором, без multi-execute.

---

## Роли субагентов в review

```text
Author Agent → реализация
Reviewer Agent (ecc-code-reviewer) → замечания
Security Agent (при auth/crypto) → отдельный проход
Human → финал
```

Не сливайте все роли в один промпт «сделай идеально».

---

## Документ «Как мы используем Cursor» (outline)

1. Разрешённые режимы и модели.
2. Обязательные rules/skills.
3. Запрещённые действия (prod MCP, --no-verify).
4. Куда писать, если агент ошибся (шаблон инцидента).
5. Контакт platform-ответственного.

---

## Упражнение для lead

Проведите 30-мин retro: «где AI сэкономил время / где создал долг» — 3 пункта в wiki.

---

## Самопроверка

1. Кто владеет merge в main?
2. Зачем секция AI usage в PR?
3. Почему CI остаётся при hooks?
4. Когда multi-execute запрещён?

---

## Дальше

→ [Метрики эффективности](metriki-effektivnosti.md)  
← [Pro уровень](README.md)