O que Council — Análise Multiperspectiva faz?
Um framework de análise multiperspectiva que fornece avaliação objetiva e não tendenciosa de bases de código, projetos e documentação. Usa múltiplos pontos de vista e técnicas de desvios cognitivos para superar a tendência de ancoragem no código existente.
O Problema Que Isso Resolve
Ferramentas de IA (e humanos) tendem a ancorar no código existente. Eles veem o que É e têm dificuldade em imaginar o que PODERIA SER. Eles validam em vez de explorar. Council usa:
- Técnicas de desvios — Métodos que forçam um pensamento novo
- Múltiplas perspectivas — Modelos mentais diferentes que capturam coisas diferentes
- Síntese estruturada — Combinando insights enquanto rastreia discordâncias
Quando Usar
- Avaliar se a abordagem atual ainda é a ideal
- Explorar alternativas à implementação existente
- Identificar suposições ocultas no seu projeto
- Obter feedback objetivo antes de decisões importantes
- Quando estiver preso em um ótimo local (local optimum)
- Quando suspeitar que pode haver uma maneira melhor, mas não consegue vê-la
- Quando ferramentas de IA ficam ecoando seus padrões existentes
Entrada
O usuário fornece:
- Alvo: Caminho do repositório, documentação ou descrição de um problema específico
- Meta (opcional): Como é o sucesso (ex.: "maximizar lucratividade")
- Restrições (opcional): O que deve ser preservado (ex.: "deve usar o modelo de dados existente")
Fluxo de Execução
Fase 1: Reconhecimento
Leia e entenda o alvo minuciosamente. Documente:
- O que o projeto faz
- Como está estruturado atualmente
- Quais restrições existem
- Quais são as metas declaradas
NÃO forme opiniões ainda. Apenas colete fatos.
Fase 2: Gerar Perspectivas
Selecione 3-5 perspectivas relevantes com base no alvo:
| Perspectiva | Foco | Melhor Para |
|---|---|---|
| Arquiteto | Estrutura, padrões, acoplamento, coesão | Design de sistema, refatoração |
| Desafiador | Suposições, riscos, alternativas | Validação de decisões, mitigação de riscos |
| Oportunista | Nova tecnologia, atalhos, simplificação | Otimização, redução de dívida técnica |
| Segurança | Limites de confiança, modos de falha | Segurança, confiabilidade |
| Economista | Custo, complexidade, ROI | Alocação de recursos, priorização |
| Usuário | Usabilidade, valor, atrito | UX, decisões de produto |
| Arqueólogo | Legado, dívida, histórico | Entendimento, migração |
| Futurista | Tendências, escalabilidade, evolução | Planejamento de longo prazo |
Para alvos complexos, use spawn_agents para executar perspectivas em paralelo — cada agente
trabalha independentemente para evitar pensamento de grupo, e os resultados se combinam na Fase 3.
Para alvos mais simples, execute perspectivas sequencialmente em um único agente.
Cada perspectiva aplica estas técnicas de desvios:
- Modo Olhos Frescos: Ignore deliberadamente a implementação existente. Pergunte: "O que eu construiria se começasse do zero, sabendo apenas a meta?"
- Modo Desafio: Questione cada suposição. Por que este componente existe? E se o removêssemos? E se o oposto fosse verdade?
- Modo Reconstrução: "Se eu tivesse que resolver isso do zero com o conhecimento de hoje, o que faria de diferente?"
Consulte references/debiasing.md para técnicas e prompts detalhados de desvios.
Fase 3: Sintetizar
Combine perspectivas em uma saída estruturada:
- Concordâncias: O que várias perspectivas concordam (alta confiança)
- Discordâncias: Onde as perspectivas conflitam (investigue mais — elas revelam trade-offs)
- Insights Novos: Coisas que apenas uma perspectiva capturou
- Recomendações Priorizadas: Classificadas por impacto e confiança
Consulte agents/synthesizer.md para instruções detalhadas de síntese ao usar subagentes.
Fase 4: Validar
- Verifique se as recomendações não se contradizem
- Sinalize quaisquer suposições que não foram validadas
- Identifique quais informações mudariam as conclusões
Formato de Saída
# Relatório Council: [Alvo]
## Resumo Executivo
[Avaliação objetiva de 2 a 3 frases — não um resumo do que foi feito, mas um veredito]
## Principais Descobertas
### [Nome da Descoberta]
- **O quê**: [Descrição clara da descoberta]
- **Perspectivas que concordam**: [Lista]
- **Perspectivas que discordam**: [Lista + breve motivo]
- **Confiança**: [Alta/Média/Baixa]
- **Evidência**: [Arquivo:linha específico, métrica ou observação]
## Recomendações
### [ALTO IMPACTO] [Título da Recomendação]
- **Problema abordado**: [A descoberta que isso corrige]
- **Solução**: [Ação concreta]
- **Impacto esperado**: [O que melhora e em quanto]
- **Esforço**: [Baixo/Médio/Alto]
- **Risco**: [Baixo/Médio/Alto]
- **Perspectivas que apoiam**: [Lista]
### [MÉDIO IMPACTO] ...
### [BAIXO IMPACTO] ...
## Abordagens Alternativas Consideradas
| Abordagem | Prós | Contras | Veredito |
|-----------|------|---------|----------|
| ... | ... | ... | Manter/Substituir/Explorar mais |
## O Que Mudaria Esta Avaliação
- Se [X] for verdadeiro, então [recomendação Y muda]
- [Suposição não validada que importa]
Recursos Inclusos
references/debiasing.md— Técnicas e prompts detalhados de desvios por tipo de perspectivaagents/perspective.md— Instruções para subagentes executarem análises de perspectiva individuaisagents/synthesizer.md— Instruções para um subagente de síntese combinar múltiplas saídas de perspectiva