# observability-scout

Субагент observability-scout сканирует репозиторий на логирование, трассировку, метрики, health-эндпоинты и алерты — и отдаёт итоговый отчёт по готовности к продакшену.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 730 у репозитория
- Автор: Gordon Mickel
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/gmickel/flow-next/tree/HEAD/plugins/flow-next/agents/observability-scout.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/observability-scout

## Что делает

Субагент проверяет шесть пунктов: структурированное логирование (winston, pino, structlog, zap и аналоги), распределённую трассировку через OpenTelemetry и заголовки типа `traceparent`, метрики (Prometheus, Datadog, NewRelic, StatsD), сервисы отслеживания ошибок (Sentry, Bugsnag, Rollbar), health-эндпоинты вроде `/health` и `/ready`, а также конфигурацию алертов PagerDuty или OpsGenie. По каждому пункту он отдаёт статус «настроено / не найдено» и общий счёт X/6.

Поиск идёт рекурсивно по манифестам `package.json`, `pyproject.toml`, `go.mod` во всех вложенных workspace, с исключением `node_modules`, чтобы не путать монорепозитории с одноуровневым `apps/*` или `packages/*`. Если в корне сканирования нет ни `.git`, ни `package.json`, ни `pyproject.toml`, ни `go.mod`, он сообщает о неубедительном сканировании вместо ложного 0/6.

Запускается только из команды `/flow-next:prime` — вызывать его напрямую не предполагается. Инструменты `Edit`, `Write` и `Task` ему недоступны: он читает код, но ничего не меняет и предложений по исправлению не делает.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add gmickel/flow-next
```
В чате агента (не в терминале):
```text
/plugin install flow-next@flow-next
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/observability-scout.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/observability-scout.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/observability-scout.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gmickel/flow-next/tree/HEAD/plugins/flow-next/agents/observability-scout.md

## Когда брать
- проверить, настроено ли логирование, трассировка и метрики перед релизом
- найти, подключены ли Sentry, Bugsnag или Rollbar
- обнаружить health-эндпоинты и конфиги Docker HEALTHCHECK, k8s probes
- собрать единый отчёт о готовности проекта к мониторингу в продакшене
- отличить монорепозиторий без observability от ошибки сканирования не того каталога

## Примеры запросов агенту
- Запусти /flow-next:prime и проверь готовность проекта к продакшену
- Проверь, настроены ли логирование и трассировка в этом репозитории через observability-scout

## Похожие
- [sentry-instrumentation-guide](https://affpapa.org/nevibecode/skills/sentry-instrumentation-guide.md) — скилл · 1300 установок
- [python-observability](https://affpapa.org/nevibecode/skills/python-observability.md) — скилл · 11547 установок
- [observability-monitoring-monitor-setup](https://affpapa.org/nevibecode/skills/observability-monitoring-monitor-setup.md) — скилл · ★ 50109 у репозитория
- [monitoring-observability](https://affpapa.org/nevibecode/skills/travisjneuman-monitoring-observability.md) — скилл · 146 установок
- [net-observability](https://affpapa.org/nevibecode/skills/net-observability.md) — скилл · 1 установка
- [observability-monitoring](https://affpapa.org/nevibecode/skills/aiskillstore-observability-monitoring.md) — скилл · 1 установка

Из того же набора: [gmickel/flow-next](https://affpapa.org/nevibecode/by/gmickel/flow-next.md) — 70 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
