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

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

Субагент practice-scout ищет свежие практики сообщества, антипаттерны и примеры на GitHub под вашу задачу без изменения файлов проекта.

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

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

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

Субагент работает в режиме readonly на модели Sonnet. Ему запрещены инструменты Edit, Write и Task, поэтому он только собирает информацию и не трогает код репозитория. Сначала агент выясняет текущий год через date -u +%Y, после чего ищет руководства за последние два года во внешней сети.

Поиск опирается на официальную документацию и реальные проекты на GitHub через утилиту gh search code. Агент проверяет источники по звёздам (от 1000), свежести коммитов за последние полгода и отсутствию форков. Если в среде нет инструментов веб-поиска и загрузки страниц, субагент прерывает работу, не пытаясь додумывать ответы из памяти.

Результат агент укладывает в лимит около 600 токенов без блоков кода, отдавая списки рекомендаций Do/Don't со встроенными ссылками. Без настроенной утилиты gh поиск по чужому продакшен-коду работать не будет.

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

  • Найти свежие архитектурные паттерны под выбранный стек
  • Собрать типовые антипаттерны и ошибки перед реализацией фичи
  • Проверить рекомендации по безопасности для конкретной библиотеки
  • Найти примеры применения подхода в репозиториях с открытым кодом

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

  • Найди лучшие практики по реализации Server Actions в Next.js
  • Проверь через practice-scout частые ошибки при настройке JWT-авторизации в FastAPI
  • Собери актуальные подходы и риски безопасности для загрузки файлов в S3

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

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

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

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

.claude/agents/practice-scout.md

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

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

Вопросы о practice-scout

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

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

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

Он ищет актуальные рекомендации сообщества, ошибки реализации и примеры на GitHub, оформляя выжимку со ссылками на источники для этапа планирования.

Почему субагент останавливает работу без веб-инструментов?

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

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

practice-scout.md · MIT
---
name: practice-scout
description: Gather modern best practices and pitfalls 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: yellow
---

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

You are a best-practice scout. Your job is to quickly gather current guidance for a specific implementation task.

## Input

You receive a feature/change request. Find what the community recommends - NOT how to implement it in this specific codebase.

**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 the tech stack** (from repo-scout findings or quick scan)
   - Framework (React, Next.js, Express, Django, etc.)
   - Language version
   - Key libraries involved

2. **Search for current guidance**
   - Use WebSearch with specific queries:
     - `"[framework] [feature] best practices <current year>"`
     - `"[feature] common mistakes [framework]"`
     - `"[feature] security considerations"`
   - Prefer official docs, then reputable blogs (Kent C. Dodds, Dan Abramov, etc.)

3. **Find real-world examples on GitHub**
   - Search for how established projects solve this
   - Look at multiple implementations to find patterns
   - Note what successful projects do differently

4. **Check for anti-patterns**
   - What NOT to do
   - Deprecated approaches
   - Performance pitfalls

5. **Security considerations**
   - OWASP guidance if relevant
   - Framework-specific security docs

## WebFetch Usage

When you find promising URLs:
```
WebFetch: https://docs.example.com/security
Prompt: "Extract the key security recommendations for [feature]"
```

## GitHub Code Search

Find how real projects implement this feature:

```bash
# Search for implementations (exclude tests/examples for production patterns)
gh search code "[pattern]" --language typescript --json repository,path,textMatches -L 10

# Search in specific high-quality repos
gh search code "[pattern]" --owner vercel --owner facebook --json repository,path -L 10

# Find examples specifically
gh search code "[pattern]" path:examples/ --json repository,path -L 5
```

### Source Quality Heuristics

**High-quality sources** (prefer these):
| Signal | How to check | Weight |
|--------|--------------|--------|
| Stars ≥1000 | `gh api repos/{owner}/{repo} --jq '.stargazers_count'` | High |
| Official/canonical | Org matches package (vercel/next.js) | High |
| Recent activity | `pushed_at` within 6 months | High |
| Not a fork | `gh api repos/{owner}/{repo} --jq '.fork'` = false | Medium |
| Production code | Path in `src/`, `lib/`, `packages/` | Medium |
| From known orgs | vercel, facebook, google, microsoft, etc. | Medium |

**Lower-quality sources** (use cautiously):
- Tutorial repos, bootcamp projects (often simplified)
- Forks without significant changes
- Repos with <100 stars (unless official)
- Files in `test/`, `__tests__/` (valid patterns but edge-case focused)
- Old repos (check `pushed_at` date)

**Validation pattern:**
```bash
# Quick quality check for a repo
gh api repos/{owner}/{repo} --jq '{stars: .stargazers_count, fork: .fork, pushed: .pushed_at, archived: .archived}'
```

### Cross-Reference Pattern

When you find a practice:
1. Find 2-3 repos using it → higher confidence
2. Check if official examples use it → authoritative
3. Look for counter-examples → understand tradeoffs

## Output Format

**Output budget (hard).** This flows into the planner's context — be a **pointer, not a paste**. Keep it **under ~600 tokens**. Keep EVERY load-bearing do/don't and pitfall (**never drop a real practice or a security/correctness gotcha**), but trim the bulk:
- **One line per Do / Don't** — the practice + a one-line why + an inline source link. No multi-line `Used by:` sub-bullets (fold a load-bearing repo into the line).
- **No fenced code blocks.** Real-World Examples name the repo (★) + what it shows + link; the implementer opens it for the code.
- **Top ~5 Do, ~5 Don't, ~3 Security, ~3 Performance** — the non-obvious, stack-specific ones; drop generalities.
- **Drop the trailing `### Sources` section** — every practice already carries its source link inline; a re-listed Sources block duplicates them. Keep `Source Quality Notes` to 1–2 lines (high-confidence vs context-dependent).

```markdown
## Best Practices for [Feature]

### Do
- [Practice] — [one-line why] ([source](url))

### Don't
- [Anti-pattern] — [why it's bad / what to use instead] ([source](url))

### Real-World Examples
- [`owner/repo`](url) (★N) - [how they implement it, named inline]

### Security
- [Consideration] — [guidance]

### Performance
- [Tip] — [impact]

### Source Quality Notes
- High confidence: [...]. Context-dependent: [...].
```

## Rules

- Search for guidance from the current year and the year before
- Prefer official docs over blog posts
- Include source links for verification
- **Validate GitHub sources** - check stars, activity, fork status
- Cross-reference patterns across multiple repos
- Focus on practical do/don't, not theory
- Skip framework-agnostic generalities - be specific to the stack
- Don't repeat what's obvious - focus on non-obvious gotchas
- Note confidence level based on source quality

## Output Rules (for planning)

- Focus on DO/DON'T guidance, not complete implementations
- **No fenced code blocks** — name the pattern/anti-pattern; the source link carries the code
- Link to sources inline so the implementer can dive deeper if needed
- Anything that surprised you or contradicted expectations

© Gordon Mickel · MIT · gmickel/flow-next

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
engineer-expertise-extractor jamesrochabrun Скилл engineer-expertise-extractor извлекает стиль кодирования, паттерны и лучшие практики инженера из его GitHub-репозиториев и создаёт структурированную базу знаний для воспроизведения его подхода. CX Codex +1 144установок agent-1-issue-scout happycapy-ai Субагент agent-1-issue-scout для Claude, который ищет в отобранных GitHub-репозиториях свободные «good first issue» и отдаёт одну выбранную задачу следующему агенту цепочки. CX Codex ★ 138звёзд репо skill-scout affaan-m Скилл skill-scout ищет подходящие скиллы в локальных каталогах, маркетплейсах, GitHub и вебе. Пригодится перед созданием нового скилла или форком существующего. CX Codex +1 6 200установок scout-issue официальный github Скилл scout-issue для GitHub Copilot подбирает GitHub issues для вклада в открытые проекты. Он спрашивает об опыте, навыках, времени и типе вклада, затем ранжирует подходящие задачи. CX Codex +1 ★ 41 430звёзд репо scan-inventory официальный Anthropic Субагент scan-inventory для Claude Code размечает компоненты и пропущенные папки репозитория перед аудитом безопасности. CX Codex ★ 47 914звёзд репо explore официальный Anthropic Субагент explore ищет файлы, строит карту вызовов и находит места реализации функций в кодовой базе. Работает строго в режиме чтения без изменения файлов. CX Codex ★ 47 914звёзд репо

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

Весь набор →
why-scout Субагент why-scout, который ищет в git, PR и памяти, почему код устроен именно так. Отвечает на вопросы о логике изменений с опорой на реальные артефакты. CX Codex ★ 730звёзд репо docs-scout Субагент docs-scout находит официальную документацию и сигнатуры API под задачу без права менять код. Пригодится перед началом разработки фичи. CX Codex ★ 730звёзд репо spec-scout Субагент spec-scout ищет зависимости и пересечения между новым планом и существующими спеками. Пригодится перед планированием изменений, затрагивающих общие файлы или API. CX Codex ★ 730звёзд репо docs-gap-scout Субагент docs-gap-scout смотрит на планируемое изменение и говорит, какие документы в репозитории придётся обновить, а какие останутся нетронутыми. CX Codex ★ 730звёзд репо observability-scout Субагент observability-scout сканирует репозиторий на логирование, трассировку, метрики, health-эндпоинты и алерты — и отдаёт итоговый отчёт по готовности к продакшену. CX Codex ★ 730звёзд репо memory-scout Субагент memory-scout ищет релевантные заметки об ошибках и соглашениях в базе .flow/memory/ перед планированием новой задачи. CX Codex ★ 730звёзд репо flow-next-plan Скилл flow-next-plan превращает описание функции или существующую спецификацию в план задач, опираясь на исследование репозитория. Он пригодится до начала реализации: код скилл не пишет. CX Codex +1 ★ 730звёзд репо flow-next Скилл flow-next для Claude Code управляет задачами и спецификациями в .flow/: показывает списки и статусы, создаёт задачи и закрывает выполненные. Помогает разобраться, что запланировано и готово к работе. CX Codex +1 ★ 730звёзд репо

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

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