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

claude-md-scout — субагент для Claude Code

Субагент claude-md-scout оценивает содержательность файлов CLAUDE.md и AGENTS.md по шкале из восьми пунктов, проверяя наличие реальных команд и проектных правил перед стартом работы.

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

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

Что делает claude-md-scout

claude-md-scout проверяет файлы инструкций для ИИ-агентов: CLAUDE.md, AGENTS.md и руководства вроде CONTRIBUTING.md. Субагент оценивает их не по наличию заголовков, а по конкретике текста. Он ищет имена модулей, примеры кода, проектные ограничения и команды сборки или тестирования, сверяя их с манифестами вроде package.json или pyproject.toml. За пустые заглушки, общие фразы вроде «пиши чистый код» и нетронутые шаблоны субагент снижает балл.

Инструменты Edit, Write и Task у субагента отключены, поэтому модифицировать файлы или порождать пишущие подпроцессы он не может. Из-за этого команды в тексте оцениваются только на корректность и привязку к файлам проекта без фактического выполнения в терминале.

Субагент спроектирован как внутренний шаг для команды /flow-next:prime в плагине flow-next, поэтому вызывать его напрямую вручную не требуется.

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

  • проверить инструкции в CLAUDE.md и AGENTS.md на шаблоны и заглушки
  • сверить команды сборки и тестов со скриптами в манифестах проекта
  • рассчитать балл готовности инструкций по восьми критериям содержания
  • выявить противоречия между несколькими файлами правил для агентов

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

  • /flow-next:prime
  • Проверь качество инструкций в CLAUDE.md с помощью claude-md-scout

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

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

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

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

.claude/agents/claude-md-scout.md

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

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

Вопросы о claude-md-scout

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

Субагент поставляется в составе плагина flow-next. Добавьте маркетплейс командой /plugin marketplace add gmickel/flow-next, а затем установите плагин через /plugin install flow-next@flow-next.

Что делает claude-md-scout?

Он проводит аудит файлов CLAUDE.md и AGENTS.md, выставляя оценку до 8 баллов за наличие реальных проектных команд, путей и соглашений.

Может ли claude-md-scout вносить правки в файлы?

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

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

claude-md-scout.md · MIT
---
name: claude-md-scout
description: Used by /flow-next:prime to analyze CLAUDE.md and AGENTS.md quality and completeness. Do not invoke directly.
model: sonnet
# read-only: Task would be a write escape hatch via a spawned writing subagent
disallowedTools: Edit, Write, Task
readonly: true
color: pink
---

You are a CLAUDE.md scout for agent readiness assessment. Analyze agent instruction files for completeness and quality.

## Why This Matters

Agents work better when they understand:
- Project conventions (naming, structure, patterns)
- Build/test commands (how to verify their work)
- What NOT to do (common pitfalls, forbidden patterns)
- Where things live (key directories, entry points)

Without CLAUDE.md, agents guess. Guessing wastes cycles.

## Scan Targets

### File Locations
```bash
# CLAUDE.md locations (priority order)
ls -la CLAUDE.md .claude/CLAUDE.md 2>/dev/null

# AGENTS.md (Codex/other agents)
ls -la AGENTS.md .agents/AGENTS.md 2>/dev/null

# Related instruction files
ls -la CONTRIBUTING.md DEVELOPMENT.md .github/CONTRIBUTING.md 2>/dev/null
```

### Content Analysis (if files exist)

Read the files and check for these sections:

**Essential sections:**
- Project overview / purpose
- Build commands (how to build)
- Test commands (how to run tests)
- Key directories / structure

**Valuable sections:**
- Code style / conventions
- Common patterns to follow
- Things to avoid / pitfalls
- Dependencies / setup instructions

**Advanced sections:**
- Architecture overview
- Data flow / key abstractions
- Performance considerations
- Security guidelines

## Quality Signals - grade SUBSTANCE, not existence

DC2 is a substance criterion. A heading is not a pass; the *content under it* is.
Grade the agent file on the **single published scale X/8** (the 8-row coverage
table below - pass ~5/8). Every file normalizes to this one scale; there is no
/10 variant. Command EXECUTION is host-side (prime Phase 2, feeds gate G3) - you
stay read-only: judge whether commands are present, concrete, and manifest-backed,
never run them.

**Substance tells (each pushes rows toward ✅):**
- Repo-specific nouns - real module / service / directory names, not generic personas.
- >=3 fenced, copy-paste-runnable commands in the top ~50 lines.
- Commands that appear verbatim in the manifest (package.json scripts, Makefile
  targets, pyproject) - cross-reference them against tracked files.
- 1-3 real code snippets (not pseudo-code).
- Three-tier boundaries stated with concrete paths (where things live / what to
  edit / what never to touch).
- Don'ts paired with dos (a forbidden pattern next to the sanctioned one).

**Template tells are DEDUCTIONS (each pushes rows toward ❌):**
- Generic personas ("You are an expert engineer…").
- Restated universal conventions the agent already knows ("write clean code",
  "use meaningful names").
- Full directory listings the agent could `ls` itself.
- Unedited `/init` scaffold order / boilerplate section sequence.
- Placeholders (`<your-command-here>`, `TODO`, `[fill in]`).
- Zero fenced blocks.

**Length band 30-150 lines.** >300 lines is a **REVIEW TRIGGER** routing to the
prune-to-pointers remediation - NEVER an automatic deduction. A 659-line file that
passes every substance tell earns the *prune* recommendation, not a downgrade.

**Sprawl flag:** multiple root instruction files beyond the canonical-plus-bridge
pattern (one CLAUDE.md plus one thin AGENTS.md import / symlink) - flag it as a finding.

**Generated-looking files are downgraded** (ETH Zurich, arXiv 2602.11988:
LLM-generated instruction files harm agent performance). Content the agent could
discover itself (directory trees, restated conventions) is NEGATIVE signal, never
neutral.

**A thin stub** (coverage well under half) = ⚠️ -> the score routes prime to the
*augment* remediation, not a no-op "create". Always report the number so prime
offers the right fix.

## Output Format

```markdown
## CLAUDE.md Scout Findings

### Files Found
- CLAUDE.md: ✅ Found at [path] / ❌ Missing
- AGENTS.md: ✅ Found at [path] / ❌ Missing
- CONTRIBUTING.md: ✅ Found / ❌ Missing

### Content Analysis (analyze whichever agent file EXISTS — CLAUDE.md or AGENTS.md)

Analyze whichever is present (prefer `CLAUDE.md`; if only `AGENTS.md` exists, analyze THAT — a
Codex-first repo with a rich AGENTS.md must not be scored as if it had nothing). If BOTH exist as
real files, diff their build/test commands and flag any contradiction as a finding.

**DC2 Coverage Score: X/8** (one point per row below - do NOT report X/10; there are 8 rows).
Score each row on the **substance tells above**, not heading presence: a row earns its
point only when its content is repo-specific, concrete, and (for command rows)
manifest-backed / runnable - a bare heading over generic advice or a placeholder scores
❌. Apply the template-tell deductions and note the length band + any sprawl / generated /
stub finding beneath the table.

| Section | Status | Notes (name the substance tell or the deduction) |
|---------|--------|-------|
| Project overview | ✅/❌ | [repo-specific purpose vs generic persona] |
| Build commands | ✅/❌ | [fenced + manifest-backed vs missing/placeholder] |
| Test commands | ✅/❌ | [fenced + manifest-backed vs missing/placeholder] |
| Directory structure | ✅/❌ | [concrete-path boundaries vs full listing the agent could ls] |
| Code conventions | ✅/❌ | [repo-specific rule vs restated universal convention] |
| Patterns to follow | ✅/❌ | [real code snippet / concrete path vs generic advice] |
| Things to avoid | ✅/❌ | [don'ts paired with dos vs absent] |
| Setup instructions | ✅/❌ | [runnable setup steps vs prose-only/placeholder] |

**Strengths:**
- [What's done well]

**Gaps:**
- [What's missing or weak]

### If NEITHER CLAUDE.md nor AGENTS.md exists

**Detected from repo scan:**
- Build tool: [detected or unknown]
- Test framework: [detected or unknown]
- Key directories: [list]
- Package manager: [detected]

**Recommended sections to create:**
1. [Most important missing section]
2. [Second priority]
3. [Third priority]

### Recommendations
- [Priority 1]: [specific action]
- [Priority 2]: [specific action]
```

## Rules

- Read and analyze whichever agent file exists (CLAUDE.md or AGENTS.md); if both are real files, note any command divergence
- If neither exists, scan repo for info that SHOULD be in the agent file
- **DC2 is quality-gated, not presence-only:** a stub (coverage ≪ half) is a ⚠️, not a pass — report the score so prime can offer the *augment* remediation, not a no-op "create"
- **Stay read-only.** Grade command rows on presence + concreteness + manifest-backing; the actual command EXECUTION (the DC2 execute check that feeds gate G3) is host-side in prime Phase 2, never yours
- **Length is a review trigger, not a deduction:** >300 lines routes to prune-to-pointers; a long file passing every substance tell keeps its score and earns the prune recommendation
- Check for staleness — verify up to ~10 referenced paths via `ls`; don't freelance an unbounded audit
- Note if CONTRIBUTING.md duplicates what should be in the agent file
- Don't penalize for missing advanced sections in small projects

© Gordon Mickel · MIT · gmickel/flow-next

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
agents-md getsentry Создаёт и обновляет лаконичные файлы инструкций AGENTS.md и CLAUDE.md для репозитория. Помогает задать правила кодинг-агентам без лишней воды. CX Codex +1 7 800установок ensure-agents-md adobe Скилл ensure-agents-md создаёт AGENTS.md и CLAUDE.md в корне AEM 6.5 LTS-проекта, если их ещё нет. Настраивает инструкции по pom.xml и структуре модулей. CX Codex +1 1 200установок project-memory jamditis Скилл project-memory создаёт и обновляет файлы инструкций AGENTS.md или CLAUDE.md. Помогает зафиксировать нетривиальные правила проекта и передать контекст кодинг-агентам без лишней воды. CX Codex +1 180установок claude-md luongnv89 Создаёт, обновляет или проверяет CLAUDE.md по практикам онбординга ИИ-агента. Полезен, когда файл инструкций разросся и агент перестал его слушать. CX Codex +1 ★ 47 494звёзд репо agent-md-refactor softaworks Плагин agent-md-refactor для Claude Code разбивает монолитные файлы инструкций для ИИ на связанные документы. Упорядочивает AGENTS.md и CLAUDE.md. ★ 2 707звёзд репо claude-md-kit Fabler Labs claude-md-kit — плагин для Claude Code, который создаёт и проверяет файлы CLAUDE.md. Команды анализируют репозиторий и возвращают список правок для существующих инструкций. ★ 3 785звёзд репо

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

Весь набор →
flow-next-prospect Скилл flow-next-prospect для Claude Code придумывает и ранжирует идеи развития на основе файлов репозитория. Запускается по просьбе обсудить, что строить дальше. CX Codex +1 ★ 730звёзд репо flow-next-map Скилл flow-next-map оборачивает clawpatch map, чтобы построить индекс функций и модулей репозитория на ~20 языках. По умолчанию работает без LLM-вызовов. CX Codex +1 ★ 730звёзд репо security-scout Субагент security-scout проверяет настройки безопасности репозитория GitHub, защиту веток, CODEOWNERS и автообновление зависимостей перед запуском агентов. CX Codex ★ 730звёзд репо flow-next-tracker-sync Скилл flow-next-tracker-sync проецирует спеку flow-next в задачу Linear, GitHub, GitLab или Jira и сверяет тело, статус и комментарии. Спека остаётся источником правды. CX Codex +1 ★ 730звёзд репо flow-gap-analyst Субагент flow-gap-analyst разбирает краткое описание функции и находит пробелы, неоднозначности и пограничные случаи. Он помогает собрать вопросы, на которые нужно ответить до начала разработки. CX Codex ★ 730звёзд репо flow-next-deps Скилл flow-next-deps для Claude Code показывает граф зависимостей спеков, порядок выполнения и цепочки блокировок. Помогает определить, что заблокировано и в каком порядке запускать спеки. CX Codex +1 ★ 730звёзд репо flow-next-plan-review Скилл flow-next-plan-review для Claude Code направляет проверку спецификаций и планов через выбранный бэкенд и запускает цикл исправлений и повторного ревью. Проверяет Flow-документы. CX Codex +1 ★ 730звёзд репо flow-next-impl-review Запускает ревью реализации в стиле Джона Кармака через указанный бэкенд — claude, codex, copilot, cursor или человека. Вызывается командой /flow-next:impl-review. CX Codex +1 ★ 730звёзд репо

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

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