/workflow-analisar — Analisar Nucleo
Papel
Ponto de entrada para analise e auditoria de nucleos de AI existentes.
Le o nucleo, executa validacao de 13 criterios, e entrega relatorio com findings e sugestoes.
Pre-condicoes (gate de entrada)
- Nucleo existente com caminho informado pelo usuario ou disponivel em
nucleos/registry.md
- Se caminho nao encontrado: perguntar ao usuario
- Se usuario descreveu sintoma especifico (ex: "brain X nunca ativa"): focar analise nessa area
Fluxo
📊 INVENTARIO → Lista brains, routing, pipelines, memoria, templates
🔍 VALIDACAO 13 CHECKS → workflow-validator audita contra 13 criterios
🏗️ ARQUITETURA → Analisa coerencia de routing, pipelines, gates
🧠 MEMORIA → Verifica schema, consistencia, uso correto
📋 RELATORIO → Findings com severidade (CRITICAL/WARNING/INFO)
Regras
- LER o nucleo COMPLETAMENTE antes de analisar — analise parcial produz diagnostico incompleto
- SEMPRE executar os 13 checks do validator como base — validacao padronizada garante cobertura minima
- Ir ALEM dos 13 checks: analisar coerencia arquitetural — validator checa forma, analise checa substancia
- Categorizar findings por severidade — sem categorizacao, usuario nao sabe o que priorizar:
- CRITICAL: nucleo nao funciona (routing quebrado, brain inexistente referenciado)
- WARNING: nucleo funciona mas tem problemas (regra sem WHY, skill longa, triggers fracos)
- INFO: sugestoes de melhoria (pattern reutilizavel, otimizacao possivel)
- Cada finding DEVE ter sugestao de fix concreta — finding sem fix e diagnostico sem tratamento
- Se usuario pediu analise focada (ex: "por que brain X nao ativa"): priorizar essa area mas nao ignorar o resto — sintoma pode ter causa em area diferente
- NUNCA modificar o nucleo durante analise — analisar e alterar sao escopos diferentes, misturar causa confusao
- Comparar com patterns de nucleos anteriores no registry — nucleo isolado parece ok, mas comparacao revela divergencias
Analises extras (alem dos 13 checks)
| Analise |
O que verifica |
| Coerencia de routing |
Toda skill tem entrada no routing? Routing aponta pra skills existentes? |
| Gates de pipeline |
Post-condicao do brain N = pre-condicao do brain N+1? |
| Trigger diversity |
Descriptions usam verbos variados? Triggers sao semanticamente distintos? |
| Memory usage |
MEMORY_KNOWLEDGE tem dados? MEMORY_SESSIONS registra sessoes? |
| Blast radius |
Brain com escopo muito amplo? Sobreposicao entre brains? |
| Complexidade |
Quantidade de brains compativel com dominio? Over/under-engineering? |
Templates de output
Relatorio de Analise
## Analise — {{NUCLEO_NAME}}
**Data**: YYYY-MM-DD
**Caminho**: {{CAMINHO}}
**Brains**: {{N}}
### Validacao (13 checks)
| # | Item | Status |
|---|------|--------|
(tabela do validator)
### Findings
#### CRITICAL
- [finding]: [sugestao de fix]
#### WARNING
- [finding]: [sugestao de fix]
#### INFO
- [finding]: [sugestao de fix]
### Resumo
- **Score**: X/13 checks passando
- **Saude geral**: [Saudavel / Precisa atencao / Critico]
- **Proximos passos**: [recomendacoes]
Checklist de self-review
Post-condicoes (gate de saida)
- Relatorio completo entregue com validacao + findings + sugestoes
- Nenhum arquivo do nucleo modificado (read-only)
- Se findings criticos: recomendacao clara de proximos passos
Criterios de handoff
- Nucleo saudavel (13/13, sem criticals) → entregar relatorio. DONE.
- Issues encontrados → entregar relatorio com sugestoes. Usuario decide se quer
/workflow-editar.
- Nucleo com problemas graves → sugerir
/workflow-editar para correcoes ou /workflow-criar para recriar.
- Analise revelou patterns reutilizaveis → sugerir retrospectiva para incorporar nos templates.
1---2name: workflow-analisar3description: Analisa e audita nucleos de AI existentes. Ativar para: analisar nucleo, auditar workflow, revisar nucleo, checar qualidade, diagnosticar nucleo, avaliar nucleo, validar nucleo existente.4---56# /workflow-analisar — Analisar Nucleo78## Papel910Ponto de entrada para analise e auditoria de nucleos de AI existentes.11Le o nucleo, executa validacao de 13 criterios, e entrega relatorio com findings e sugestoes.1213## Pre-condicoes (gate de entrada)1415- Nucleo existente com caminho informado pelo usuario ou disponivel em `nucleos/registry.md`16- Se caminho nao encontrado: perguntar ao usuario17- Se usuario descreveu sintoma especifico (ex: "brain X nunca ativa"): focar analise nessa area1819## Fluxo2021```22📊 INVENTARIO → Lista brains, routing, pipelines, memoria, templates23🔍 VALIDACAO 13 CHECKS → workflow-validator audita contra 13 criterios24🏗️ ARQUITETURA → Analisa coerencia de routing, pipelines, gates25🧠 MEMORIA → Verifica schema, consistencia, uso correto26📋 RELATORIO → Findings com severidade (CRITICAL/WARNING/INFO)27```2829## Regras30311. LER o nucleo COMPLETAMENTE antes de analisar — analise parcial produz diagnostico incompleto322. SEMPRE executar os 13 checks do validator como base — validacao padronizada garante cobertura minima333. Ir ALEM dos 13 checks: analisar coerencia arquitetural — validator checa forma, analise checa substancia344. Categorizar findings por severidade — sem categorizacao, usuario nao sabe o que priorizar:35 - **CRITICAL**: nucleo nao funciona (routing quebrado, brain inexistente referenciado)36 - **WARNING**: nucleo funciona mas tem problemas (regra sem WHY, skill longa, triggers fracos)37 - **INFO**: sugestoes de melhoria (pattern reutilizavel, otimizacao possivel)385. Cada finding DEVE ter sugestao de fix concreta — finding sem fix e diagnostico sem tratamento396. Se usuario pediu analise focada (ex: "por que brain X nao ativa"): priorizar essa area mas nao ignorar o resto — sintoma pode ter causa em area diferente407. NUNCA modificar o nucleo durante analise — analisar e alterar sao escopos diferentes, misturar causa confusao418. Comparar com patterns de nucleos anteriores no registry — nucleo isolado parece ok, mas comparacao revela divergencias4243## Analises extras (alem dos 13 checks)4445| Analise | O que verifica |46|:--------|:---------------|47| Coerencia de routing | Toda skill tem entrada no routing? Routing aponta pra skills existentes? |48| Gates de pipeline | Post-condicao do brain N = pre-condicao do brain N+1? |49| Trigger diversity | Descriptions usam verbos variados? Triggers sao semanticamente distintos? |50| Memory usage | MEMORY_KNOWLEDGE tem dados? MEMORY_SESSIONS registra sessoes? |51| Blast radius | Brain com escopo muito amplo? Sobreposicao entre brains? |52| Complexidade | Quantidade de brains compativel com dominio? Over/under-engineering? |5354## Templates de output5556### Relatorio de Analise5758```markdown59## Analise — {{NUCLEO_NAME}}6061**Data**: YYYY-MM-DD62**Caminho**: {{CAMINHO}}63**Brains**: {{N}}6465### Validacao (13 checks)66| # | Item | Status |67|---|------|--------|68(tabela do validator)6970### Findings71#### CRITICAL72- [finding]: [sugestao de fix]7374#### WARNING75- [finding]: [sugestao de fix]7677#### INFO78- [finding]: [sugestao de fix]7980### Resumo81- **Score**: X/13 checks passando82- **Saude geral**: [Saudavel / Precisa atencao / Critico]83- **Proximos passos**: [recomendacoes]84```8586## Checklist de self-review8788- [ ] Nucleo lido completamente antes de analisar?89- [ ] 13 checks do validator executados?90- [ ] Analises extras executadas (routing, gates, triggers, memoria)?91- [ ] Findings categorizados por severidade?92- [ ] Cada finding tem sugestao de fix concreta?93- [ ] Relatorio completo entregue?94- [ ] Nenhum arquivo do nucleo foi modificado?9596## Post-condicoes (gate de saida)9798- Relatorio completo entregue com validacao + findings + sugestoes99- Nenhum arquivo do nucleo modificado (read-only)100- Se findings criticos: recomendacao clara de proximos passos101102## Criterios de handoff103104- **Nucleo saudavel (13/13, sem criticals)** → entregar relatorio. DONE.105- **Issues encontrados** → entregar relatorio com sugestoes. Usuario decide se quer `/workflow-editar`.106- **Nucleo com problemas graves** → sugerir `/workflow-editar` para correcoes ou `/workflow-criar` para recriar.107- **Analise revelou patterns reutilizaveis** → sugerir retrospectiva para incorporar nos templates.
Jojozinho21