🧘 Nirvana Context Enricher (NCE)

Squad de investigación paralela que genera contexto enriquecido a nivel nirvana sobre cualquier tema. Evolución de

/atualise

con Agent Teams: investigación profunda + skills.sh + bibliotecas GitHub + papers académicos.

📑 Tabla de Contenidos

• Visión General
• Comparación /atualise vs NCE
• Tech Stack
• Prerrequisitos
• Primeros Pasos
• Arquitectura
• Agentes
• Workflow
• Output
• Solución de Problemas
• Contribuir
• Licencia

✨ Visión General

El Nirvana Context Enricher es un squad Squad Protocol v5 que orquesta 5 agentes especializados para generar informes de contexto integrales sobre cualquier tema. A diferencia de las investigaciones secuenciales tradicionales, NCE ejecuta 3 investigadores en paralelo — cubriendo investigación profunda, ecosistema de herramientas y literatura académica — y luego sintetiza todo en un informe unificado de 16 secciones.

¿Para quién es? Desarrolladores, arquitectos y equipos que necesitan contexto técnico profundo y accionable antes de tomar decisiones.

¿Por qué existe? Las investigaciones manuales son lentas, superficiales y pierden fuentes importantes. NCE garantiza una cobertura mínima de 24 búsquedas web y 11 extracciones de contenido, distribuidas entre investigadores dedicados¹.

📊 Comparación /atualise vs NCE

/atualise

/atualise

🔧 Tech Stack

📋 Prerrequisitos

• Claude Code — con soporte para Agent Teams
• squads-sh — framework de orquestación
• Acceso a internet — necesario para WebSearch y WebFetch
• Squad NCE instalado — presente en

  squads/nirvana-context-enricher/

Verifique que el squad esté disponible:

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

⚡ Primeros Pasos

1. Vía Skill (recomendado)

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

2. Vía Squad Command

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

3. Argumentos

Checklist de Configuración

• Claude Code abierto con el runtime de squads activo
• Tema definido con claridad
• Conexión a internet estable
• Esperar a que los 3 investigadores completen (~2-5 min)

🏗️ Arquitectura

Diagrama de Componentes

Flujo de Ejecución

squads/nirvana-context-enricher/
├── squad.yaml                              # Definición del squad
├── README.md                               # Documentación (PT-BR)
├── 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   # Parsear tema y queries
│   ├── nce-orchestrator-dispatch-research.md # Generar investigadores
│   ├── nce-deep-researcher-execute-rounds.md # 6 rondas de investigación
│   ├── nce-skills-scout-search-ecosystem.md  # Skills + bibliotecas
│   ├── nce-papers-researcher-find-papers.md  # Papers académicos
│   ├── nce-synthesizer-generate-report.md    # Informe final
│   └── nce-orchestrator-cleanup.md           # Apagado y limpieza
├── workflows/
│   └── nirvana-enrichment.yaml             # Workflow de 4 fases
├── checklists/
│   └── research-quality.md                 # Checklist de calidad
├── templates/
│   └── nirvana-report.md                   # Plantilla del informe
└── config/
    ├── coding-standards.md                 # Estándares de código
    ├── tech-stack.md                       # Tecnologías utilizadas
    └── source-tree.md                      # Estructura de directorios

👥 Agentes

Mínimos de Búsqueda por Agente

🔄 Workflow

El workflow nirvana-enrichment tiene 4 fases secuenciales con la fase de investigación ejecutándose en paralelo:

Fases

Manejo de Errores

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 investigadores exitosos

📄 Output

El informe se guarda automáticamente en:

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

16 Secciones del Informe Nirvana

Reglas de Calidad (Checklist)

🆘 Solución de Problemas

ls -la .claude/context-enrichment/

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

# Si la limpieza automática falla, verifique los agentes residuales
# y cancele manualmente vía Claude Code

# Los informes parciales se guardan con sufijo -partial
ls .claude/context-enrichment/*-partial*

🤝 Contribuir

¡Las contribuciones son bienvenidas! Siga los pasos a continuación:

1. Haga Fork del proyecto
2. Cree su rama (

   git checkout -b feature/mejora-nce

   )
3. Haga Commit de sus cambios (git commit -m 'feat(nce): descripción de la mejora')
4. Haga Push a la rama (

   git push origin feature/mejora-nce

   )
5. Abra un Pull Request

Patrones de Commit

Consulte la Guía de Contribución para más detalles².

+ Añadido: Squad NCE con 5 agentes especializados
+ Añadido: Workflow nirvana-enrichment con 4 fases
+ Añadido: Investigación paralela con 3 investigadores simultáneos
+ Añadido: Informe Nirvana con 16 secciones
+ Añadido: Quality gates con mínimos de búsqueda
+ Añadido: Manejo de errores con minimum_viable (2/3)
! Cambiado: Evolución de /atualise a arquitectura multi-agente

📃 Licencia

Este proyecto está licenciado bajo la licencia MIT — vea el archivo LICENSE para más detalles.