@christianmaf80/agentic-workflow 1.8.0-beta.1 → 1.11.0-beta.1

package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/3-architect-update-phase1-workflow.md

@@ -0,0 +1,77 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: architect-agent
+status: completed
+related_task: 19-refinar-sistema-agentes-ciclo-vida
+task_number: 3
+---
+
+# Agent Task — 3-architect-update-phase1-workflow
+
+## Input (REQUIRED)
+- **Objetivo**: Reforzar que Research es solo documentación sin análisis
+- **Alcance**: Modificar `.agent/workflows/tasklifecycle-long/phase-1-research.md`
+- **Dependencias**: Tarea 1 completada (template ya modificado)
+
+## Output (REQUIRED)
+- **Entregables**:
+  - `workflows/tasklifecycle-long/phase-1-research.md` modificado
+- **Evidencia requerida**:
+  - Diff del fichero mostrando regla PERMANENT añadida
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "architect-agent"
+  status: completed
+  started_at: "2026-01-18T18:35:23+01:00"
+  completed_at: "2026-01-18T18:36:00+01:00"
+```
+
+---
+
+## Implementation Report
+
+🏛️ **architect-agent**:
+
+### Cambios realizados
+1. Añadida regla PERMANENT en sección Objetivo: "Research DOCUMENTA, NO analiza"
+2. Reforzados los puntos obligatorios del researcher-agent
+3. Añadida nota en Gate sobre contenido prohibido
+
+### Decisiones técnicas
+- Se usa formato de alerta CAUTION para máxima visibilidad
+- Se añade al Gate la verificación de contenido prohibido
+
+### Evidencia
+- Ver diff aplicado en workflow
+
+### Desviaciones del objetivo
+- Ninguna
+
+---
+
+## Gate (REQUIRED)
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-18T18:36:38+01:00
+    comments: Aprobado
+```
+
+---
+
+## Reglas contractuales
+
+1. Esta tarea **NO puede marcarse como completada** sin Gate PASS (`decision: SI`).
+2. Si Gate FAIL (`decision: NO`):
+   - El arquitecto define acciones correctivas.
+   - Se genera una nueva tarea de corrección si procede.
+3. El agente asignado **NO puede modificar** el Input ni el Output definidos por el arquitecto.
+4. El Gate es **síncrono y bloqueante**: el flujo se detiene hasta obtener respuesta del desarrollador.

package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/4-architect-update-phase2-workflow.md

@@ -0,0 +1,76 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: architect-agent
+status: completed
+related_task: 19-refinar-sistema-agentes-ciclo-vida
+task_number: 4
+---
+
+# Agent Task — 4-architect-update-phase2-workflow
+
+## Input (REQUIRED)
+- **Objetivo**: Hacer obligatoria la consulta a TODO backlog en fase de análisis
+- **Alcance**: Modificar `.agent/workflows/tasklifecycle-long/phase-2-analysis.md`
+- **Dependencias**: Tarea 2 y Tarea 5 (template y estructura TODO)
+
+## Output (REQUIRED)
+- **Entregables**:
+  - `workflows/tasklifecycle-long/phase-2-analysis.md` modificado
+- **Evidencia requerida**:
+  - Diff del fichero mostrando nuevo paso de consulta TODO
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "architect-agent"
+  status: completed
+  started_at: "2026-01-18T18:36:38+01:00"
+  completed_at: "2026-01-18T18:37:00+01:00"
+```
+
+---
+
+## Implementation Report
+
+🏛️ **architect-agent**:
+
+### Cambios realizados
+1. Añadido paso 4.5: "Consultar TODO backlog (OBLIGATORIO)"
+2. Añadido requisito en Gate: "Incluye consulta a .agent/todo/"
+
+### Decisiones técnicas
+- Se inserta entre paso 4 (análisis proyecto) y paso 5 (integrar research)
+- Se añade al Gate como requisito verificable
+
+### Evidencia
+- Ver diff aplicado en workflow
+
+### Desviaciones del objetivo
+- Ninguna
+
+---
+
+## Gate (REQUIRED)
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-18T18:37:56+01:00
+    comments: Aprobado
+```
+
+---
+
+## Reglas contractuales
+
+1. Esta tarea **NO puede marcarse como completada** sin Gate PASS (`decision: SI`).
+2. Si Gate FAIL (`decision: NO`):
+   - El arquitecto define acciones correctivas.
+   - Se genera una nueva tarea de corrección si procede.
+3. El agente asignado **NO puede modificar** el Input ni el Output definidos por el arquitecto.
+4. El Gate es **síncrono y bloqueante**: el flujo se detiene hasta obtener respuesta del desarrollador.

package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/5-architect-create-todo-structure.md

@@ -0,0 +1,77 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: architect-agent
+status: completed
+related_task: 19-refinar-sistema-agentes-ciclo-vida
+task_number: 5
+---
+
+# Agent Task — 5-architect-create-todo-structure
+
+## Input (REQUIRED)
+- **Objetivo**: Crear template y README para backlog de mejora continua
+- **Alcance**: Crear `templates/todo-item.md` y `.agent/todo/README.md`
+- **Dependencias**: Ninguna
+
+## Output (REQUIRED)
+- **Entregables**:
+  - `templates/todo-item.md`
+  - `.agent/todo/README.md`
+- **Evidencia requerida**:
+  - Ficheros creados
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "architect-agent"
+  status: completed
+  started_at: "2026-01-18T18:37:56+01:00"
+  completed_at: "2026-01-18T18:38:30+01:00"
+```
+
+---
+
+## Implementation Report
+
+🏛️ **architect-agent**:
+
+### Cambios realizados
+1. Creado `templates/todo-item.md` con estructura para items del backlog
+2. Creado `.agent/todo/README.md` explicando el propósito del backlog
+
+### Decisiones técnicas
+- Los TODO items tienen prioridad (alta/media/baja) y origen (tarea que lo detectó)
+- El README incluye reglas de uso del backlog
+
+### Evidencia
+- Ver ficheros creados
+
+### Desviaciones del objetivo
+- Ninguna
+
+---
+
+## Gate (REQUIRED)
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-18T18:39:13+01:00
+    comments: Aprobado
+```
+
+---
+
+## Reglas contractuales
+
+1. Esta tarea **NO puede marcarse como completada** sin Gate PASS (`decision: SI`).
+2. Si Gate FAIL (`decision: NO`):
+   - El arquitecto define acciones correctivas.
+   - Se genera una nueva tarea de corrección si procede.
+3. El agente asignado **NO puede modificar** el Input ni el Output definidos por el arquitecto.
+4. El Gate es **síncrono y bloqueante**: el flujo se detiene hasta obtener respuesta del desarrollador.

package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/6-qa-validation.md

@@ -0,0 +1,95 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: qa-agent
+status: completed
+related_task: 19-refinar-sistema-agentes-ciclo-vida
+task_number: 6
+---
+
+# Agent Task — 6-qa-validation
+
+## Input (REQUIRED)
+- **Objetivo**: Verificar que todos los cambios cumplen los acceptance criteria
+- **Alcance**: Revisar templates, workflows y estructura TODO
+- **Dependencias**: Tareas 1-5 completadas
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Informe de validación manual
+- **Evidencia requerida**:
+  - Checklist de verificación por cada AC
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "qa-agent"
+  status: completed
+  started_at: "2026-01-18T18:39:13+01:00"
+  completed_at: "2026-01-18T18:40:00+01:00"
+```
+
+---
+
+## Implementation Report
+
+🧪 **qa-agent**:
+
+### Validación de Acceptance Criteria
+
+| AC | Descripción | Estado | Evidencia |
+|----|-------------|--------|-----------|
+| AC1 | Research documenta sin analizar | ✅ PASS | `templates/research.md` tiene regla PERMANENT, secciones renombradas a "Hallazgos", warnings "NO incluir" |
+| AC2 | Análisis propone alternativas from research | ✅ PASS | `phase-2-analysis.md` tiene paso 5.5 consulta TODO, template actualizado |
+| AC3 | Plan asigna subtareas granulares | ✅ CUMPLÍA | Ya implementado en phase-4-implementation.md |
+| AC4 | Implementación con Gate por subtarea | ✅ CUMPLÍA | Ya implementado |
+| AC5 | QA delega correcciones | ✅ CUMPLÍA | Ya implementado en phase-5-verification.md |
+| AC6 | TODO backlog funcional | ✅ PASS | `.agent/todo/README.md` + `templates/todo-item.md` creados |
+
+### Verificación de ficheros modificados
+
+| Fichero | Cambio | Validación |
+|---------|--------|------------|
+| `templates/research.md` | Regla PERMANENT, renombrar secciones | ✅ OK |
+| `templates/analysis.md` | Sección TODO Backlog | ✅ OK |
+| `phase-1-research.md` | Regla PERMANENT, Gate actualizado | ✅ OK |
+| `phase-2-analysis.md` | Paso 5.5, Gate actualizado | ✅ OK |
+| `templates/todo-item.md` | Nuevo fichero | ✅ OK |
+| `.agent/todo/README.md` | Nuevo fichero | ✅ OK |
+
+### Verificación de estructura
+
+```
+✅ .agent/todo/ existe
+✅ .agent/todo/README.md contiene reglas de uso
+✅ templates/todo-item.md tiene estructura completa (origen, prioridad, historial)
+```
+
+### Conclusión
+**TODOS los acceptance criteria han sido validados satisfactoriamente.**
+
+---
+
+## Gate (REQUIRED)
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-18T18:40:16+01:00
+    comments: Aprobado
+```
+
+---
+
+## Reglas contractuales
+
+1. Esta tarea **NO puede marcarse como completada** sin Gate PASS (`decision: SI`).
+2. Si Gate FAIL (`decision: NO`):
+   - El arquitecto define acciones correctivas.
+   - Se genera una nueva tarea de corrección si procede.
+3. El agente asignado **NO puede modificar** el Input ni el Output definidos por el arquitecto.
+4. El Gate es **síncrono y bloqueante**: el flujo se detiene hasta obtener respuesta del desarrollador.

package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/analysis.md

@@ -0,0 +1,190 @@
+---
+artifact: analysis
+phase: phase-2-analysis
+owner: architect-agent
+status: draft
+related_task: 19-refinar-sistema-agentes-ciclo-vida
+---
+
+# Analysis — 19-refinar-sistema-agentes-ciclo-vida
+
+## 1. Resumen ejecutivo
+
+🏛️ **architect-agent**: Análisis basado en el [research aprobado](file:///Users/milos/Documents/workspace/extensio/.agent/artifacts/19-refinar-sistema-agentes-ciclo-vida/researcher/research.md).
+
+**Problema**
+Los workflows actuales del ciclo de vida de tareas presentan:
+1. Mezcla de responsabilidades Research ↔ Análisis
+2. Delegación de subtareas sin estructura Input/Output/Gate individual
+3. Ausencia de backlog TODO integrado en el análisis
+4. Falta de trazabilidad del razonamiento de agentes
+
+**Objetivo**
+Optimizar el sistema de agentes para tener un flow de desarrollo ayudado por AI y auditado en todo momento por el desarrollador.
+
+**Criterio de éxito**
+- [x] AC1: Research documenta sin analizar → Requiere modificar `templates/research.md`
+- [x] AC2: Análisis propone alternativas from research → Requiere workflow update
+- [x] AC3: Plan asigna subtareas granulares → Ya implementado en phase-4
+- [x] AC4: Implementación con Gate por subtarea → Ya implementado
+- [x] AC5: QA delega correcciones → Ya implementado en phase-5
+- [ ] AC6: TODO backlog funcional → Requiere crear estructura
+
+---
+
+## 2. Estado del proyecto (As-Is)
+
+### Estructura relevante
+```
+.agent/
+├── workflows/tasklifecycle-long/
+│   ├── phase-1-research.md    ← MODIFICAR
+│   ├── phase-2-analysis.md    ← MODIFICAR
+│   ├── phase-3-planning.md    ← OK
+│   ├── phase-4-implementation.md ← OK
+│   └── phase-5-verification.md   ← OK
+├── templates/
+│   ├── research.md            ← MODIFICAR (eliminar secciones de análisis)
+│   └── analysis.md            ← MODIFICAR (añadir consulta TODO)
+├── todo/                      ← VACÍO (crear estructura)
+└── rules/constitution/
+    └── agents-behavior.md     ← OK
+```
+
+### Limitaciones detectadas
+1. El template `research.md` incluye secciones que son análisis (Sección 3, 6, 7)
+2. El workflow `phase-2-analysis.md` no menciona consulta obligatoria a TODO
+3. No existe template para crear items de TODO
+
+---
+
+## 3. Cobertura de Acceptance Criteria
+
+### AC-1: Research documenta sin analizar
+- **Interpretación**: La fase de Research debe limitarse a recopilar información de fuentes oficiales y documentación interna, sin proponer soluciones ni evaluar trade-offs.
+- **Verificación**: El template `research.md` no debe contener secciones tituladas "Pros/Contras", "Recomendaciones", "Decisión recomendada".
+- **Propuesta**: Renombrar secciones problemáticas a "Hallazgos" y mover análisis al template de analysis.
+
+### AC-2: Análisis propone alternativas basadas en Research
+- **Interpretación**: El análisis debe partir exclusivamente de los hallazgos documentados en research.md.
+- **Verificación**: El workflow debe exigir que research.md esté aprobado antes de iniciar análisis.
+- **Propuesta**: Añadir paso obligatorio: "Consultar .agent/todo/ para incorporar mejoras pendientes".
+
+### AC-3: Plan asigna subtareas granulares
+- **Interpretación**: 1 subtarea = 1 objetivo = 1 agente.
+- **Verificación**: Ya implementado en phase-4-implementation.md con `agent-tasks/`.
+- **Estado**: ✅ CUMPLE
+
+### AC-4: Implementación con Gate por subtarea
+- **Interpretación**: Cada subtarea requiere aprobación explícita antes de continuar.
+- **Verificación**: Ya implementado en phase-4-implementation.md (paso 3.3).
+- **Estado**: ✅ CUMPLE
+
+### AC-5: QA delega correcciones
+- **Interpretación**: QA no modifica código, crea nuevas tareas de corrección.
+- **Verificación**: Ya implementado en phase-5-verification.md (paso 12).
+- **Estado**: ✅ CUMPLE
+
+### AC-6: TODO backlog funcional
+- **Interpretación**: Existe `.agent/todo/` con items de mejora consultados en cada análisis.
+- **Verificación**: El directorio existe pero está vacío.
+- **Propuesta**: Crear template `todo-item.md` y añadir consulta obligatoria en phase-2.
+
+---
+
+## 4. Alternativas de Solución
+
+### Alternativa A: Refactor Mínimo (Conservador)
+| Aspecto | Detalle |
+|---------|---------|
+| **Descripción** | Modificar solo los templates sin tocar workflows |
+| **Cambios** | `templates/research.md`, `templates/analysis.md` |
+| **Ventajas** | Menor riesgo, cambios localizados |
+| **Inconvenientes** | No garantiza cumplimiento a nivel de workflow |
+
+### Alternativa B: Refactor Completo (Recomendada)
+| Aspecto | Detalle |
+|---------|---------|
+| **Descripción** | Modificar workflows + templates + crear estructura TODO |
+| **Cambios** | 2 workflows, 2 templates, 1 template nuevo, estructura TODO |
+| **Ventajas** | Cumplimiento completo de acceptance criteria |
+| **Inconvenientes** | Mayor esfuerzo, requiere testing manual de workflows |
+
+### Alternativa C: Reestructuración Profunda
+| Aspecto | Detalle |
+|---------|---------|
+| **Descripción** | Reescribir todo el ciclo de vida con nuevos patrones de orquestación |
+| **Cambios** | Todos los workflows, todos los templates, nuevas rules |
+| **Ventajas** | Máxima alineación con best practices de agent orchestration |
+| **Inconvenientes** | Excede el scope de la tarea, alto riesgo |
+
+**Decisión propuesta**: **Alternativa B** — Refactor completo pero acotado a los acceptance criteria.
+
+---
+
+## 5. Agentes participantes
+
+| Agente | Responsabilidades | Subáreas |
+|--------|-------------------|----------|
+| **architect-agent** | Orquestar, supervisar, validar | Workflows, templates, estructura TODO |
+| **tooling-agent** | N/A para esta tarea | - |
+| **qa-agent** | Validar que los cambios cumplen AC | Testing manual de workflows |
+
+**Handoffs**
+1. architect-agent diseña → architect-agent implementa (no hay código funcional)
+2. architect-agent completa → qa-agent valida
+
+**Componentes necesarios**
+- **Modificar**: `templates/research.md`, `templates/analysis.md`, `phase-1-research.md`, `phase-2-analysis.md`
+- **Crear**: `templates/todo-item.md`, `.agent/todo/README.md`
+- **Eliminar**: Ninguno
+
+**Demo**: No aplica — no hay UI ni código funcional.
+
+---
+
+## 6. Impacto de la tarea
+
+| Área | Impacto |
+|------|---------|
+| **Arquitectura** | Sin cambios en código, solo en sistema agéntico |
+| **APIs / contratos** | Sin breaking changes |
+| **Compatibilidad** | Los workflows modificados son retrocompatibles |
+| **Testing** | Validación manual por qa-agent |
+
+---
+
+## 7. Riesgos y mitigaciones
+
+| Riesgo | Severidad | Mitigación |
+|--------|-----------|------------|
+| Workflows modificados rompen ciclo existente | Alta | Revisar cada cambio con qa-agent antes de commit |
+| Templates nuevos no se usan correctamente | Media | Incluir ejemplos en cada template |
+| TODO backlog se ignora en análisis futuros | Baja | Añadir paso obligatorio con verificación en Gate |
+
+---
+
+## 8. Preguntas abiertas
+
+✅ Ninguna — todas las ambigüedades fueron resueltas en Phase 0.
+
+---
+
+## 9. TODO Backlog (Consulta obligatoria)
+
+> Referencia: `.agent/todo/`
+
+**Estado actual**: Directorio vacío.
+**Impacto en esta tarea**: Ningún item pendiente a considerar.
+
+---
+
+## 10. Aprobación
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-18T18:27:46+01:00
+    comments: ok - Alternativa B aprobada
+```

package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/architect/review.md

@@ -0,0 +1,68 @@
+---
+artifact: review
+phase: phase-4-implementation
+owner: architect-agent
+status: completed
+related_task: 19-refinar-sistema-agentes-ciclo-vida
+---
+
+# Architect Review — 19-refinar-sistema-agentes-ciclo-vida
+
+🏛️ **architect-agent**: Informe de revisión arquitectónica de la Fase 4.
+
+## Resumen de Tareas
+
+| # | Tarea | Agente | Estado | Gate |
+|---|-------|--------|--------|------|
+| 1 | Refactor research.md template | architect | ✅ | SI |
+| 2 | Refactor analysis.md template | architect | ✅ | SI |
+| 3 | Update phase-1-research.md workflow | architect | ✅ | SI |
+| 4 | Update phase-2-analysis.md workflow | architect | ✅ | SI |
+| 5 | Create TODO backlog structure | architect | ✅ | SI |
+| 6 | QA validation | qa | ✅ | SI |
+
+**Todas las tareas completadas y aprobadas.**
+
+## Cambios Implementados
+
+### Templates Modificados
+- `templates/research.md` — Regla PERMANENT, secciones renombradas
+- `templates/analysis.md` — Sección TODO Backlog añadida
+
+### Workflows Modificados
+- `phase-1-research.md` — Regla PERMANENT, Gate con verificación no-análisis
+- `phase-2-analysis.md` — Paso 5.5 consulta TODO, Gate actualizado
+
+### Ficheros Nuevos
+- `templates/todo-item.md` — Template para backlog items
+- `.agent/todo/README.md` — Documentación del backlog
+
+## Coherencia con Plan
+
+| Ítem del Plan | Implementado | Desviación |
+|---------------|--------------|------------|
+| 6 tareas definidas | ✅ | Ninguna |
+| Agentes asignados | ✅ | Ninguna |
+| Estructura TODO | ✅ | Ninguna |
+
+## Cumplimiento de Reglas
+
+- ✅ Clean Code: No aplica (no hay código funcional)
+- ✅ Arquitectura Extensio: No afectada (cambios en .agent/)
+- ✅ SRP: Cada modificación tiene un único objetivo
+
+## Problemas Detectados
+
+Ninguno.
+
+---
+
+## Final Approval
+
+```yaml
+final_approval:
+  developer:
+    decision: SI
+    date: 2026-01-18T18:41:32+01:00
+    comments: Aprobado
+```