The Official Workflow
5 CAPAS · 23 PASOS · 1 PROCESO
El proceso completo para desarrollar software con IA en InnovaFamily. Desde la necesidad de negocio hasta el release en producción, cada paso tiene un artefacto verificable y un agente que lo ejecuta.
Business Layer
4 pasosDefine el problema antes de resolver nada.
Todo cambio parte de una necesidad de negocio. Esta capa captura el contexto, el usuario afectado y las condiciones de éxito antes de escribir una sola línea de código.
Product Discovery
Sesión para entender el problema, el usuario y el valor esperado del cambio.
Contexto de Negocio
Documento que explica el problema, el contexto del usuario, impacto esperado y métricas de éxito.
contexto_negocio.mdVer templateHistoria de Usuario
Narrativa del feature desde la perspectiva del usuario. Define el qué, no el cómo.
historia_usuario.mdVer templateCriterios de Aceptación
Lista de condiciones verificables que determinan cuándo el feature está completo.
criterios_aceptacion.mdVer templateSpecification Layer
6 pasosOpenSpec como fuente de verdad del cambio.
Convierte el contexto de negocio en especificaciones técnicas precisas. Los documentos de esta capa son el insumo principal para los agentes de IA en la ejecución.
OpenSpec Proposal
Propuesta inicial del cambio: motivación, alternativas descartadas y decisión tomada.
proposal.mdOpenSpec Design
Diseño técnico: arquitectura, modelo de datos, contratos API y decisiones de implementación.
design.mdArquitectura
Diagrama y descripción de los componentes, sus responsabilidades y relaciones.
arquitectura.mdVer templateModelo de Datos
Entidades, atributos, relaciones y consideraciones de migración.
modelo_datos.mdVer templateContrato API
Endpoints, request/response, autenticación y códigos de error.
contrato_api.mdVer templateOpenSpec Specs
Especificaciones detalladas del feature en el directorio specs/ del OpenSpec.
specs/feature-spec.mdExecution Layer
4 pasosImplementación guiada por especificaciones y agentes.
Con las especificaciones listas, los agentes de IA pueden implementar con contexto claro. Esta capa define el plan de trabajo y las herramientas de ejecución.
Execution Plan
Desglose del feature en tareas pequeñas, ordenadas y ejecutables de forma independiente.
tasks.mdVer templateTasks
Tareas atómicas asignadas a agentes o desarrolladores con contexto suficiente para ejecutar.
Codex / Claude Code
Agentes de IA que implementan las tareas usando las especificaciones como contexto primario.
Skills
Skills reutilizables que el agente puede invocar durante la implementación.
Quality Layer
5 pasosNingún cambio pasa sin validación explícita.
Cada gate de calidad tiene un checklist verificable. La calidad no es una fase final, es una condición en cada paso del proceso.
Code Review
Revisión de código contra las especificaciones, estándares de arquitectura y buenas prácticas.
checklist_pr.mdVer templateTesting
Ejecución del plan de pruebas: unitarias, integración y end-to-end.
plan_pruebas.mdVer templateSecurity Review
Revisión de vulnerabilidades, manejo de datos sensibles y cumplimiento de políticas.
Quality Gates
Validaciones automáticas y manuales que deben pasar antes del merge.
UAT
Validación con el usuario final o PO en ambiente staging antes del release.
Delivery Layer
4 pasosEntrega trazable, documentada y reversible.
El cambio llega a producción con evidencia completa: PR documentado, release notes y retrospectiva para mejorar el proceso.
Pull Request
PR con descripción completa, evidencia de testing y referencias al OpenSpec del cambio.
checklist_pr.mdVer templateRelease Notes
Resumen del cambio para stakeholders: qué cambió, por qué y cómo verificarlo.
release_notes.mdVer templateChangelog
Registro técnico del cambio en el historial del repositorio y del framework.
Retrospective
Aprendizajes del proceso: qué funcionó, qué mejorar y decisiones para el equipo.
retrospective.mdVer template