# gsd-doc-verifier

Субагент gsd-doc-verifier проверяет факты из проектной документации по кодовой базе и формирует отчёт в JSON. Помогает находить битые пути, устаревшие функции и неверные команды.

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

## Что делает

gsd-doc-verifier анализирует Markdown-файлы и сопоставляет факты с реальным кодом в проекте. Субагент находит относительные пути к файлам, маршруты API вроде GET или POST, имена экспортируемых функций, вызовы пакетных менеджеров и объявленные зависимости.

Проверка выполняется без запуска сторонних скриптов. Субагент использует только чтение файлов и поиск по коду через инструменты Read и Grep. Вызовы команд из документации не исполняются в терминале: для них проверяются секции scripts и dependencies внутри `package.json`. Если файл `package.json` в корне проекта не найден, проверки по нему получают статус пропуска, а не ошибки.

Итоговый результат записывается в структурированный JSON-файл с указанием строк и несовпадений. Оркестратор процесса получает лишь короткую строку подтверждения. Блоки с примерами кода, пути с шаблонами плейсхолдеров и комментарии с разметкой `<!-- VERIFY: ... -->` субагент игнорирует.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/gsd/agents/gsd-doc-verifier.md

## Когда брать
- Сверить пути к файлам из проектной документации с реальным репозиторием
- Найти несуществующие маршруты API в техническом описании
- Проверить наличие экспортируемых функций в исходных файлах
- Убедиться в наличии упомянутых npm-скриптов и библиотек в package.json

## Примеры запросов агенту
- Выполни проверку всех утверждений и путей в файле docs/api.md с помощью субагента gsd-doc-verifier
- Сверь список функций, зависимостей и эндпоинтов в документации docs/setup.md с кодом проекта
- Запусти субагента gsd-doc-verifier для поиска несуществующих путей к файлам в документации docs/architecture.md

## Похожие
- [code-verifier](https://affpapa.org/nevibecode/agents/code-verifier.md) — субагент · ★ 720 у репозитория
- [doc-updater](https://affpapa.org/nevibecode/agents/doc-updater.md) — субагент · ★ 880 у репозитория
- [design-doc-mermaid](https://affpapa.org/nevibecode/skills/design-doc-mermaid.md) — скилл · 101800 установок
- [doc-forge](https://affpapa.org/nevibecode/plugins/doc-forge.md) — плагин · ★ 2858 у репозитория
- [doc-scraper](https://affpapa.org/nevibecode/mcp/doc-scraper.md) — MCP-сервер · ★ 110 у репозитория
- [gsd-extract-learnings](https://affpapa.org/nevibecode/skills/gsd-extract-learnings.md) — скилл · 577 установок

Из того же набора: [davepoon/buildwithclaude](https://affpapa.org/nevibecode/by/davepoon/buildwithclaude.md) — 235 карточек

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

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