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

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

## Цель

Распознать **антипаттерны** агентной разработки, знать протокол восстановления после плохого diff, утечки контекста или сломанных hooks.

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

- Весь курс 00–13 или практика 1+ месяц
- Git: checkout, revert, reset (понимание рисков)

## Время

~45 минут (+ один разбор своего инцидента).

---

## Категории ошибок

```text
A. Промпт и контекст
B. Артефакты (rules/skills/hooks)
C. Процесс (review, CI)
D. Безопасность
E. Оркестрация (multi-agent)
```

---

## A. Промпт и контекст

| Ошибка | Симптом | Recovery |
|--------|---------|----------|
| «Сделай всё» | 50 файлов в diff | Stop, новая сессия, узкий scope |
| Весь repo в @ | Галлюцинации, таймаут | Только @файлы + grep |
| Длинная сессия | Противоречия в ответах | Новая сессия + план в md |
| Нет критериев готовности | Бесконечные итерации | DoD чеклист в промпте |

**Профилактика:** Plan mode, strategic-compact skill.

---

## B. Rules / Skills / Hooks

| Ошибка | Симптом | Recovery |
|--------|---------|----------|
| 50 rules always-on | Медленно, путаница | agent-sort → DAILY |
| Дубли rule и skill | Конфликт инструкций | Один source of truth |
| Тяжёлый afterFileEdit | Каждая правка = 2 мин | Только format, тесты в CI |
| Сломанный hook exit 1 | Сессия не работает | Откат hooks.json из Git |
| Hookify + hook дубль | Двойные блокировки | Один механизм |

**Профилактика:** code review на `.cursor/` как на код.

---

## C. Процесс

| Ошибка | Симптом | Recovery |
|--------|---------|----------|
| Accept all без diff | Скрытый мусор | `git diff`, revert файлов |
| AI review = единственный | Пропуск security | Human + security-reviewer |
| Нет тестов | Регрессии в prod | TDD skill, CI |
| Коммит агента без msg style | Шум в истории | amend/reword (осторожно) |

---

## D. Безопасность

| Ошибка | Симптом | Recovery |
|--------|---------|----------|
| Секрет в промпте | В логах провайдера | Ротация ключа |
| Секрет в command md | Git leak | Удалить из истории, rotate |
| Prod MCP | Непредвиденный delete | Отключить MCP, audit log |
| `git push --force` main | Инцидент | Политика + beforeShell hook |

Skill: `agent-introspection-debugging` — структурированный разбор сбоя агента.

---

## E. Оркестрация

| Ошибка | Симптом | Recovery |
|--------|---------|----------|
| 2 агента, 1 файл | Merge conflict hell | Ветки, файловые границы |
| multi-execute на main | Прямой ущерб | Revert, запрет правилом |
| Субагент «придумал» API | Несуществующие методы | MCP docs, verification |

---

## Протокол recovery (универсальный)

```text
1. STOP — не accept дальше
2. git status / git diff — оценить blast radius
3. Откат: checkout / revert / новая ветка
4. Новая сессия Agent с Plan + узкий scope
5. Postmortem в 5 строк (даже solo)
6. Обновить rule/skill/hook при системной причине
```

---

## Postmortem шаблон

```markdown
## AI incident YYYY-MM-DD
- What happened:
- Impact:
- Root cause (prompt / rule / process):
- Fix applied:
- Prevention (rule/hook/training):
```

---

## «Красные флаги» в diff

- Изменения вне задачи (реформат всего проекта).
- Удаление тестов «потому что падали».
- Отключение CI/hooks (`--no-verify`).
- Новые зависимости без объяснения.
- Hardcoded credentials (даже «учебные» в prod paths).

---

## Когда отключить AI на время

- Post-incident prod до стабилизации.
- Миграция схемы БД без отката.
- Юридически чувствительный контент без policy.

Это не поражение — **risk management**.

---

## Чеклист зрелой команды

- [ ] Есть postmortem после AI-связанных инцидентов
- [ ] `.cursor/` в code review
- [ ] agent-sort при смене стека
- [ ] Секреты не в промптах (rule + scan)
- [ ] Регулярный skill-stocktake раз в квартал

---

## Завершение курса

Вы прошли путь от **нулевого** уровня до Pro-практик. Вернитесь к [00 — Карта пути](../00-karta-puti/README.md) и обновите личный план на следующие 8 недель.

---

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

1. Первый шаг при плохом diff?
2. Чем опасен accept all?
3. Когда ротировать ключ?
4. Зачем postmortem для solo?

---

## Дальше

← [Метрики](metriki-effektivnosti.md) · [Главная курса](../README.md)