Agent-Skills.md

Agent Skills: Feature Planner

Planifica features con entrevista estructurada y crea tareas. Este skill se activa cuando el usuario dice "quiero agregar", "planificar feature", "nueva funcionalidad", "implementar esto", "crear plan", "planificar antes de codear", "disenar feature", "como deberia implementar esto", "pensar la arquitectura", o quiere alinear antes de escribir codigo.

UncategorizedID: testacode/llm-toolkit/feature-planner

Repository

testacode/llm-toolkit
testacodeLicense: Apache-2.0

Install this agent skill to your local

pnpm dlx add-skill https://github.com/testacode/llm-toolkit/tree/HEAD/skills/feature-planner

Skill Files

Browse the full folder contents for feature-planner.

Download Skill

Loading file tree…

skills/feature-planner/SKILL.md

Skill Metadata

Name
feature-planner
Description
Planifica features con entrevista estructurada y crea tareas. Este skill se activa cuando el usuario dice "quiero agregar", "planificar feature", "nueva funcionalidad", "implementar esto", "crear plan", "planificar antes de codear", "disenar feature", "como deberia implementar esto", "pensar la arquitectura", o quiere alinear antes de escribir codigo.

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