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 enSPRINT_CONSTITUTION_FILES(en orden). - De lo contrario, lee los archivos
AGENTS.mdyCLAUDE.mdque existan (y cualquier guía específica del proyecto a la que hagan referencia, p. ej., unCLAUDE.mddel frontend). - Ojea
.githooks/README.mdsi 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>); ejecutacodegraph 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:
- una tarea imperativa clara (sin pregunta),
- el nivel de riesgo,
- un criterio de finalización concreto (qué prueba específica debe estar verde / qué comportamiento es verificable),
- 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 deTODO.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.mdinicia 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.