Communitygithub.com

Council — Análise Multiperspectiva

Um framework de análise multiperspectiva que fornece avaliação objetiva e não tendenciosa de bases de código, projetos e documentação.

O que é Council — Análise Multiperspectiva?

Council é um skill de agente de IA que oferece análise objetiva e imparcial de bases de código, projetos e documentação, combatendo o viés de ancoragem (tendência de validar o código existente em vez de explorar alternativas). Ele usa técnicas de desvios cognitivos, múltiplas perspectivas (como Arquiteto, Desafiador, Oportunista, etc.) e síntese estruturada para gerar recomendações priorizadas. O fluxo de execução é dividido em quatro fases: Reconhecimento (coleta de fatos sem julgamento), Geração de Perspectivas (aplicação de 3-5 perspectivas com técnicas de desvios como Modo Olhos Frescos, Modo Desafio e Modo Reconstrução), Síntese (combinação de concordâncias, discordâncias e insights) e Validação (verificação de contradições e suposições não validadas). Para alvos complexos, o skill suporta paralelização de agentes via `spawn_agents` para evitar pensamento de grupo. É ideal para decisões de arquitetura, refatoração, otimização, segurança, planejamento de longo prazo e qualquer cenário onde seja necessário explorar alternativas além do código existente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add adulari/forge

Perguntar na sua IA favorita

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

Documentação

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:

  1. Técnicas de desvios — Métodos que forçam um pensamento novo
  2. Múltiplas perspectivas — Modelos mentais diferentes que capturam coisas diferentes
  3. 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:

PerspectivaFocoMelhor Para
ArquitetoEstrutura, padrões, acoplamento, coesãoDesign de sistema, refatoração
DesafiadorSuposições, riscos, alternativasValidação de decisões, mitigação de riscos
OportunistaNova tecnologia, atalhos, simplificaçãoOtimização, redução de dívida técnica
SegurançaLimites de confiança, modos de falhaSegurança, confiabilidade
EconomistaCusto, complexidade, ROIAlocação de recursos, priorização
UsuárioUsabilidade, valor, atritoUX, decisões de produto
ArqueólogoLegado, dívida, históricoEntendimento, migração
FuturistaTendências, escalabilidade, evoluçãoPlanejamento 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:

  1. Modo Olhos Frescos: Ignore deliberadamente a implementação existente. Pergunte: "O que eu construiria se começasse do zero, sabendo apenas a meta?"
  2. Modo Desafio: Questione cada suposição. Por que este componente existe? E se o removêssemos? E se o oposto fosse verdade?
  3. 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:

  1. Concordâncias: O que várias perspectivas concordam (alta confiança)
  2. Discordâncias: Onde as perspectivas conflitam (investigue mais — elas revelam trade-offs)
  3. Insights Novos: Coisas que apenas uma perspectiva capturou
  4. 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 perspectiva
  • agents/perspective.md — Instruções para subagentes executarem análises de perspectiva individuais
  • agents/synthesizer.md — Instruções para um subagente de síntese combinar múltiplas saídas de perspectiva

Habilidades Relacionadas