gsd-pi-squads-nirvana 🚀

The ultimate squad to install, configure, teach and master GSD-PI. From npm install to gsd headless in production — with a tutor that speaks your language.

What This Squad Does

Turns anyone into a GSD-PI power user — the standalone coding agent that autonomously executes entire milestones. This squad covers the full lifecycle:

Installation → Configuration → Teaching → Squad Creation → Automation → Troubleshooting
    ↑                                                                           │
    └────────────────────── Diagnostics & Repair ←─────────────────────────────┘

Highlights

• 🔧 Full installation — GSD-PI + pi-squad-loader-v3 + skills + providers
• 🎓 Progressive tutor — 4 modules: fundamentals → auto-mode → squads → expert
• 🏥 Doctor — 7-layer diagnostics with automatic repair
• ⚙️ Configurer — Optimized PREFERENCES.md for your use case
• 🏗️ Squad Engineer — Creates NIRVANA-quality v3 squads
• 🤖 Automator — auto-mode, headless, CI/CD, multi-worker

Agents

Total: 8 agents | ~79.5KB of instructions | Average: ~10KB/agent

Workflows

Quick Start

# Inside a GSD session:

# 1. Activate the squad
squad_activate "gsd-pi-squads-nirvana"

# 2. List available agents
squad_status

# 3. Ask for help (the maestro decides who executes)
squad_dispatch --agent "squad--gsd-pi-squads-nirvana--gps-maestro" \
  --task "Install GSD-PI completely and teach me how to use it"

# 4. Run full setup workflow
squad_workflow --squad "gsd-pi-squads-nirvana" \
  --workflow "full-setup" \
  --context "Brand new machine, need everything from scratch"

# 5. Learn GSD-PI from zero
squad_workflow --squad "gsd-pi-squads-nirvana" \
  --workflow "learn-gsd" \
  --context "Never used GSD, want to learn everything"

The Tutor Curriculum

The gps-tutor agent teaches in 4 progressive modules:

Each module ends with a hands-on exercise that the student runs in the terminal.

7-Layer Health Check

The gps-doctor checks the complete ecosystem:

Layer 1: Runtime       → Node.js ≥ 22, npm, git
Layer 2: GSD-PI        → Binary, version, PATH
Layer 3: Directory     → ~/.gsd/, extensions, auth.json
Layer 4: Squad Loader  → pi-squad-loader-v3, dependencies
Layer 5: Squads        → ~/squads/, count, versions
Layer 6: Skills        → ~/.agents/skills/
Layer 7: Paperclip     → Optional, port 3100, fork

Harness v3

harness:
  doom_loop:
    enabled: true
    max_identical_outputs: 3
    on_detect: change-strategy
  ralph_loop:
    enabled: true
    max_iterations: 5
  context_compaction:
    enabled: true
    strategy: key-fields
    max_handoff_tokens: 4000
  filesystem_collaboration:
    enabled: true
  traces:
    enabled: true
    level: standard
  self_verify:
    default_enabled: true

Requirements

• GSD-PI — npm install -g gsd-pi@latest
• pi-squad-loader-v3 — extension at

  ~/.gsd/agent/extensions/

• Node.js ≥ 22.0.0 (24 LTS recommended)

Cross-Platform Support

This squad supports macOS, Linux, and Windows. All agents adapt commands automatically:

nodesource+apt

taskkill /f /im

Author

Luiz Gustavo Vieira Rodrigues (@gutomec)

License

MIT