Communitygithub.com

b-mendoza/validate-implementation-plan

Audita um plano de implementação quanto à rastreabilidade de requisitos, complexidade evitável, suposições arriscadas e lacunas de evidência. Use ao revisar um plano gerado por IA ou elaborado por humanos, proposta de design, esboço de implementação, detalhamento de tarefas ou plano de arquitetura, quando o usuário desejar um relatório de auditoria independente sem sobrescrever o plano original.

O que é validate-implementation-plan?

Esta skill realiza uma auditoria abrangente em planos de implementação, focando em quatro dimensões críticas: rastreabilidade de requisitos (garantindo que cada tarefa esteja vinculada a um requisito ou história de usuário), complexidade evitável (identificando over-engineering, passos redundantes ou ferramentas desnecessárias), suposições arriscadas (destacando premissas não validadas que podem comprometer o cronograma ou a qualidade) e lacunas de evidência (apontando decisões sem suporte ou riscos não documentados). É ideal para revisar planos gerados por IA, propostas de design, esboços de implementação e divisões de tarefas, gerando um relatório independente em markdown que não modifica o arquivo original. A skill é executada via Claude Code ou Cursor, utilizando o arquivo de plano fornecido como entrada. O relatório resultante inclui uma visão geral executiva, métricas quantitativas (pontuação de completude, densidade de riscos, índice de complexidade), análise detalhada de cada dimensão com recomendações priorizadas e uma seção de próximos passos. Útil para times de engenharia que desejam aumentar a qualidade dos planos antes da execução.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/b-mendoza/agent-skills/tree/main/skills/validate-implementation-plan

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que validate-implementation-plan faz?

Audita um plano de implementação quanto à rastreabilidade de requisitos, complexidade evitável, suposições arriscadas e lacunas de evidência. Use ao revisar um plano gerado por IA ou elaborado por humanos, proposta de design, esboço de implementação, detalhamento de tarefas ou plano de arquitetura, quando o usuário desejar um relatório de auditoria independente sem sobrescrever o plano original.

Instruções

  1. O usuário fornece o conteúdo de um plano de implementação (como texto ou referência a um arquivo).
  2. Execute a auditoria analisando o plano em quatro dimensões:
    • Rastreabilidade de Requisitos: Cada tarefa ou passo está vinculado a um requisito, história de usuário ou decisão documentada?
    • Complexidade Evitável: Existem passos desnecessários, over-engineering ou complexidade que poderia ser simplificada?
    • Suposições Arriscadas: O plano depende de suposições não validadas (ex.: disponibilidade de API, comportamento de terceiros, desempenho esperado)?
    • Lacunas de Evidência: Há decisões tomadas sem suporte ou riscos não documentados?
  3. Gere um relatório de auditoria em markdown com as seções abaixo. O relatório não deve modificar o arquivo do plano original.

Estrutura do Relatório de Auditoria

  1. Visão Geral (incluindo nome do plano, data da auditoria e pontuação geral de completude)
  2. Resumo Executivo (principais descobertas e recomendações em ordem de prioridade)
  3. Métricas da Auditoria (tabela com pontuações: completude geral, densidade de riscos, índice de complexidade, cobertura de evidências)
  4. Análise Detalhada (uma subseção para cada dimensão, com descobertas específicas, exemplos e recomendações acionáveis)
  5. Próximos Passos (itens de ação priorizados com base na gravidade e no esforço estimado para resolução)

Exemplo de Uso

> /skills b-mendoza/validate-implementation-plan
Forneça o conteúdo do plano de implementação que deseja auditar.

Plataformas Suportadas

  • Claude Code
  • Cursor

Notas

  • Esta skill não altera o plano original.
  • Para melhores resultados, o plano deve estar em formato markdown ou texto simples.
  • A auditoria é puramente analítica e baseada nas informações fornecidas; sempre valide as recomendações com partes interessadas do domínio.

Habilidades Relacionadas