# claude-md-scout

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

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

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

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

### Codex

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

### Cursor

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

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

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

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

## Похожие
- [agents-md](https://affpapa.org/nevibecode/skills/agents-md.md) — скилл · 7800 установок
- [ensure-agents-md](https://affpapa.org/nevibecode/skills/ensure-agents-md.md) — скилл · 1200 установок
- [project-memory](https://affpapa.org/nevibecode/skills/project-memory.md) — скилл · 180 установок
- [claude-md](https://affpapa.org/nevibecode/skills/luongnv89-claude-md.md) — скилл · ★ 47494 у репозитория
- [agent-md-refactor](https://affpapa.org/nevibecode/plugins/agent-md-refactor.md) — плагин · ★ 2707 у репозитория
- [claude-md-kit](https://affpapa.org/nevibecode/plugins/claude-md-kit.md) — плагин · ★ 3785 у репозитория

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

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

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