🧘 Nirvana Context Enricher (NCE)

Squad de pesquisa paralela que gera contexto enriquecido ao estado nirvana sobre qualquer tópico. Evolução do

/atualise

com Agent Teams: deep research + skills.sh + bibliotecas GitHub + papers acadêmicos.

📑 Índice

• Visão Geral
• Comparação /atualise vs NCE
• Tech Stack
• Pré-requisitos
• Primeiros Passos
• Arquitetura
• Agentes
• Workflow
• Output
• Troubleshooting
• Contribuindo
• Licença

✨ Visão Geral

O Nirvana Context Enricher é um squad Squad Protocol v5 que orquestra 5 agentes especializados para gerar relatórios de contexto abrangentes sobre qualquer tópico. Ao contrário de pesquisas sequenciais tradicionais, o NCE executa 3 pesquisadores em paralelo — cobrindo pesquisa profunda, ecossistema de ferramentas e literatura acadêmica — e depois sintetiza tudo num relatório unificado de 16 seções.

Para quem é? Desenvolvedores, arquitetos e equipes que precisam de contexto técnico profundo e acionável antes de tomar decisões.

Por que existe? Pesquisas manuais são lentas, superficiais e perdem fontes importantes. O NCE garante cobertura mínima de 24 buscas web e 11 extrações de conteúdo, distribuídas entre pesquisadores dedicados¹.

📊 Comparação /atualise vs NCE

/atualise

/atualise

🔧 Tech Stack

📋 Pré-requisitos

• Claude Code — com suporte a Agent Teams
• squads-sh — framework de orquestração
• Acesso à internet — necessário para WebSearch e WebFetch
• Squad NCE instalado — presente em

  squads/nirvana-context-enricher/

Verifique se o squad está disponível:

ls squads/nirvana-context-enricher/squad.yaml

⚡ Primeiros Passos

1. Via Skill (recomendado)

/nirvana-context-enricher "React Server Components" 2026

2. Via Squad Command

/SQUADS:nce:nce-orchestrator *enrich "Kubernetes operators" 2026

3. Argumentos

Checklist de Uso

• Claude Code aberto com o runtime de squads ativo
• Tópico definido com clareza
• Conexão com internet estável
• Aguardar conclusão dos 3 pesquisadores (~2-5 min)

🏗️ Arquitetura

Diagrama de Componentes

Fluxo de Execução

squads/nirvana-context-enricher/
├── squad.yaml                              # Definição do squad
├── README.md                               # Este arquivo
├── agents/
│   ├── nce-orchestrator.md                 # Nirva — FlowMaster
│   ├── nce-deep-researcher.md              # Sage — Seeker
│   ├── nce-skills-scout.md                 # Scout — Explorer
│   ├── nce-papers-researcher.md            # Scholar — Seeker
│   └── nce-synthesizer.md                  # Lotus — Alchemist
├── tasks/
│   ├── nce-orchestrator-parse-request.md   # Parse tópico e queries
│   ├── nce-orchestrator-dispatch-research.md # Spawn pesquisadores
│   ├── nce-deep-researcher-execute-rounds.md # 6 rodadas de pesquisa
│   ├── nce-skills-scout-search-ecosystem.md  # Skills + bibliotecas
│   ├── nce-papers-researcher-find-papers.md  # Papers acadêmicos
│   ├── nce-synthesizer-generate-report.md    # Relatório final
│   └── nce-orchestrator-cleanup.md           # Shutdown e cleanup
├── workflows/
│   └── nirvana-enrichment.yaml             # Workflow de 4 fases
├── checklists/
│   └── research-quality.md                 # Checklist de qualidade
├── templates/
│   └── nirvana-report.md                   # Template do relatório
└── config/
    ├── coding-standards.md                 # Padrões de código
    ├── tech-stack.md                       # Tecnologias utilizadas
    └── source-tree.md                      # Estrutura de diretórios

👥 Agentes

Mínimos de Busca por Agente

🔄 Workflow

O workflow nirvana-enrichment possui 4 fases sequenciais com a fase de pesquisa executando em paralelo:

Fases

Error Handling

Quality Gates

gates:
  min_searches: 20        # Mínimo total de WebSearch
  min_webfetch: 11        # Mínimo total de WebFetch
  min_researchers_success: 2  # Mínimo de pesquisadores bem-sucedidos

📄 Output

O relatório é salvo automaticamente em:

.claude/context-enrichment/{slug}-{YYYY-MM-DD}.md

16 Seções do Relatório Nirvana

Regras de Qualidade (Checklist)

🆘 Troubleshooting

ls -la .claude/context-enrichment/

ls squads/nirvana-context-enricher/squad.yaml

# Se o cleanup automático falhar, verifique os agentes residuais
# e cancele manualmente via Claude Code

# Relatórios parciais são salvos com sufixo -partial
ls .claude/context-enrichment/*-partial*

🤝 Contribuindo

Contribuições são bem-vindas! Siga os passos abaixo:

1. Fork o projeto
2. Crie sua branch (

   git checkout -b feature/melhoria-nce

   )
3. Commit suas mudanças (git commit -m 'feat(nce): descrição da melhoria')
4. Push para a branch (

   git push origin feature/melhoria-nce

   )
5. Abra um Pull Request

Padrões de Commit

Consulte o Guia de Contribuição para mais detalhes².

+ Adicionado: Squad NCE com 5 agentes especializados
+ Adicionado: Workflow nirvana-enrichment com 4 fases
+ Adicionado: Pesquisa paralela com 3 pesquisadores simultâneos
+ Adicionado: Relatório Nirvana com 16 seções
+ Adicionado: Quality gates com mínimos de busca
+ Adicionado: Error handling com minimum_viable (2/3)
! Alterado: Evolução do /atualise para arquitetura multi-agente

📃 Licença

Este projeto está licenciado sob a licença MIT — veja o arquivo LICENSE para detalhes.