gsd-pi-squads-nirvana 🚀

O squad definitivo para instalar, configurar, ensinar e dominar o GSD-PI. Do npm install ao gsd headless em produção — com um tutor que fala sua língua.

O Que Este Squad Faz

Transforma qualquer pessoa em um power user de GSD-PI — o coding agent standalone que executa milestones inteiros de forma autônoma. Este squad cobre todo o ciclo de vida:

Instalação → Configuração → Ensino → Criação de Squads → Automação → Troubleshooting
    ↑                                                                        │
    └────────────────────── Diagnóstico e Reparo ←──────────────────────────┘

Destaques

• 🔧 Instalação completa — GSD-PI + pi-squad-loader-v3 + skills + providers
• 🎓 Tutor progressivo — 4 módulos: fundamentos → auto-mode → squads → expert
• 🏥 Doctor — diagnóstico em 7 camadas com reparo automático
• ⚙️ Configurer — PREFERENCES.md otimizado para seu caso de uso
• 🏗️ Squad Engineer — cria squads v3 de qualidade NIRVANA
• 🤖 Automator — auto-mode, headless, CI/CD, multi-worker

Agentes

Total: 8 agentes | ~79.5KB de instruções | Média: ~10KB/agente

Workflows

Uso Rápido

# Dentro de uma sessão GSD:

# 1. Ativar o squad
squad_activate "gsd-pi-squads-nirvana"

# 2. Listar agentes disponíveis
squad_status

# 3. Pedir ajuda (o maestro decide quem executa)
squad_dispatch --agent "squad--gsd-pi-squads-nirvana--gps-maestro" \
  --task "Instala o GSD-PI completo e me ensina a usar"

# 4. Executar workflow completo de setup
squad_workflow --squad "gsd-pi-squads-nirvana" \
  --workflow "full-setup" \
  --context "Máquina nova, preciso de tudo do zero"

# 5. Aprender GSD-PI do zero
squad_workflow --squad "gsd-pi-squads-nirvana" \
  --workflow "learn-gsd" \
  --context "Nunca usei GSD, quero aprender tudo"

O Currículo do Tutor

O agente gps-tutor ensina em 4 módulos progressivos:

Cada módulo termina com um exercício prático que o aluno executa no terminal.

Health Check em 7 Camadas

O gps-doctor verifica o ecossistema completo:

Camada 1: Runtime       → Node.js ≥ 22, npm, git
Camada 2: GSD-PI        → Binário, versão, PATH
Camada 3: Diretório     → ~/.gsd/, extensions, auth.json
Camada 4: Squad Loader  → pi-squad-loader-v3, dependências
Camada 5: Squads        → ~/squads/, contagem, versões
Camada 6: Skills        → ~/.agents/skills/
Camada 7: Paperclip     → Opcional, 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

Requisitos

• GSD-PI — npm install -g gsd-pi@latest
• pi-squad-loader-v3 — extensão em

  ~/.gsd/agent/extensions/

• Node.js ≥ 22.0.0 (24 LTS recomendado)

Autor

Luiz Gustavo Vieira Rodrigues (@gutomec)

Licença

MIT