# spec-scout

Субагент spec-scout ищет зависимости и пересечения между новым планом и существующими спеками. Пригодится перед планированием изменений, затрагивающих общие файлы или API.

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

## Что делает

spec-scout сопоставляет запрос на новую функцию с открытыми спеками: проверяет их область работ, файлы, API, структуры данных и критерии приёмки. Также смотрит задачи со статусами `in_progress` и `todo`, чтобы заметить конкретные пересечения. Для незавершённой работы на других ветках он читает копии спек и указывает ветку.

Субагент выдаёт связи по категориям: зависимости нового плана, обратные зависимости и возможные конфликты. Несвязанные спеки сводит к числу, а для такого вывода указывает, что именно проверил. Результат предназначен для планировщика, который может автоматически задать зависимости.

Режим только для чтения: `Edit`, `Write` и `Task` запрещены. Для просмотра спек нужен `flowctl`; если его версия не принимает `--refs`, проверка продолжится только по списку открытых спек.

## Установка

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

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

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

### Codex

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

### Cursor

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

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

## Когда брать
- найти спеку, чьи API нужны новому плану
- проверить, какие спеки затрагивают те же файлы
- обнаружить обратную зависимость от планируемой инфраструктуры
- сверить текущие задачи на пересечения

## Примеры запросов агенту
- Проверь, какие открытые спеки зависят от API, нужного для новой авторизации.
- Найди пересечения плана обновления схемы с существующими спеками и задачами.
- Проверь незавершённые спеки на других ветках и укажи связанные изменения.

## Похожие
- [to-spec](https://affpapa.org/nevibecode/skills/to-spec.md) — скилл · 715388 установок
- [implement-spec](https://affpapa.org/nevibecode/skills/implement-spec.md) — скилл · 283700 установок
- [huawei-cloud-billing-scout](https://affpapa.org/nevibecode/skills/huawei-cloud-billing-scout.md) — скилл · 18500 установок
- [podcast-trend-scout](https://affpapa.org/nevibecode/agents/podcast-trend-scout.md) — субагент · 370 установок
- [emblem-memecoin-scout](https://affpapa.org/nevibecode/skills/emblem-memecoin-scout.md) — скилл · 8700 установок
- [skill-scout](https://affpapa.org/nevibecode/skills/skill-scout.md) — скилл · 6200 установок

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

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

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