🧘 Nirvana Context Enricher (NCE)

Parallel research squad that generates nirvana-state enriched context on any topic. Evolution of

/atualise

with Agent Teams: deep research + skills.sh + GitHub libraries + academic papers.

📑 Table of Contents

• Overview
• Comparison: /atualise vs NCE
• Tech Stack
• Prerequisites
• Getting Started
• Architecture
• Agents
• Workflow
• Output
• Troubleshooting
• Contributing
• License

✨ Overview

The Nirvana Context Enricher is a Squad Protocol v5 squad that orchestrates 5 specialized agents to generate comprehensive context reports on any topic. Unlike traditional sequential research, NCE runs 3 researchers in parallel — covering deep research, tools ecosystem, and academic literature — then synthesizes everything into a unified 16-section report.

Who is it for? Developers, architects, and teams who need deep, actionable technical context before making decisions.

Why does it exist? Manual research is slow, shallow, and misses important sources. NCE guarantees minimum coverage of 24 web searches and 11 content extractions, distributed among dedicated researchers¹.

📊 Comparison: /atualise vs NCE

/atualise

/atualise

🔧 Tech Stack

📋 Prerequisites

• Claude Code — with Agent Teams support
• squads-sh — orchestration framework
• Internet access — required for WebSearch and WebFetch
• NCE squad installed — present at

  squads/nirvana-context-enricher/

Verify the squad is available:

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

⚡ Getting Started

1. Via Skill (recommended)

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

2. Via Squad Command

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

3. Arguments

Setup Checklist

• Claude Code open with the squads runtime active
• Topic clearly defined
• Stable internet connection
• Wait for all 3 researchers to complete (~2-5 min)

🏗️ Architecture

Component Diagram

Execution Flow

squads/nirvana-context-enricher/
├── squad.yaml                              # Squad definition
├── README.md                               # Documentation (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   # Parse topic and queries
│   ├── nce-orchestrator-dispatch-research.md # Spawn researchers
│   ├── nce-deep-researcher-execute-rounds.md # 6 research rounds
│   ├── nce-skills-scout-search-ecosystem.md  # Skills + libraries
│   ├── nce-papers-researcher-find-papers.md  # Academic papers
│   ├── nce-synthesizer-generate-report.md    # Final report
│   └── nce-orchestrator-cleanup.md           # Shutdown and cleanup
├── workflows/
│   └── nirvana-enrichment.yaml             # 4-phase workflow
├── checklists/
│   └── research-quality.md                 # Quality checklist
├── templates/
│   └── nirvana-report.md                   # Report template
└── config/
    ├── coding-standards.md                 # Coding standards
    ├── tech-stack.md                       # Technologies used
    └── source-tree.md                      # Directory structure

👥 Agents

Minimum Searches per Agent

🔄 Workflow

The nirvana-enrichment workflow has 4 sequential phases with the research phase running in parallel:

Phases

Error Handling

Quality Gates

gates:
  min_searches: 20        # Minimum total WebSearch
  min_webfetch: 11        # Minimum total WebFetch
  min_researchers_success: 2  # Minimum successful researchers

📄 Output

The report is automatically saved to:

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

16 Sections of the Nirvana Report

Quality Rules (Checklist)

🆘 Troubleshooting

ls -la .claude/context-enrichment/

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

# If automatic cleanup fails, check for residual agents
# and cancel manually via Claude Code

# Partial reports are saved with -partial suffix
ls .claude/context-enrichment/*-partial*

🤝 Contributing

Contributions are welcome! Follow the steps below:

1. Fork the project
2. Create your branch (

   git checkout -b feature/nce-improvement

   )
3. Commit your changes (git commit -m 'feat(nce): improvement description')
4. Push to the branch (

   git push origin feature/nce-improvement

   )
5. Open a Pull Request

Commit Patterns

See the Contributing Guide for more details².

+ Added: NCE squad with 5 specialized agents
+ Added: nirvana-enrichment workflow with 4 phases
+ Added: Parallel research with 3 simultaneous researchers
+ Added: Nirvana report with 16 sections
+ Added: Quality gates with search minimums
+ Added: Error handling with minimum_viable (2/3)
! Changed: Evolution from /atualise to multi-agent architecture

📃 License

This project is licensed under the MIT license — see the LICENSE file for details.