Flujo de Trabajo de IA Estructurado con Comandos por Fases para Reducir Retrabajo

Un desarrollador en r/ClaudeAI describe un flujo de trabajo repetible y programable diseñado para abordar problemas persistentes al usar IA para el desarrollo diario. El problema central identificado no era necesitar un modelo más inteligente, sino necesitar un proceso repetible para dejar de corregir los mismos errores. Los puntos de dolor clave incluían que la IA perdiera contexto entre sesiones, incumpliera los estándares del proyecto en aspectos básicos como nomenclatura y estilo, mezclara la planificación con la ejecución y tratara la documentación como una idea tardía.

Flujo de trabajo por comandos basados en fases

La solución reemplaza la dependencia de un único prompt gigante con una serie de comandos claros y específicos por fase:

• /pwf-brainstorm – Define el alcance, la arquitectura y las decisiones.
• /pwf-plan – Convierte la lluvia de ideas en fases y tareas ejecutables.
• Puertas de calidad opcionales: /pwf-checklist, /pwf-clarify, /pwf-analyze.
• /pwf-work-plan – Ejecuta el plan fase por fase.
• /pwf-review – Realiza una revisión más profunda.
• /pwf-commit-changes – Cierra la tarea con commits estructurados.

Para tareas pequeñas, el desarrollador usa /pwf-work pero mantiene la disciplina de revisión y documentación.

La regla crítica

La regla que tuvo el impacto más significativo en la calidad: /pwf-work y /pwf-work-plan deben leer la documentación antes de la implementación y actualizarla después. Esto asegura que la IA trabaje con "memoria del proyecto" en lugar de "medio ciega", mejorando dramáticamente la consistencia y reduciendo el retrabajo.

Estructura de proyecto de soporte

El flujo de trabajo está respaldado por una estructura de proyecto específica para mejorar el contexto de la IA:

• Una carpeta para repositorios de código.
• Una carpeta para activos del espacio de trabajo (documentos, controles, configuraciones).

Ambas carpetas se abren como multi-raíz en un editor (como VS Code o Cursor), creando una experiencia similar a un monorepositorio que ayuda a la IA a ver el sistema completo sin caos.

Resultados y referencias

El desarrollador reporta impactos directos: menos errores repetidos, menos retrabajo, mejor consistencia entre sesiones y más producción con menos errores. Mencionó cerrar 25 tareas (pequeñas, medianas, grandes) en un día al evitar el mismo ciclo de errores. El enfoque se basó en estudiar conceptos como Compound Engineering, Superpowers, Spec Kit y Spec-Driven Development, pero se adaptó y refinó a través del uso personal en lugar de copiar un marco.