Communitygithub.com

leonhoffmann86/team-sprint

🏃 Sprint: cada elemento TODO obtiene un mini-sprint completo: plan→implementar→revisar de forma autónoma para Claude Code mediante una cadena de agentes git-hook, worktree aislado, compuerta determinista y revisión con cierre por fallo

¿Qué es team-sprint?

Este skill transforma cualquier elemento TODO en un mini-sprint autónomo completo, siguiendo un flujo de planificación, implementación y revisión. Está diseñado específicamente para Claude Code, aprovechando una cadena de agentes basada en git-hooks, worktrees aislados y compuertas deterministas que garantizan que solo los cambios aprobados pasen a producción. El skill primero refina una idea aproximada en una tarea bien formada dentro de `TODO.md`, luego ejecuta un ciclo de implementación en una rama separada y finalmente realiza una revisión con cierre por fallo. Soporta proyectos que ya tengan constitución (`sprint.conf`, `AGENTS.md`, `CLAUDE.md`) y se integra con herramientas de grafo de código como `codegraph` para un análisis preciso del impacto. Es útil para equipos que buscan automatizar flujos de trabajo de tareas con gobernanza incorporada, minimizando riesgos mediante la aplicación de reglas de riesgo y la deferencia a humanos en tareas de alto riesgo.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add leonhoffmann86/team-sprint

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Estás convirtiendo una idea aproximada en una tarea bien formada en TODO.md. La idea aproximada:

$ARGUMENTS

Este es un flujo de refinamiento, no una implementación. No escribas código. No escribas en TODO.md hasta que la tarea esté clara y el usuario la haya aprobado. Trabaja en estos pasos:

1. Lee la constitución

Encuentra los archivos de constitución del proyecto y léelos: obedece sus convenciones, especialmente los niveles de riesgo y cualquier regla sobre agentes autónomos / ciclo de vida TODO.

  • Si existe sprint.conf, lee los archivos listados en SPRINT_CONSTITUTION_FILES (en orden).
  • De lo contrario, lee los archivos AGENTS.md y CLAUDE.md que existan (y cualquier guía específica del proyecto a la que hagan referencia, p. ej., un CLAUDE.md del frontend).
  • Ojea .githooks/README.md si está presente, para describir correctamente el efecto posterior. Si ninguno de estos existe, dile al usuario que el repositorio aún no está preparado y ofrécele /sprint:bootstrap.

2. Fundamenta la idea en el código real (no adivines)

Encuentra los símbolos/archivos reales que la idea toca y su radio de impacto:

  • Grafo de código (preferido, si está disponible): las herramientas mcp__codegraph__* (codegraph_search, …_callers, …_callees, …_impact, …_context), o la CLI (codegraph context "<la idea>", codegraph callers <símbolo>, codegraph impact <símbolo>); ejecuta codegraph sync . primero si el índice parece desactualizado.
  • Alternativa (sin grafo de código): usa Grep/Glob para localizar los símbolos relevantes y sus llamadores. Lee los pocos archivos que realmente importan. Nombra funciones/archivos concretos y dónde cae el cambio.

3. Interrógala (el núcleo de este skill)

Desafía la idea frente a lo que el código ya hace. Pon de manifiesto:

  • ¿Es una pregunta o una tarea? Si es realmente una pregunta ("…o me estoy perdiendo algo?"), respóndela desde el código primero: la lógica existente puede cubrir ya parte de ella.
  • El alcance real y el cambio más pequeño que aporte valor.
  • El nivel de riesgo (según la constitución / AGENTS.md). Si es de alto riesgo, dilo: no se implementará automáticamente; la cadena lo difiere a un humano.
  • Las decisiones que debe tomar el usuario, no tú (elecciones de producto/UX/política). Haz al usuario esas pocas decisiones con AskUserQuestion. No inventes respuestas a decisiones genuinas de producto; corrige suposiciones erróneas usando evidencia del código.

4. Redacta UN elemento estructurado (los cuatro ingredientes)

Escribe un borrador con:

  1. una tarea imperativa clara (sin pregunta),
  2. el nivel de riesgo,
  3. un criterio de finalización concreto (qué prueba específica debe estar verde / qué comportamiento es verificable),
  4. pistas de archivos/funciones del paso 2. Mantén el cambio más pequeño que aporte valor. Muestra el borrador y refínalo hasta que el usuario esté satisfecho.

5. Escríbelo en TODO.md, luego entrega

  • Añade el elemento aprobado como una entrada - [ ] cerca del principio de TODO.md.
  • Pregunta si debe ser el único elemento activo: si es así, mueve los otros elementos actualmente activos a un bloque <!-- … --> (o bajo ## 🚧 Diferido) según la convención de salto, para que la cadena recoja solo este.
  • No hagas commit automáticamente. Dile al usuario: hacer commit de TODO.md inicia la cadena plan→implementar→revisar (la implementación se deposita en la rama impl, nada se fusiona automáticamente). Ofrécete a hacer commit si quiere que el proceso comience ahora.

Mantén el diálogo conciso: primero fundamenta, luego pregunta solo las decisiones que importan, luego escribe.

Skills relacionados