Ferramentas de Análise & Estimativa (Stream C)
As ferramentas do Stream C ajudam você a entender sua base de código, estimar esforço, detectar problemas de qualidade e manter as specs alinhadas com a realidade.
Referência Rápida
| Ferramenta | Descrição | Disponibilidade |
|---|---|---|
estimate | Calcule tempo, esforço e custo para construir uma funcionalidade | Incluída |
estimate_ai_cost | Estime os custos de tokens de IA para implementar uma spec | Incluída |
validate | Verifique quanto de um plano foi realmente construído | Incluída |
detect_drift | Detecte onde a implementação diverge de uma spec aprovada | Incluída |
validate_workflow | Valide se o fluxo de desenvolvimento corresponde ao processo pretendido | Incluída |
audit | Auditoria abrangente de configuração, arquitetura e conformidade do projeto | Incluída |
audit_stack | Analise a stack tecnológica para problemas de compatibilidade, segurança e performance | Incluída |
audit_trail | Consulte o log de auditoria imutável | Incluída |
generate_attestation | Gere um documento de atestação de conformidade para uma spec | Incluída |
reverse_engineer | Faça engenharia reversa de uma spec a partir do código existente | Incluída |
scan_project | Escaneie o projeto inteiro e analise módulos em paralelo | Incluída |
learn_pattern | Capture um padrão ou boa prática aprendida da sua base de código | Incluída |
capture_learning | Capture um padrão a partir da experiência de implementação | Incluída |
paradigm_report | Relatório sobre paradigmas e padrões arquiteturais no projeto | Incluída |
reality_check | Valide um plano contra restrições e premissas do mundo real | Incluída |
security_check | Execute uma análise de segurança abrangente na base de código e specs | Incluída |
security_report | Gere um relatório de segurança a partir do log de auditoria | Incluída |
living_spec_watch | Observe uma spec para mudanças e sincronize automaticamente com o código | Incluída |
living_spec_status | Obtenha o status da sincronização de specs vivas | Incluída |
living_spec_coverage | Mostre análise de cobertura de testes para uma spec viva | Incluída |
sync_spec_to_code | Sincronize critérios de aceitação da spec para comentários e testes no código | Incluída |
sync_code_to_spec | Sincronize mudanças do código de volta para a spec como documentação viva | Incluída |
resolve_sync_conflict | Resolva conflitos entre spec e código durante a sincronização | Incluída |
snapshot_spec_hashes | Crie um snapshot de hashes do conteúdo das specs para rastreamento de mudanças | Incluída |
auto_reconcile | Reconcilie automaticamente specs com mudanças no código usando correspondência de padrões | Incluída |
validate_annotations | Valide anotações em uma spec para correção e completude | Incluída |
generate_annotations | Gere anotações para uma spec com base em boas práticas | Incluída |
Estimativa
estimate
Calcule tempo, esforço e custo para construir uma funcionalidade com base no seu plano.
O que produz:
- Faixa de story points (otimista / realista / pessimista)
- Faixa de custo em dólares (com base no
SDD_HOURLY_RATE) - Estimativa de uso de tokens para implementação assistida por IA
- Fatores de risco que afetam a estimativa
- Detalhamento por fase de implementação
Quando usar: Antes de comprometer uma spec com um sprint, ou ao comunicar o escopo às partes interessadas.
Prompt: "Estimate spec SPEC-003 for project proj_abc123"
Prompt: "How much effort is spec SPEC-007 in project proj_abc123?"estimate_ai_cost
Estime os custos de tokens de IA para implementar uma spec — detalhado por modelo, fase e complexidade.
O que produz:
- Estimativa de contagem de tokens por fase de implementação
- Detalhamento de custos por modelo (GPT-4, Claude, etc.)
- Multiplicadores de complexidade e fatores de risco
- Comparação entre diferentes modelos de IA
Quando usar: Ao orçar o desenvolvimento assistido por IA, ou ao escolher qual modelo usar para implementação.
Prompt: "Estimate AI cost for spec SPEC-003 in project proj_abc123"Validação
validate
Verifique quanto de um plano foi realmente construído. Compara os critérios de aceitação da spec com o código real.
O que verifica:
- Quais critérios de aceitação são atendidos pelo código
- Quais estão faltando ou apenas parcialmente implementados
- Percentual geral de cobertura
- Sugestões para fechar lacunas
Quando usar: Após concluir a implementação, antes de marcar uma spec como done.
Prompt: "Validate spec SPEC-001 against the code at /workspace/my-app/src for project proj_abc123"detect_drift
Analise mudanças no código em relação a uma spec aprovada e destaque onde a implementação diverge.
O que reporta:
- Critérios que não correspondem mais ao código
- Novos padrões de código não cobertos por nenhuma spec
- Violações da Constituição introduzidas desde a última verificação
- Specs downstream afetadas pelo drift (impacto em cascata)
Quando usar: Periodicamente à medida que a base de código evolui, ou antes de qualquer release importante.
Prompt: "Detect drift in spec SPEC-003 for project proj_abc123"
Prompt: "Check if my implementation matches the SPEC-001 spec"validate_workflow
Valide se o fluxo de desenvolvimento corresponde ao processo pretendido — verifica se as transições de status das specs, os portões de revisão e as práticas da equipe seguem o fluxo de trabalho configurado.
Quando usar: Ao integrar uma nova equipe ao Planu, ou após uma mudança de processo para verificar a adoção.
Prompt: "Validate the development workflow for project proj_abc123"Auditoria
audit
Auditoria abrangente de configuração, arquitetura e conformidade do projeto. Gera uma pontuação de qualidade de 0 a 100.
Detalhamento da pontuação:
- Conformidade com os princípios SOLID
- Métricas de código limpo (nomenclatura, tamanho de funções, acoplamento)
- Conformidade com as camadas da arquitetura
- Adesão à Constituição
- Sinais de cobertura de testes
Quando usar: Durante code review, antes de merge ou como verificação periódica de saúde da base de código.
Prompt: "Audit the code at /workspace/my-app/src for project proj_abc123"audit_stack
Analise a stack tecnológica atual para problemas de compatibilidade, segurança e performance.
O que verifica:
- Compatibilidade de versões de dependências
- CVEs conhecidas e avisos de segurança
- Anti-padrões de performance na stack escolhida
- Sugestões de upgrades ou substituições
Quando usar: Durante revisões trimestrais ou antes de uma release importante para detectar riscos ocultos no grafo de dependências.
Prompt: "Audit the tech stack for project proj_abc123"audit_trail
Consulte o log de auditoria imutável. Filtre por specId, userId, eventType e intervalo de datas.
O que retorna:
- Log cronológico de todas as mudanças de specs e transições de status
- Quem acionou cada evento e quando
- Chamadas de ferramentas que produziram as mudanças
- Exportável para fins de conformidade
Quando usar: Durante auditorias de segurança, revisões de conformidade ou ao investigar uma regressão em uma spec.
Prompt: "Show the audit trail for spec SPEC-005 in project proj_abc123"
Prompt: "List all events by user alice in project proj_abc123 this month"generate_attestation
Gere um documento de atestação de conformidade para uma spec específica — confirma que todos os critérios de aceitação foram atendidos, revisados e validados.
O que produz:
- Atestação assinada com ID da spec e resumo dos critérios
- Timestamp da execução da validação
- Percentual de cobertura e quaisquer exceções abertas
- Pronto para inclusão em pacotes de conformidade
Quando usar: Quando uma spec deve passar por uma revisão formal de conformidade antes do release (SOC 2, HIPAA, ISO 27001, etc.).
Prompt: "Generate an attestation for spec SPEC-010 in project proj_abc123"Engenharia Reversa & Varredura
reverse_engineer
Faça engenharia reversa de uma spec a partir do código existente.
Quando usar: Quando você tem código funcional mas sem spec — comum ao integrar sistemas legados, ou quando uma funcionalidade foi construída de forma ad-hoc e agora precisa de documentação formal.
O que produz: Um spec.md completo obtido por engenharia reversa do código — critérios de aceitação inferidos do comportamento da implementação, schema inferido dos modelos de dados e lacunas identificadas onde o comportamento é ambíguo.
Prompt: "Reverse engineer my codebase at /workspace/my-app/src/auth and generate specs for project proj_abc123"scan_project
Escaneie o projeto inteiro, descubra módulos, analise cada um em paralelo e detecte dependências e anti-padrões entre módulos.
O que produz:
- Mapa de módulos com grafo de dependências
- Preocupações transversais e problemas de acoplamento
- Detecção de anti-padrões (God objects, deps circulares, abstrações vazias)
- Lacunas de cobertura de specs por módulo
Quando usar: Ao integrar uma base de código grande e desconhecida, ou antes de uma grande refatoração.
TIP
scan_project é a maneira mais rápida de entender uma base de código existente. Execute-o antes de criar qualquer spec em um projeto legado.
Prompt: "Scan the project at /workspace/my-app for proj_abc123"Aprendizado
learn_pattern
Capture um padrão ou boa prática aprendida da sua base de código para reutilização em specs futuras.
Tipos de padrão: architecture, convention, estimation, stack, quality
Quando usar: Quando sua equipe estabeleceu um padrão que o Planu deve aplicar ao gerar specs, planos ou estimativas.
Prompt: "Teach planu that we always use repository pattern for database access in project proj_abc123"
Prompt: "Add an estimation pattern: API integrations always take 2x longer than expected for project proj_abc123"capture_learning
Capture um padrão aprendido ou oportunidade de melhoria a partir da experiência de implementação — com deduplicação semântica.
Quando usar: Após um post-mortem de bug, um erro doloroso de estimativa ou qualquer descoberta de fluxo de trabalho que você queira aplicar a specs futuras.
O Planu deduplica em relação a padrões existentes para que você não acumule regras redundantes.
Prompt: "Capture learning: when integrating third-party OAuth, always verify token expiry handling with an explicit test"paradigm_report
Gere um relatório sobre paradigmas e padrões arquiteturais no projeto — funcional, OOP, reativo, orientado a eventos, declarativo, etc.
Quando usar: Ao integrar uma base de código desconhecida, ou ao estabelecer padrões de código que devem ser aplicados nas specs.
Prompt: "Generate a paradigm report for project proj_abc123"reality_check
Valide um plano contra restrições e premissas do mundo real.
O que avalia:
- Viabilidade técnica dada a stack atual
- Restrições de dependências
- Realismo do cronograma com base em estimativas históricas
- Riscos que podem bloquear a entrega
Quando usar: Antes de se comprometer com um prazo, ou quando uma parte interessada solicita algo que parece irrealista.
Prompt: "Reality check: can we build a real-time collaborative editor in 2 weeks for project proj_abc123?"Segurança
security_check
Execute uma análise de segurança abrangente na base de código e specs — OWASP Top 10, padrões inseguros e uma pontuação de segurança (A–F) com detecção de drift.
O que verifica:
- Vulnerabilidades de injeção (SQL, comandos, LDAP)
- Autenticação e gerenciamento de sessões
- Exposição de dados sensíveis
- Problemas de controle de acesso
- Má configuração de segurança
Quando usar: Antes de qualquer spec envolvendo autenticação, autorização, pagamentos ou dados de usuários.
Prompt: "Run a security check on spec SPEC-005 for project proj_abc123"
Prompt: "Security audit the code at /workspace/my-app/src/api for project proj_abc123"security_report
Gere um relatório de segurança a partir do log de auditoria — mostra ameaças, chamadas bloqueadas e recomendações.
O que produz:
- Resumo dos eventos de segurança do log de auditoria
- Ameaças detectadas e bloqueadas
- Vulnerabilidades abertas classificadas por severidade
- Recomendações de remediação
Quando usar: Para revisões periódicas de segurança, pacotes de conformidade ou após um incidente de segurança.
Prompt: "Generate a security report for project proj_abc123"Specs Vivas
As specs vivas permanecem sincronizadas com o seu código automaticamente. As ferramentas abaixo gerenciam essa sincronização bidirecional.
living_spec_watch
Observe uma spec para mudanças e sincronize automaticamente com o código à medida que a implementação evolui.
Quando usar: Durante a implementação ativa de uma spec para manter o documento da spec atualizado sem reconciliação manual.
Prompt: "Start watching spec SPEC-007 in project proj_abc123"living_spec_status
Obtenha o status da sincronização de specs vivas — mostra quais specs estão sendo observadas e seu último timestamp de sincronização.
Prompt: "Show living spec status for project proj_abc123"living_spec_coverage
Mostre análise de cobertura de testes para uma spec viva — mapeia arquivos de teste para critérios de aceitação.
Quando usar: Para verificar se todos os critérios em uma spec viva têm testes correspondentes antes de marcá-la como done.
Prompt: "Show living spec coverage for SPEC-007 in project proj_abc123"sync_spec_to_code
Sincronize critérios de aceitação da spec para comentários e testes no código — injeta referências de critérios como comentários estruturados nos arquivos de implementação.
Quando usar: No início da implementação para dar ao agente de IA (ou desenvolvedor) um link claro entre código e critérios.
Prompt: "Sync spec SPEC-007 criteria to the code in project proj_abc123"sync_code_to_spec
Sincronize mudanças do código de volta para a spec como documentação viva — atualiza a spec para refletir o que o código realmente faz.
Quando usar: Após a implementação divergir da spec original de maneiras que devem ser capturadas como a nova verdade.
Prompt: "Sync code changes back to spec SPEC-007 in project proj_abc123"resolve_sync_conflict
Resolva conflitos entre spec e código durante a sincronização — apresenta cada conflito para decisão humana.
Quando usar: Quando sync_spec_to_code ou sync_code_to_spec detecta contradições que requerem julgamento humano.
Prompt: "Resolve sync conflicts for spec SPEC-007 in project proj_abc123"snapshot_spec_hashes
Crie um snapshot de hashes do conteúdo das specs para rastreamento de mudanças — permite comparar o conteúdo das specs ao longo do tempo.
Quando usar: Antes de uma grande refatoração ou release para estabelecer uma linha de base para detecção de drift.
Prompt: "Snapshot spec hashes for project proj_abc123"auto_reconcile
Reconcilie automaticamente specs com mudanças no código usando correspondência de padrões — aplica regras de reconciliação aprendidas sem intervenção humana.
Quando usar: Como parte de uma etapa de CI para manter as specs alinhadas após cada merge.
Prompt: "Auto-reconcile all specs in project proj_abc123"validate_annotations
Valide anotações em uma spec para correção e completude — verifica se referências de critérios, links de arquivos e metadados são válidos.
Prompt: "Validate annotations for spec SPEC-007 in project proj_abc123"generate_annotations
Gere anotações para uma spec com base em boas práticas — adiciona metadados estruturados, referências de critérios e links de rastreabilidade.
Prompt: "Generate annotations for spec SPEC-007 in project proj_abc123"Veja Também
- Ferramentas de Ciclo de Vida de Specs (Stream B) — criar, atualizar e gerenciar specs
- Ferramentas de Design & Planejamento (Stream D) — decisões de arquitetura, schemas, planos de execução
- Ferramentas de Plataforma & Operações (Streams E–I) — stack, agentes, git, governança