Plan Audit — Auditor de Planos Técnicos
Avalon-27reg/claude-skill-plan-audit
Audita e refina planos técnicos com dupla-verificação e busca de práticas GitHub
Ver no GitHubSkill para Claude Code que audita planos técnicos em dois passes (Realista + Visionário com busca GitHub), valida atualidade, aplica correções autonomamente e processa pastas inteiras em modo batch. Transforma planos brutos em artefatos prontos para execução por agentes.
Instalação
npx convez-ai Avalon-27reg/claude-skill-plan-audit1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Validar planos de implementação antes de delegar a agentes
- Encontrar conflitos, migrações duplicadas e inconsistências de segurança
- Pesquisar práticas da indústria e repositórios GitHub para fundamentar decisões de arquitetura
- Processar pastas inteiras de planos com triagem e arquivamento automático
- Aplicar melhorias de forma autônoma com verificação adversarial
Veredito

Skill sofisticado e bem arquitetado para equipes que trabalham com Claude Code em escala. O modelo de dois agentes (Realista + Visionário) é robusto; a aplicação autônoma com verificação adversarial minimiza risco. Exige contexto de projeto estabelecido e convenções claras para máxima efetividade — não é para planos únicos ocasionais.
README
A tradução para o português deste README ainda está na fila.
plan-audit — скилл аудита технических планов для Claude Code
Берёт готовый, но не вылизанный технический план и доводит его до состояния «можно отдать на исполнение отдельному агенту» — силами нескольких под-агентов, с самопроверкой и автономным внесением правок прямо в файл.
Скилл (skill) для Claude Code / Claude Agent SDK. Универсальный — подстраивается под конвенции любого проекта.
Что делает
Аудирует план в два прохода разными под-агентами и сам вносит улучшения:
- Гейт актуальности. Сначала проверяет, не сделан ли план уже — целиком, частично, или не вошёл ли он в другой план. Готовое не аудирует, а отправляет в архив.
- Проход 1 «Реалист». По каждой фазе: решает ли реальную проблему, реализуемо ли, безопасно ли в проде, совпадает ли с настоящим кодом, свободны ли номера миграций, нет ли конфликтов между фазами.
- Проход 2 «Визионер». Доказывает, что план — лучшее решение из существующих, или находит лучше: ищет практики в индустрии и на GitHub (с оценкой пригодности — свежесть, поддержка, лицензия, совпадение со стеком).
- Автономное применение с самопроверкой. Находки под-агентов основной агент адверсариально перепроверяет (факт верен? не ломает план? реально улучшение?) и применяет прямо в файл. Бэкап — единственный путь отката. Пользователю — итоговая сводка постфактум.
- Пакетный режим. Если плана не назвали — дёшево триажит всю папку планов параллельно, мёртвые/поглощённые уносит в архив, а живые пускает на глубокий аудит.
Установка
Скилл — это папка plan-audit/ с файлом SKILL.md внутри. Скопируй её в каталог скиллов:
Глобально (во всех проектах):
git clone https://github.com/<you>/claude-skill-plan-audit.git
cp -r claude-skill-plan-audit/plan-audit ~/.claude/skills/
Только в одном проекте:
cp -r claude-skill-plan-audit/plan-audit <ваш-проект>/.claude/skills/
Перезапусти сессию Claude Code, чтобы скилл подхватился.
Как пользоваться
Скилл срабатывает на естественные фразы — называть его явно не нужно:
| Фраза | Что произойдёт |
|---|---|
«проверь план plans/2026-...md» | Полный аудит одного плана |
| «актуализируй план», «сделай план идеальным» | То же — по конкретному плану |
| «наведи порядок в планах», «проверь все планы» | Пакетный триаж всей папки + аудит живых |
/plan-audit <путь> / /plan-audit без пути | Явный вызов: один план / все планы |
Если хочешь сначала увидеть правки до применения — просто скажи об этом: автономность это поведение по умолчанию, а не запрет на диалог.
Как устроено
plan-audit/
├── SKILL.md # точка входа: режимы, этапы, как применять правки
└── references/
├── discovery.md # как определить конвенции любого проекта
├── batch-triage.md # пакетный режим: сортировка всей папки планов
├── agent-realist.md # промт прохода 1 (правильность/безопасность)
├── agent-vizioner.md # промт прохода 2 (индустрия + GitHub)
└── readiness-checklist.md # чек-лист «план готов к исполнению»
Прогрессивное раскрытие: SKILL.md всегда в контексте, тяжёлые детали — в references/, читаются по мере надобности.
Язык
Скилл и его отчёты — на русском.
Лицензия
MIT.