feature-planner

Installation
SKILL.md

Feature Planner

Skill para planificar nuevas funcionalidades mediante un proceso estructurado de entrevista y documentacion.

Workflow

Paso 1: Entender el Feature

Cuando el usuario describe una funcionalidad (ej: "quiero agregar dark mode"):

  1. Crear borrador inicial en /docs/wip/<feature-name>-plan.md usando la estructura de references/plan-template.md
  2. Capturar la idea principal del usuario en el documento
  3. Identificar informacion faltante para la implementacion

Paso 2: Entrevistar al Usuario

Hacer preguntas directamente al usuario para obtener todos los detalles necesarios.

Areas a cubrir:

Area Preguntas Clave
Funcionalidad Que debe hacer exactamente? Que no debe hacer?
UI/UX Como interactua el usuario? Que ve?
Datos Que datos se necesitan? Donde se guardan?
Integraciones Que APIs o servicios externos?
Edge cases Que pasa si...? Escenarios limite
Restricciones Performance, seguridad, compatibilidad
Prioridad MVP vs nice-to-have

Tecnicas de entrevista:

  • No hacer preguntas obvias o que se puedan inferir del codigo
  • Profundizar en respuestas vagas ("podrias elaborar?")
  • Confirmar entendimiento antes de avanzar
  • Continuar hasta que el spec este completo

Referencia: Ver commands/dev/interview.md para el patron de entrevista completo.

Paso 3: Documentar el Spec

Una vez completada la entrevista, actualizar el documento en /docs/wip/<feature-name>-plan.md usando la plantilla completa de references/plan-template.md.

Cambiar el estado de BORRADOR a ESPECIFICADO cuando este completo.

Paso 4: Crear Tareas

Despues de documentar, crear items con TodoWrite:

  1. Analizar el spec y dividir en tareas atomicas
  2. Ordenar por dependencia (que debe hacerse primero)
  3. Estimar complejidad (pequena, mediana, grande)

Criterios para buenas tareas:

  • Cada tarea es independiente o tiene dependencias claras
  • Se puede completar en una sesion
  • Tiene criterio de aceptacion implicito
  • Sigue el orden logico de implementacion

Paso 5: Validar Estado Actual (Opcional)

Si el proyecto tiene scripts de validacion, verificar si existe npm run check o similar en los scripts de package.json.

Si existe:

  1. Preguntar al usuario si desea ejecutar validacion
  2. Ejecutar el script
  3. Reportar issues encontrados antes de implementar
  4. Documentar en el plan cualquier deuda tecnica relevante

Notas Importantes

  • No implementar durante la planificacion
  • Ser exhaustivo en la entrevista, no asumir
  • Documentar decisiones y su justificacion
  • Mantener el documento actualizado durante la implementacion
  • El documento queda en /docs/wip/ hasta que el feature este completo
Related skills

More from testacode/llm-toolkit

Installs
27
First Seen
Jan 23, 2026