validate-implementation-plan — скилл для Claude Code: аудит планов
Проверяет архитектурные планы на избыточную сложность и сомнительные допущения. Формирует отдельный отчёт, не изменяя исходный документ.
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a claude-codeЧто делает validate-implementation-plan
Скилл координирует проверку технических планов и архитектурных декомпозиций. Исходный файл плана считается ненадёжным вводом. Напрямую к PLAN_PATH обращается только субагент plan-snapshotter. Остальные этапы работают с изолированным слепком и проверенными фактами. Исходный документ остаётся без правок.
Пайплайн запускает субагентов через строгий конечный автомат. Экстрактор нумерует требования. Аудиторы проверяют трассируемость и выявляют спекулятивный код по принципу YAGNI. При сбоях предусмотрено до трёх повторных циклов для проблемной ветки. Отчёт сохраняется в файле с суффиксом .audit.md.
Внешние веб-страницы скилл не принимает как доказательство. Технический анализ сверяется строго с локальной кодовой базой и переданным контекстом. Для старта обязательны путь к плану PLAN_PATH и базовая цель ORIGIN_CONTEXT.
Какие задачи решает
- проверить архитектурный план на преждевременную сложность
- сопоставить шаги декомпозиции с исходным перечнем требований
- выявить шаткие технические допущения до написания кода
- получить изолированный отчёт проверки без перезаписи исходного плана
Примеры запросов агенту
- Проверь план docs/cache-refactor-plan.md с контекстом "Добавить инвалидацию кэша без новой инфраструктуры"
- Проведи аудит декомпозиции docs/feature-plan.md и запиши отчёт в docs/feature-audit.md
- Выполни проверку плана docs/migration.md с учётом требований из docs/requirements.md
Как установить validate-implementation-plan
1Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a claude-code2Вручную: положить файлы
~/.claude/skills/validate-implementation-plan/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/validate-implementation-plan/
1Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a codex2Вручную: положить файлы
.agents/skills/validate-implementation-plan/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a cursor2Вручную: положить файлы
.cursor/skills/validate-implementation-plan/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install b-mendoza/agent-skills validate-implementation-plan2Вручную: положить файлы
.github/skills/validate-implementation-plan/SKILL.md1Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a gemini-cli2Командой платформы
gemini skills install https://github.com/b-mendoza/agent-skills --path skills/validate-implementation-planВручную: положить файлы
.devin/skills/validate-implementation-plan/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о validate-implementation-plan
Как установить validate-implementation-plan в Claude Code?
Выполните команду npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a claude-code. Скилл установится по пути ~/.claude/skills/validate-implementation-plan/SKILL.md.
Что делает validate-implementation-plan?
Он пропускает план через цепочку специализированных субагентов, оценивая требования, лишний код и рискованные гипотезы. Итогом становится отдельный отчёт с разбивкой находок по критичности.
Перезаписывает ли скилл исходный файл плана?
Нет, исходный документ не меняется. Скилл создаёт изолированный слепок и пишет результат в отдельный файл, по умолчанию добавляя суффикс .audit.md.
