squad

Squad agentica generica, plugavel em qualquer projeto de codigo via Claude Code plugin. Faz o ciclo completo de descobrimento -> Product Owner -> Scrum Master -> Architect/Designer -> Dev -> QA -> Security -> Delivery, com board agil real (backlog -> todo -> developing -> qa -> done), RFC como contrato, e uma camada de adaptacao por projeto que nunca exige editar o nucleo.

Inspirado na squad acoplada ao jogo PIIramid (Piiramid/agent/ no vault Obsidian), com o contexto de projeto destilado para fora dos prompts.

Estrutura

.claude-plugin/marketplace.json      marketplace local "victor-squad"
plugins/squad/
  .claude-plugin/plugin.json
  agents/       12 subagentes (squad-discovery, squad-product-owner, ...)
  skills/       harness (hub) · agile (board/WIP/prioridade) · discovery (roteiro)
  commands/     12 comandos /squad:*
  workflows/    squad-cycle.js — modo autonomo de /squad:cycle --auto
  hooks/        contexto de sessao quando o projeto tem .squad/

Instalar

./install.sh
claude plugin marketplace add /Users/victor/Documents/dev/squad
claude plugin install squad@victor-squad

install.sh tambem symlinka agents/, skills/, commands/ (como slash-commands) e workflows/ para /Users/victor/Documents/documentacao/obsidian/squad/, mantendo o Obsidian como leitor do mesmo conteudo, sem duplicacao.

Usar num projeto

/squad:onboard          # descobre o projeto, cria .squad/
/squad:card <pedido>    # cria card no backlog
/squad:groom            # prioriza, aplica Definition of Ready, move para todo
/squad:rfc CARD-NNNN    # escreve o contrato quando ha ambiguidade real
/squad:build CARD-NNNN  # implementa
/squad:qa CARD-NNNN     # testa e da veredito
/squad:ship             # audita e libera
/squad:cycle [--auto]   # encadeia os passos acima
/squad:board            # ve o estado atual
/squad:retro            # fecha o loop de fluxo
/squad:ideate           # dossie divergente de ideias
/squad:fork <papel>     # adapta um papel a este projeto sem tocar no nucleo

Adaptar sem quebrar o nucleo

Todo fato de um projeto vive em .squad/profile.md (gerado por /squad:onboard). Precisa mudar como um papel se comporta neste projeto especifico? /squad:fork <papel> cria .squad/agents/<papel>.md — o overlay vence para fatos do projeto, o nucleo vence para processo e regras inviolaveis. Editar arquivo deste repo para caber num projeto e a falha que quebra todos os outros projetos de uma vez.