idd-plan
Skill0 starsChanged 4 days agoMITView on GitHub
Fase Plan del flujo IDD (Issue-Driven Development). Convierte un ítem de Notion, Linear, GitHub Issues/Projects o un .md local en un plan de implementación detallado: requisitos con escenarios, diseño, archivos verificados, tareas y verificación. No toca código.
In this repository22 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- git-cleanupSkill
- skill-creatorSkill
- astro-architectureSkill
- monorepo-architectureSkill
- nestjs-architectureSkill
- nextjs-architectureSkill
- react-native-architectureSkill
- gh-cliSkill
- git-cleanupSkill
- backend-best-practicesSkill
- clean-codeSkill
- code-quality-reviewSkill
- design-patternsSkill
- frontend-best-practicesSkill
- solid-principlesSkill
- tdd-workflowSkill
- ssh-connectSkill
- ts-import-organizerSkill
- idd-applySkill
- idd-exploreSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 86
No empezar la implementación, aunque la petición original lo insinúe.
- Very specific: line 95
Rutas verificadas: no inventar archivos; lo nuevo se marca (nuevo).
- Very specific: line 98
Un solo lugar por cambio: no duplicar el plan en el tracker y en un .md local.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
IDD Plan
🎯 Propósito
Segunda fase del flujo IDD (Issue-Driven Development): idd-explore → idd-plan → idd-apply.
Produce un plan muy detallado y verificable antes de escribir una sola línea de código, siguiendo los principios de Spec-Driven Development: la especificación va primero, cada requisito tiene escenarios comprobables y cada tarea se enlaza a un requisito. El plan se guarda en el mismo ítem del tracker (o en el .md local si no hay tracker) y se convierte en la fuente de verdad para idd-apply.
⚡ Cuándo Activar esta Skill
Activa esta skill cuando el usuario:
- Pida planificar, especificar o diseñar la implementación de un ítem (
ENG-104,#42, URL de Notion o de GitHub Projects, ruta.md). - Diga "planifica este issue", "haz el plan de implementación", "spec this" o "idd plan".
- Acabe de terminar
idd-explorey quiera pasar a la siguiente fase.
Si el requerimiento es tan vago que no se pueden escribir requisitos, sugiere primero idd-explore.
📋 Flujo de Trabajo Paso a Paso
Paso 1: Localizar la Fuente
Detectar el proveedor como en la fase Explore (Notion, Linear, GitHub Issues/Projects, local). Los comandos exactos están en <skill-dir>/../idd-explore/references/adapters.md (<skill-dir> es el directorio que contiene este SKILL.md); resumen en la sección "Dónde se guarda" de references/plan-template.md.
Paso 2: Leer el Requerimiento
- Leer título, cuerpo y comentarios relevantes.
- Si ya existe la ficha de
idd-explore, reutilizarla como base (objetivo, restricciones, reglas, alcance, metadatos). - Si ya existe una sección
## 🛠️ Plan de Implementación, tratar la petición como una revisión del plan, no como uno nuevo.
Paso 3: Explorar el Repo (Solo Lectura)
- Localizar los módulos, archivos, tipos, tests y patrones que el cambio tocará o debe imitar.
- Identificar utilidades existentes que se puedan reutilizar en lugar de escribir código nuevo.
- Identificar cómo se verifica el proyecto (scripts de test, lint, build).
- No editar ningún archivo del proyecto.
Paso 4: Aclarar lo Esencial
Preguntar solo lo que cambie el alcance, el comportamiento observable, la compatibilidad o los criterios de aceptación. Para detalles menores, asumir algo razonable y registrarlo en Supuestos.
Paso 5: Elegir el Tamaño del Plan
- Plan corto (cambio pequeño: un solo módulo, hasta 3 tareas, sin cambios de datos, API pública ni dependencias): solo Contexto, Requisitos (1 o 2, con escenario), Tareas y Verificación. Usar la variante "Plan corto" de la plantilla.
- Plan completo: el resto de casos.
- Dividir: si el plan supera unas 12 tareas o mezcla entregables independientes, proponer partirlo en varios ítems (uno por entregable, cada uno con su propio plan y enlazados entre sí). No dividir ni crear ítems sin confirmación.
Ante la duda entre corto y completo, usar el completo.
Paso 6: Redactar el Plan
Seguir exactamente references/plan-template.md:
- Contexto: por qué y para qué.
- Requisitos: agrupados en
ADDED/MODIFIED/REMOVED; cada uno con "DEBE…" y al menos un escenario Dado / Cuando / Entonces. - Diseño y decisiones: enfoque elegido y la alternativa descartada en una línea.
- Archivos afectados: solo rutas verificadas (o marcadas como
(nuevo)). - Tareas:
- [ ] 1.1 …, pequeñas, ordenadas, cada una con su requisito (→ R1). - Verificación: comandos y comprobaciones concretas por escenario.
- Fuera de alcance, Supuestos, Preguntas abiertas y Metadatos (preservar estimación, fase, fechas y enlace a la fuente).
Paso 7: Puerta de Revisión
- Mostrar el plan completo en el chat e indicar dónde se va a guardar.
- Esperar la confirmación explícita del usuario antes de escribir.
Paso 8: Persistir (el tracker primero)
- Ítem de tracker: añadir o reemplazar la sección
## 🛠️ Plan de Implementaciónen la descripción del ítem o en el cuerpo de la página. Conservar la ficha deidd-explorey el resto del contenido. - Texto o
.md, pero con tracker conectado: ofrecer crear el ítem ahí; crearlo solo si el usuario acepta. - Sin tracker: añadir la sección al archivo
docs/specs/<YYYY-MM-DD>-<slug>.md(crearlo si no existe).
Paso 9: Detenerse
No empezar la implementación, aunque la petición original lo insinúe. Cerrar con:
"El plan está listo en <ubicación>. Cuando quieras, usa idd-apply para implementarlo."
⚠️ Reglas Críticas
- No editar código del proyecto: esta fase solo produce el plan.
- Puerta de revisión obligatoria: nada se escribe en el tracker ni en disco sin confirmación explícita.
- Rutas verificadas: no inventar archivos; lo nuevo se marca
(nuevo). - Requisitos comprobables: cada requisito tiene al menos un escenario; cada escenario se cubre en Verificación.
- Tareas trazables: cada tarea apunta a un requisito y es lo bastante pequeña para completarse y verificarse sola.
- Un solo lugar por cambio: no duplicar el plan en el tracker y en un
.mdlocal. - Preservar metadatos: estimaciones, fases y fechas de la fuente se mantienen.
- Proporcional al cambio: plan corto para cambios pequeños; proponer dividir los planes de más de unas 12 tareas.
📚 Referencias
- Plantilla del plan: estructura canónica, reglas de redacción y ejemplo.
- Adaptadores de proveedores:
<skill-dir>/../idd-explore/references/adapters.md(se instala conidd-explore).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

