gsd-pi-squads-nirvana 🚀

El squad definitivo para instalar, configurar, enseñar y dominar GSD-PI. Del npm install al gsd headless en producción — con un tutor que habla tu idioma.

Qué Hace Este Squad

Convierte a cualquier persona en un power user de GSD-PI — el coding agent autónomo que ejecuta milestones enteros de forma independiente. Este squad cubre todo el ciclo de vida:

Instalación → Configuración → Enseñanza → Creación de Squads → Automatización → Resolución
    ↑                                                                              │
    └────────────────────── Diagnóstico y Reparación ←────────────────────────────┘

Características

• 🔧 Instalación completa — GSD-PI + pi-squad-loader-v3 + skills + providers
• 🎓 Tutor progresivo — 4 módulos: fundamentos → auto-mode → squads → experto
• 🏥 Doctor — diagnóstico en 7 capas con reparación automática
• ⚙️ Configurador — PREFERENCES.md optimizado para tu caso de uso
• 🏗️ Ingeniero de Squads — crea squads v3 de calidad NIRVANA
• 🤖 Automatizador — auto-mode, headless, CI/CD, multi-worker

Agentes

Total: 8 agentes | ~79.5KB de instrucciones | Promedio: ~10KB/agente

Flujos de Trabajo

Uso Rápido

# Dentro de una sesión GSD:

# 1. Activar el squad
squad_activate "gsd-pi-squads-nirvana"

# 2. Listar agentes disponibles
squad_status

# 3. Pedir ayuda (el maestro decide quién ejecuta)
squad_dispatch --agent "squad--gsd-pi-squads-nirvana--gps-maestro" \
  --task "Instala GSD-PI completo y enséñame a usarlo"

# 4. Ejecutar workflow completo de setup
squad_workflow --squad "gsd-pi-squads-nirvana" \
  --workflow "full-setup" \
  --context "Máquina nueva, necesito todo desde cero"

# 5. Aprender GSD-PI desde cero
squad_workflow --squad "gsd-pi-squads-nirvana" \
  --workflow "learn-gsd" \
  --context "Nunca usé GSD, quiero aprenderlo todo"

El Currículo del Tutor

El agente gps-tutor enseña en 4 módulos progresivos:

Cada módulo termina con un ejercicio práctico que el estudiante ejecuta en la terminal.

Health Check en 7 Capas

El gps-doctor verifica el ecosistema completo:

Capa 1: Runtime       → Node.js ≥ 22, npm, git
Capa 2: GSD-PI        → Binario, versión, PATH
Capa 3: Directorio    → ~/.gsd/, extensions, auth.json
Capa 4: Squad Loader  → pi-squad-loader-v3, dependencias
Capa 5: Squads        → ~/squads/, cantidad, versiones
Capa 6: Skills        → ~/.agents/skills/
Capa 7: Paperclip     → Opcional, puerto 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

Requisitos

• GSD-PI — npm install -g gsd-pi@latest
• pi-squad-loader-v3 — extensión en

  ~/.gsd/agent/extensions/

• Node.js ≥ 22.0.0 (24 LTS recomendado)

Soporte Multi-Plataforma

Este squad soporta macOS, Linux y Windows. Todos los agentes adaptan comandos automáticamente:

nodesource+apt

taskkill /f /im

Autor

Luiz Gustavo Vieira Rodrigues (@gutomec)

Licencia

MIT