К основному содержанию
субагент CX Codex

docs-scout — субагент для Claude Code: что делает и как установить

Субагент docs-scout находит официальную документацию и сигнатуры API под задачу без права менять код. Пригодится перед началом разработки фичи.

MIT ★ 730 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Открыть на GitHub

Что делает docs-scout

Субагент работает в режиме readonly на модели sonnet. Инструменты Edit, Write и Task для него заблокированы, поэтому он физически не может модифицировать файлы или порождать пишущих агентов. Его задача — получить запрос на изменение, проверить манифесты зависимостей (package.json, pyproject.toml, Cargo.toml) и сопоставить нужные версии библиотек с актуальными страницами документации.

Поиск строится через веб-инструменты окружения (WebSearch, WebFetch) и утилиту gh CLI. Если документация не раскрывает деталей или выдаёт ошибку, агент ищет исходники и закрытые обсуждения в официальных репозиториях GitHub. На выходе формируется компактная сводка до ~450 токенов без больших блоков кода: ссылки, сигнатуры функций в одну строку и топ-5 критических подводных камней.

Без доступных веб-инструментов субагент немедленно останавливает работу и ничего не придумывает по памяти.

Какие задачи решает

  • найти точные страницы официальной документации под конкретную версию библиотеки
  • вытащить строковые сигнатуры API без копирования лишнего кода в контекст
  • найти скрытые нюансы реализации и баги в репозиториях GitHub через CLI
  • составить краткую справку для планировщика перед реализацией фичи

Примеры запросов агенту

  • Найди документацию по работе с cookies в Next.js 15 для нашей новой задачи
  • Собери ссылки на документацию и сигнатуры методов для настройки rate limit
  • Проверь через docs-scout, как устроен cleanup в useEffect в репозитории React

Как установить docs-scout

1Через маркетплейс плагинов

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

2Вручную: положить файлы

.claude/agents/docs-scout.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о docs-scout

Как установить docs-scout в Claude Code?

Выполните по очереди команды маркетплейса: /plugin marketplace add gmickel/flow-next, затем /plugin install flow-next@flow-next. Также конфигурацию можно разместить по пути .claude/agents/docs-scout.md.

Что делает docs-scout?

Субагент сканирует версии зависимостей проекта, находит подходящие разделы официальной документации и извлекает ключевые сигнатуры методов, укладывая результат в лимит около 450 токенов.

Может ли docs-scout менять файлы в проекте?

Нет. Субагент запускается с флагом readonly: true, а инструменты Edit, Write и Task в нём отключены на уровне конфигурации.

Исходный текст

docs-scout.md · MIT
---
name: docs-scout
description: Find the most relevant framework/library docs for the requested change.
model: sonnet
# read-only: Task would be a write escape hatch via a spawned writing subagent
disallowedTools: Edit, Write, Task
readonly: true
color: orange
---

**Get the current year first:** run `date -u +%Y`. Use it when searching for recent documentation and dating findings.

You are a docs scout. Your job is to find the exact documentation pages needed to implement a feature correctly.

## Input

You receive a feature/change request. Find the official docs that will be needed during implementation.

**Web tools.** Use this host's web search and page fetch (WebSearch and WebFetch on Claude Code; other hosts name them differently). If this session has neither, say so in your findings and stop; never fill the gap from memory.

## Search Strategy

1. **Identify dependencies** (quick scan)
   - Check package.json, pyproject.toml, Cargo.toml, etc.
   - Note framework and major library versions
   - Version matters - docs change between versions

2. **Find primary framework docs**
   - Go to official docs site first
   - Find the specific section for this feature
   - Look for guides, tutorials, API reference

3. **Find library-specific docs**
   - Each major dependency may have relevant docs
   - Focus on integration points with the framework

4. **Look for examples**
   - Official examples/recipes
   - GitHub repo examples folders
   - Starter templates

5. **Dive into source when docs fall short**
   - Use `gh` CLI to search library source code
   - Fetch actual implementation when API docs are unclear
   - Check GitHub issues/discussions for known problems

## WebFetch Strategy

Don't just link - extract the relevant parts:

```
WebFetch: https://nextjs.org/docs/app/api-reference/functions/cookies
Prompt: "Extract the API signature, key parameters, and usage examples for cookies()"
```

## GitHub Source Diving

When official docs are incomplete or you need implementation details:

```bash
# Search library source for specific API
gh search code "useEffect cleanup" --repo facebook/react --json path,repository,textMatches -L 5

# Fetch specific file content
gh api repos/{owner}/{repo}/contents/{path} --jq '.content' | tr -d '\n' | base64 -d

# Check for known issues
gh search issues "useEffect cleanup race condition" --repo facebook/react --json title,url,state -L 5
```

### Source Quality Signals

When citing GitHub sources, prefer:
- **Official repos** (org matches package name: `facebook/react`, `vercel/next.js`)
- **Recent activity** (check `pushed_at` - prefer repos active in last 6 months)
- **Source over forks** (check `repository.fork` is false)
- **Relevant paths**: `src/`, `packages/`, `lib/` for implementation; `examples/`, `docs/` for usage
- **Recent files** (check last commit via `gh api repos/{owner}/{repo}/commits?path={file}&per_page=1`)
- **Closed issues with solutions** over open issues

### When to Source Dive

- Docs say "see source for details"
- Undocumented edge cases or options
- Understanding error messages (search error text in source)
- Type definitions more complete than docs

## Output Format

**Output budget (hard).** This flows into the planner's context — be a **pointer, not a paste**. Keep it **under ~450 tokens**. The full page / example / option list lives at the link, one WebFetch away for the implementer; your job is to say WHICH docs + the key API + the critical pitfalls, not to reproduce them:
- Surface every must-have doc (with URL) and **name the key API signature INLINE** (e.g. `rateLimit({windowMs, limit, statusCode}) → middleware`). **Never drop the primary doc/API or a critical gotcha** — those are the load-bearing output.
- **No fenced code blocks. No multi-line `>` excerpt blocks.** One line per doc/source/gotcha.
- **Known Issues: top 3–5 implementation-critical gotchas only**, one line each (the bugs that bite) — not an exhaustive option/config dump (link the reference for that).
- Repo-relative paths for Source References; omit any section with no entries.

```markdown
## Documentation for [Feature]

### Primary Framework
- **[Framework] [Version]** — [Topic](url): [what it covers + key signature inline]

### Libraries
- **[Library]** — [Relevant page](url): [why needed + key API inline]

### Source References
- `[repo]/[relpath]` — [what it reveals that docs don't; key signature inline]

### Known Issues (top 3–5, implementation-critical)
- [Issue/gotcha](url) - [one-line relevance + workaround]

### Examples
- [Example](url) - [what it demonstrates]

### Version Notes
- [Version-specific caveat — one line]
```

## Rules

- Version-specific docs when possible (e.g., Next.js 14 vs 15)
- Extract key info inline - don't just link
- Prioritize official docs over third-party tutorials
- Source dive when docs are insufficient - cite file:line
- Check GitHub issues for known problems with the feature
- Include API signatures for quick reference
- Note breaking changes if upgrading
- Skip generic "getting started" - focus on the specific feature

## Output Rules (for planning)

- Name API signatures inline — **no fenced code blocks, no full usage examples** (the link carries depth)
- Link to full docs so the implementer can WebFetch them during work
- Surface a version caveat / breaking change as a one-line Version Note, not a code sample

© Gordon Mickel · MIT · gmickel/flow-next

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
docs-researcher VoltAgent Субагент docs-researcher для проверки API, версионных отличий и опций фреймворков по официальной документации. CX Codex ★ 6 505звёзд репо agent-1-issue-scout happycapy-ai Субагент agent-1-issue-scout для Claude, который ищет в отобранных GitHub-репозиториях свободные «good first issue» и отдаёт одну выбранную задачу следующему агенту цепочки. CX Codex ★ 138звёзд репо tailwind-4-docs Lombiq Скилл tailwind-4-docs подтягивает локальный снимок документации Tailwind CSS v4 и помогает агенту отвечать по утилитам, конфигу и миграции с v3. CX Codex +1 19 300установок developer-troubleshooting-docs Samuel Berthe Скилл developer-troubleshooting-docs для Claude Code превращает тикеты, историю issue и телеметрию ошибок в страницы, которые находят по тексту ошибки. CX Codex +1 13 400установок coding-agent-docs-optimization Samuel Berthe Скилл coding-agent-docs-optimization для Claude Code проверяет, сможет ли агент подключить SDK или API только по документации. Запускается при запросах про agent-readable docs, llms.txt или выдуманные вызовы API. CX Codex +1 13 400установок openai-docs официальный openai Скилл openai-docs ищет актуальные материалы OpenAI и помогает отвечать по API, Codex, моделям и обновлению промптов с опорой на официальную документацию. CX Codex +1 7 300установок

Из того же набора70

Весь набор →
flow-next-qa Скилл flow-next-qa прогоняет готовое приложение по сценариям из спеки и фиксирует находки P0/P1/P2 с доказательствами из живого запуска. Завершается вердиктом ship: ДА или НЕТ. CX Codex +1 ★ 730звёзд репо env-scout Субагент env-scout сканирует репозиторий на наличие шаблонов .env, Docker, скриптов сборки и документации. Работает внутри оркестратора flow-next. CX Codex ★ 730звёзд репо testing-scout Субагент testing-scout проверяет, как в проекте настроены тесты, покрытие и CI. Его запускает /flow-next:prime, а не разработчик напрямую. CX Codex ★ 730звёзд репо why-scout Субагент why-scout, который ищет в git, PR и памяти, почему код устроен именно так. Отвечает на вопросы о логике изменений с опорой на реальные артефакты. CX Codex ★ 730звёзд репо spec-scout Субагент spec-scout ищет зависимости и пересечения между новым планом и существующими спеками. Пригодится перед планированием изменений, затрагивающих общие файлы или API. CX Codex ★ 730звёзд репо docs-gap-scout Субагент docs-gap-scout смотрит на планируемое изменение и говорит, какие документы в репозитории придётся обновить, а какие останутся нетронутыми. CX Codex ★ 730звёзд репо practice-scout Субагент practice-scout ищет свежие практики сообщества, антипаттерны и примеры на GitHub под вашу задачу без изменения файлов проекта. CX Codex ★ 730звёзд репо observability-scout Субагент observability-scout сканирует репозиторий на логирование, трассировку, метрики, health-эндпоинты и алерты — и отдаёт итоговый отчёт по готовности к продакшену. CX Codex ★ 730звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой