Sprint Orchestrator

Sprint Orchestrator

Padrão portátil de orquestração de sprints de software validado em 17+ sprints reais. Separa estratégia (orquestrador) de execução (sprint chats) em chats diferentes pra evitar context bloat e maximizar paralelismo.

Quando usar

• Usuário diz "próximo sprint", "novo sprint", "vamos pro sprint N — tema X"
• Usuário pede pra "orquestrar X em outro chat"
• Trabalho > 2 horas estimado, com escopo definível
• Há decisões batidas que podem ser cristalizadas em plano

Quando NÃO usar

• Bug fix trivial (/scripts/init.sh. Detalhes de instalação no README.md`.

Workflow nas 4 fases

Ver detalhes em core/workflow.md. Resumo:

1. PLAN — orchestrator brainstorma com user, escreve plano usando templates/plan/.md, commita em main + push.
2. DISPATCH — orchestrator roda scripts/create-worktree.sh N que cria worktree + state.md + scheduled task + abre Claude Code novo via URL scheme.
3. EXECUTE — sprint chat (Claude novo) lê plano, executa, valida E2E (quando aplicável), abre PR, atualiza state.md.
4. REVIEW+DEPLOY — scheduled task detecta PR aberto, abre sessão nova do orchestrator que faz review + merge + deploy + state.md update.

Ambientes suportados (multi-IDE)

A skill funciona em qualquer ambiente onde Claude esteja disponível. O dispatch da Fase 2 (abrir novo sprint chat) auto-detecta o IDE/terminal atual e adapta:

| Ambiente | Como o dispatch funciona | |---|---| | Claude Code standalone (Terminal/iTerm) | URL scheme claude-cli:// abre nova janela com prompt já rodando | | Cursor | Abre worktree em nova janela Cursor + copia prompt → você dá ⌘L (nova chat) + cola | | VS Code + Claude extension | Abre worktree em VS Code + copia prompt → comando "Claude: New Chat" + cola | | Antigravity (Google) | Copia prompt + instrução pra abrir nova aba com working dir setado | | Windsurf (Codeium) | Abre worktree em Windsurf + copia prompt → nova Cascade chat + cola | | Outros | Clipboard puro + arquivo temporário com prompt + instruções genéricas |

Pra forçar um método específico, define dispatch.method no profile. Default auto detecta sozinho via env vars (TERM_PROGRAM, CURSOR_TRACE_ID, VSCODE_PID, etc.) e process tree.

Como ler esta skill (pra Claude)

Quando o user invocar esta skill:

1. Leia .sprint-orchestrator.yml do projeto consumidor.

• Se não existe: ofereça rodar scripts/init.sh antes de continuar.

1. Sempre carregue todo core/ (workflow, multi-agent-strategy, conventional-commits, anti-patterns, adversarial-review).
2. Para cada addon listado em profile.addons[]: leia addons//README.md agora; leia outros arquivos do addon just-in-time quando a fase relevante chegar.
3. Use templates do templates/plan/.md quando user pedir plano novo (default: feature.md).
4. Use templates/prompt-dispatch.md quando for hora de dispatch.
5. Consulte checklists/ ao iniciar cada fase (pre-dispatch, post-pr-review, deploy-prod, capture-learnings).

Workflows avançados (opcionais)

• Adversarial review (core/adversarial-review.md) — 3º Claude isolado revisa PR adversarialmente, posta comments. Você vira arbitrador, não reviewer. Ativa via profile.adversarial_review.enabled: true.
• Preview deploy + auto-validation (addons/github-actions/preview-validation/) — quando PR abre, GitHub Action faz preview deploy + Playwright contra URL preview + posta PR comment estruturado. Mata o polling do "PR aberto?". Ativa via profile.github-actions.preview_validation: true.
• Capture learnings (checklists/capture-learnings.md) — após cada deploy, orquestrador triagia bugs fixados durante sprint e propõe adição às addons//bug-patterns.md. Loop de auto-melhoria da skill.
• Visual dashboard (scripts/dashboard/) — kanban board local renderizado a partir do state.md. Modos: estático / live server (--serve) / multi-project workspace (--workspace). Roda 100% local, zero tokens Claude. Invoque com bash /scripts/dashboard.sh.

Modos adaptativos

A skill escolhe entre 2 modos conforme context window + tamanho do sprint:

• monolithic — orquestrador + execução no mesmo chat (aproveita 1M). Worktree mantido, subagents só pra áreas disjuntas.
• split — 2 chats (orquestrador + sprint chat separado via URL scheme). Necessário em 200k.

mode: auto (default) decide: 200k → split; 1m → monolithic pra sprint pequeno/médio, split pra épico. Anuncia a decisão e aceita veto. Heurística completa em core/workflow.md.

Profile antigo sem bloco model: → assume 200k + split (backward compat). Addon opcional full-context carrega o repo inteiro no contexto quando em 1m.

Profile schema (resumo)

Arquivo .sprint-orchestrator.yml na raiz do projeto consumidor. Schema versionado (atual: v1). Ver CHANGELOG.md pra mudanças de versão.

version: 1
project_name: string            # obrigatório
default_branch: main

model:
  context_window: 1m            # 1m | 200k (perguntado no init.sh)
  mode: auto                    # auto | monolithic | split

paths:
  plans: docs/superpowers/plans
  worktrees: .claude/worktrees
  memory: ~/.claude/projects//memory

smoke:
  local: bin/smoke-local.sh     # opcional
  ci_workflow: smoke-e2e.yml    # opcional

git:
  worktree_prefix: sprint
  pr_title_prefix: "feat(sprint-N):"
  conventional_commits: true
  semantic_release: false

dispatch:
  method: auto                  # auto (detect IDE) | claude-cli | claude-desktop |
                                # cursor | vscode | antigravity | windsurf | clipboard-only

addons: [postgres, nextjs, e2e-validation, github-actions]

notifications:                   # opt-in
  github_assignee: null
  github_label: ready-for-review
  macos: false
  webhook: null
  email: null

# Workflows avançados (opt-in)
adversarial_review:
  enabled: true                  # 3º Claude reviewer adversarial pré-merge
  skip_types: [infra]            # tipos de sprint que pulam
  reviewer_model: sonnet         # ou opus pra sprints críticos
  max_comments: 8

github-actions:
  preview_validation: true       # GitHub Action faz preview deploy + Playwright
  preview_platform: vercel       # vercel | fly | railway | coolify | generic

# Overrides por addon (todos opcionais)
postgres:
  service_role: platform_admin

Defaults sensatos pra tudo exceto version e project_name. Ver examples/ pra perfis de referência completos.

Anti-padrões críticos

Ver core/anti-patterns.md pra lista cross-cutting + addons//bug-patterns.md pra stack-specific.

OSS

Esta skill é open-source MIT licensed. Veja README.md pra instalação em projeto novo, ou examples/ pra perfis de referência.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: lipefur
• Source: lipefur/sprint-orchestrator
• License: MIT

Install and usage instructions live in the source repository linked above.