kissrosecicd-hub/meta-agent-recovery

Meta: Agent Recovery

Обрабатывает сбои субагентов — таймауты, зависания, каскадные отказы — и обеспечивает graceful degradation.

Типы сбоев

| Тип | Симптом | Причина | |-----|---------|---------| | Таймаут | Агент не отвечает N секунд | Задача слишком сложная, модель зависла | | JSON парсинг | InvalidParameter, function.arguments | Ответ слишком длинный, спецсимволы | | Каскадный | Агент B без данных от агента A | Агент A упал, B ожидает его результат | | Частичный | Агент ответил но не завершил | Прервался на середине задачи | | Полный | Агент вернул ошибку сразу | Неподдерживаемый subagent_type |

Стратегии восстановления

1. Таймаут → Skip & Continue

Агент не отвечает → ждать 30s → skip → продолжить с остальными →
в отчёте: "X agent skipped (timeout), results from Y agents"

Когда: Агент не критичный для результата.

2. Таймаут → Retry

Агент не отвечает → ждать 30s → повторить с упрощённым промптом →
если снова таймаут → skip

Когда: Агент важный, задача не слишком длинная.

3. Каскадный → Fallback

Агент A упал → агент B не может работать без A →
B тоже skip → main agent делает работу A сам

Когда: Критичный агент (без него весь pipeline ломается).

4. Частичный результат → Использовать

Агент начал но не закончил → взять что есть →
в отчёте: "partial result from X agent, may be incomplete"

Когда: Частичные результаты полезны (нашёл 3 из 5 проблем).

5. Полный сбой → Main agent fallback

Агент вообще не запускается → main agent берёт его роль →
читает SKILL.md → выполняет задачу сам

Когда: Агент недоступен, subagent_type не поддерживается.

Матрица решений

| Агент упал | Критичен? | Действие | |---|---|---| | code-reviewer | Да (основной аудит) | Retry → Fallback: main agent делает review | | security-auditor | Да (безопасность) | Retry → Fallback: main agent проверяет секреты | | test-architect | Нет (можно потом) | Skip → пометить «тесты написать позже» | | debugger | Зависит от бага | Если баг критичный → main agent чинит | | docs-writer | Нет | Skip → «документацию добавить позже» | | git-doctor | Нет | Skip → пользователь сделает сам |

Graceful degradation

Идеально: 4 агента → полный отчёт
Реально: 2 агента + 2 skipped → отчёт с пометками

Пользователь видит:
✅ Результаты от code-reviewer
✅ Результаты от security-auditor
⏭️ test-architect skipped (timeout)
⏭️ docs-writer skipped (cascade failure)

Вывод: «2 из 4 агентов ответили. Основные проблемы найдены.
Тесты и документация — следующий шаг отдельно.»

Правила

• Никогда не ждать вечно — таймаут 30-60s максимум
• Не терять частичные результаты — лучше неполный отчёт чем никакой
• Честно говорить пользователю — какие агенты не ответили
• Fallback на main agent — если критичный агент упал, я делаю сам
• Не спавнить заново больше 1 раза — если retry не помог, skip
• Сохранять контекст — даже если все агенты упали, результаты разведки (Explore) остаются

Отчёт о сбоях

## Agent Status

| Agent | Status | Details |
|-------|--------|---------|
| code-reviewer | ✅ Completed | 12 findings |
| security-auditor | ✅ Completed | 8 findings |
| test-architect | ⏭️ Skipped | Timeout after 60s |
| docs-writer | ⏭️ Skipped | Cascade (needs test results) |

### Recovery Actions Taken
- test-architect: retried once, still timeout → skipped
- docs-writer: cascade skip, no test context available

### What's Missing
- Test coverage assessment
- Test file generation
→ Main agent can do this separately on request