Communitygithub.com

leonhoffmann86/team-sprint

🏃 Sprint — transforma cada TODO em uma mini-sprint completa: planejamento→implementação→revisão autônoma para Claude Code via cadeia de hooks git, worktree isolado, portão determinístico e revisão com falha controlada

O que é team-sprint?

Este skill transforma uma ideia bruta em uma tarefa bem definida no `TODO.md`, seguindo um fluxo de refinamento estruturado e autônomo. Ele é especialmente útil para desenvolvedores que usam Claude Code com hooks git e worktrees isolados, garantindo que cada tarefa passe por um mini-ciclo de planejamento, implementação e revisão sem intervenção manual constante. O skill lê arquivos de constituição do projeto (como `AGENTS.md`, `CLAUDE.md`, ou `sprint.conf`) para respeitar convenções e níveis de risco, mapeia o impacto no código real usando ferramentas como `codegraph` ou fallbacks com Grep/Glob, e desafia a ideia contra o que já existe, separando dúvidas de tarefas reais. Ao final, gera um item estruturado com imperativo claro, critério de aceitação e dicas de arquivos/funções, escreve no `TODO.md` e oferece ao usuário a opção de iniciar a cadeia de implementação autônoma — tudo sem escrever código ou comitar automaticamente.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add leonhoffmann86/team-sprint

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Você está transformando uma ideia bruta em uma tarefa bem formada no TODO.md. A ideia bruta:

$ARGUMENTS

Este é um fluxo de refinamento, não de implementação. Não escreva código. Não escreva no TODO.md até que a tarefa esteja clara e o usuário a tenha aprovado. Trabalhe nestas etapas:

1. Leia a constituição

Encontre os arquivos de constituição do projeto e leia-os — obedeça suas convenções, especialmente os níveis de risco e quaisquer regras de agente autônomo / ciclo de vida do TODO.

  • Se sprint.conf existir, leia os arquivos listados em SPRINT_CONSTITUTION_FILES (em ordem).
  • Caso contrário, leia os arquivos AGENTS.md, CLAUDE.md que existirem (e qualquer guia específico do projeto que eles referenciarem, ex.: um CLAUDE.md de frontend).
  • Dê uma olhada em .githooks/README.md se presente, para descrever corretamente o efeito downstream. Se nenhum desses existir, informe ao usuário que o repositório ainda não foi inicializado e ofereça /sprint:bootstrap.

2. Fundamente a ideia no código real (não adivinhe)

Encontre os símbolos/arquivos reais que a ideia toca e seu raio de impacto:

  • Grafo de código (preferencial, se disponível): as ferramentas mcp__codegraph__* (codegraph_search, …_callers, …_callees, …_impact, …_context), ou a CLI (codegraph context "<a ideia>", codegraph callers <símbolo>, codegraph impact <símbolo>); execute codegraph sync . primeiro se o índice parecer desatualizado.
  • Fallback (sem grafo de código): use Grep/Glob para localizar os símbolos relevantes e seus chamadores. Leia os poucos arquivos que realmente importam. Nomeie funções/arquivos concretos e onde a mudança ocorrerá.

3. Interrogue-a (o coração deste skill)

Desafie a ideia contra o que o código já faz. Traga à tona:

  • É uma pergunta ou uma tarefa? Se for realmente uma pergunta ("…ou estou perdendo algo?"), responda-a a partir do código primeiro — a lógica existente pode já cobrir parte dela.
  • O escopo real e a menor mudança que entrega valor.
  • O nível de risco (conforme a constituição / AGENTS.md). Se for de alto risco, diga — ele não será implementado automaticamente; a cadeia o delega a um humano.
  • As decisões que são do usuário, não suas (escolhas de produto/UX/política). Pergunte ao usuário essas poucas decisões com AskUserQuestion. Não invente respostas para decisões genuínas de produto; corrija suposições erradas usando evidências do codebase.

4. Esboce UM item estruturado (os quatro ingredientes)

Escreva um rascunho com:

  1. uma tarefa imperativa clara (sem pergunta),
  2. o nível de risco,
  3. um critério de aceitação concreto (qual teste específico deve passar / qual comportamento é verificável),
  4. dicas de arquivos/funções da etapa 2. Mantenha a menor mudança valiosa. Mostre o rascunho e refine até o usuário ficar satisfeito.

5. Escreva no TODO.md e passe adiante

  • Adicione o item aprovado como uma entrada - [ ] perto do topo do TODO.md.
  • Pergunte se deve torná-lo o único item ativo — se sim, mova os outros itens atualmente ativos para dentro de um bloco <!-- … --> (ou sob ## 🚧 Adiado) conforme a convenção de salto, para que a cadeia pegue apenas este.
  • Não faça commit automaticamente. Informe ao usuário: fazer commit do TODO.md inicia a cadeia planejamento→implementação→revisão (a implementação vai para o branch impl, nada faz merge automático). Ofereça-se para fazer o commit se eles quiserem que o processo comece agora.

Mantenha o diálogo enxuto: fundamente primeiro, pergunte apenas as decisões que importam, depois escreva.

Habilidades Relacionadas