@christianmaf80/agentic-workflow 1.33.2-beta.7 → 1.34.1-beta.8

package/dist/agent/rules/constitution/agents-behavior.md

@@ -210,3 +210,31 @@ Se habilita un canal formal de delegación para cambiar el agente activo cuando
 ### 10.4 Límites
 - Cada tarea **DEBE** ser ejecutada por el agente determinado tras la delegación aprobada.
 - Ningún agente puede delegar para evadir restricciones de constitución o gates.
+
+---
+
+## 11. AUTO-DELEGACIÓN CONTROLADA POR ARCHITECT (PERMANENT)
+
+Se habilita la **auto-delegación** exclusivamente para el **architect-agent** cuando el agente activo no corresponda a la tarea.
+
+### 11.1 Condición de activación
+- Si el agente activo **no es** el architect-agent y la tarea **no corresponde** a su rol/constitución, el sistema **DEBE** transferir el control al architect-agent.
+- El architect-agent evalúa y decide el agente responsable final.
+
+### 11.2 Aprobación del usuario (OBLIGATORIA)
+- La auto-delegación **requiere confirmación explícita** del usuario.
+- Debe usarse `notify_user` con:
+  - `BlockedOnUser: true`
+  - `PathsToReview` del artefacto afectado
+  - Mensaje claro de cambio de rol
+- Sin aprobación (SI) no hay transferencia efectiva.
+
+### 11.3 Trazabilidad y registro
+- Cada auto-delegación **DEBE** registrarse en `task.md` bajo `task.delegation.history`.
+- Registro mínimo:
+  - `from`, `to`, `approved_by`, `approved_at`, `reason`.
+- Debe existir log en runtime (si aplica).
+
+### 11.4 Límites
+- El cambio automático **no** evita gates ni restricciones de constitución.
+- El usuario **no** necesita invocar manualmente al nuevo agente una vez aprobado.

package/dist/agent/templates/{brief.md → analisis.md}

@@ -1,22 +1,24 @@
 ---
-artifact: brief
-phase: short-phase-1-brief
+artifact: analisis
+phase: short-phase-1-analisis
 owner: architect-agent
+implementation_owner: architect-agent
 status: draft | approved
 related_task: <taskId>-<taskTitle>
 ---
 
-# Brief — <taskId>-<taskTitle>
+# Analisis — <taskId>-<taskTitle>
 
 ## Identificacion del agente (OBLIGATORIA)
 Primera linea del documento:
 `<icono> **<nombre-agente>**: <mensaje>`
 
-## 1. Identificación de la tarea
+## 1. Identificacion de la tarea
 
-**Título**: <título de la tarea>
+**Titulo**: <titulo de la tarea>
 **Objetivo**: <objetivo principal>
 **Estrategia**: Short
+**Owner de implementacion**: <agent-id> (por defecto: architect-agent)
 
 ---
 
@@ -36,54 +38,42 @@ Primera linea del documento:
 
 Derivados de las respuestas anteriores:
 
-1. **Alcance**: 
-2. **Entradas/Datos**: 
-3. **Salidas esperadas**: 
-4. **Restricciones**: 
-5. **Criterio de Done**: 
+1. **Alcance**:
+2. **Entradas/Datos**:
+3. **Salidas esperadas**:
+4. **Restricciones**:
+5. **Criterio de Done**:
 
 ---
 
-## 4. Análisis simplificado
+## 4. Analisis simplificado
 
 ### Estado actual (As-Is)
 - Estructura afectada:
 - Limitaciones conocidas:
 
-### Evaluación de complejidad
+### Evaluacion de complejidad
 
 | Indicador | Estado | Comentario |
 |-----------|--------|------------|
-| Afecta más de 3 paquetes | ☐ Sí ☐ No | |
-| Requiere investigación APIs | ☐ Sí ☐ No | |
-| Cambios breaking | ☐ Sí ☐ No | |
-| Tests E2E complejos | ☐ Sí ☐ No | |
+| Afecta mas de 3 paquetes | ☐ Si ☐ No | |
+| Requiere investigacion APIs | ☐ Si ☐ No | |
+| Cambios breaking | ☐ Si ☐ No | |
+| Tests E2E complejos | ☐ Si ☐ No | |
 
 **Resultado de complejidad**: ☐ BAJA (continuar Short) ☐ ALTA (recomendar abortar a Long)
 
 ---
 
-## 5. Plan de implementación
+## 5. Evaluacion de agentes
 
-### Pasos ordenados
-
-1. **Paso 1**
-   - Descripción:
-   - Entregables:
-
-2. **Paso 2**
-   - Descripción:
-   - Entregables:
-
-(Añadir más pasos según necesidad)
-
-### Verificación prevista
-- Tipo de tests:
-- Criterios de éxito:
+| Agente | Desempeno (1-10) | Propuestas de mejora |
+|--------|------------------|----------------------|
+| | | |
 
 ---
 
-## 6. Aprobación del desarrollador (OBLIGATORIA)
+## 6. Aprobacion del desarrollador (OBLIGATORIA)
 
 ```yaml
 approval:
@@ -93,4 +83,4 @@ approval:
     comments: <opcional>
 ```
 
-> Sin aprobación, esta fase NO puede avanzar a Implementation.
+> Sin aprobacion, esta fase NO puede avanzar a Plan.

package/dist/agent/templates/index.md

@@ -33,8 +33,9 @@ templates:
   supplemental_report: .agent/templates/supplemental-report.md
 
   # Templates del ciclo Short
-  brief: .agent/templates/brief.md
-  closure: .agent/templates/closure.md
+  analisis: .agent/templates/analisis.md
+  plan: .agent/templates/plan.md
+  qa_results: .agent/templates/qa-results.md
 ```
 
 ## Reglas

package/dist/agent/templates/plan.md

@@ -0,0 +1,49 @@
+---
+artifact: plan
+phase: short-phase-2-plan
+owner: architect-agent
+status: draft | approved
+related_task: <taskId>-<taskTitle>
+---
+
+# Plan — <taskId>-<taskTitle>
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## 1. Resumen del plan
+- Objetivo resumido
+- Resultado esperado
+
+---
+
+## 2. Pasos de implementacion
+
+### Paso 1
+- Descripcion:
+- Entregables:
+
+### Paso 2
+- Descripcion:
+- Entregables:
+
+---
+
+## 3. Verificacion prevista
+- Tests / validaciones:
+- Criterios de exito:
+
+---
+
+## 4. Aprobacion del desarrollador (OBLIGATORIA)
+
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```
+
+> Sin aprobacion, esta fase NO puede avanzar a Implementacion.

package/dist/agent/templates/{closure.md → qa-results.md}

@@ -1,12 +1,12 @@
 ---
-artifact: closure
-phase: short-phase-3-closure
+artifact: qa-results
+phase: short-phase-4-qa-results
 owner: architect-agent
 status: draft | approved
 related_task: <taskId>-<taskTitle>
 ---
 
-# Closure — <taskId>-<taskTitle>
+# QA Results — <taskId>-<taskTitle>
 
 ## Identificacion del agente (OBLIGATORIA)
 Primera linea del documento:
@@ -14,30 +14,30 @@ Primera linea del documento:
 
 ## 1. Resumen de la tarea
 
-**Título**: <título>
+**Titulo**: <titulo>
 **Estrategia**: Short
 **Estado final**: ☐ Completada ☐ Abortada
 
 ---
 
-## 2. Verificación
+## 2. Verificacion
 
 ### Tests ejecutados
 
-| Tipo | Comando/Método | Resultado |
+| Tipo | Comando/Metodo | Resultado |
 |------|----------------|-----------|
 | Unit | | ☐ Pass ☐ Fail ☐ N/A |
 | Integration | | ☐ Pass ☐ Fail ☐ N/A |
 | E2E | | ☐ Pass ☐ Fail ☐ N/A |
 
-### Justificación (si no hay tests)
-<Explicar por qué no aplican tests>
+### Justificacion (si no hay tests)
+<Explicar por que no aplican tests>
 
 ---
 
 ## 3. Estado de Acceptance Criteria
 
-| AC | Descripción | Estado |
+| AC | Descripcion | Estado |
 |----|-------------|--------|
 | 1 | | ☐ ✅ ☐ ❌ |
 | 2 | | ☐ ✅ ☐ ❌ |
@@ -51,19 +51,13 @@ Primera linea del documento:
 
 ### Ficheros modificados/creados
 
-| Fichero | Acción | Descripción |
+| Fichero | Accion | Descripcion |
 |---------|--------|-------------|
 | | Created/Modified/Deleted | |
 
-### Commits (si aplica)
-
-```
-<tipo>(<scope>): <descripción>
-```
-
 ---
 
-## 5. Aceptación final del desarrollador (OBLIGATORIA)
+## 5. Aceptacion final del desarrollador (OBLIGATORIA)
 
 ```yaml
 approval:
@@ -73,23 +67,4 @@ approval:
     comments: <opcional>
 ```
 
-> Sin aceptación, la tarea NO puede marcarse como completada.
-
----
-
-## 6. Puntuaciones de agentes (OBLIGATORIO)
-
-| Agente | Puntuacion (1-10) | Notas |
-|--------|-------------------|-------|
-| | | |
-
----
-
-## 7. Push final (si aplica)
-
-```yaml
-push:
-  approved: SI | NO
-  branch: <rama destino>
-  date: <ISO-8601>
-```
+> Sin aceptacion, la tarea NO puede marcarse como completada.

package/dist/agent/templates/task.md

@@ -96,15 +96,19 @@ task:
             completed: false
             validated_by: null
             validated_at: null
-      short-phase-1-brief:
+      short-phase-1-analisis:
         completed: false
         validated_by: null
         validated_at: null
-      short-phase-2-implementation:
+      short-phase-2-plan:
         completed: false
         validated_by: null
         validated_at: null
-      short-phase-3-closure:
+      short-phase-3-implementation:
+        completed: false
+        validated_by: null
+        validated_at: null
+      short-phase-4-qa-results:
         completed: false
         validated_by: null
         validated_at: null

package/dist/agent/workflows/tasklifecycle-long/phase-4-implementation.md

@@ -70,6 +70,9 @@ blocking: true
 - Identificar todas las tareas de implementación y sus agentes responsables.
 - Crear (si no existe) el directorio:
   - `.agent/artifacts/<taskId>-<taskTitle>/agent-tasks/`
+ - Si una tarea no especifica agente responsable:
+   - Asignar por defecto `architect-agent`.
+   - Registrar el ajuste en `task.delegation.history` (reason: `missing_agent_in_plan`).
 
 ### 3. Bucle de delegación (SÍNCRONO)
 
@@ -81,6 +84,7 @@ Para cada tarea `N` en el plan:
 - Completar:
   - **Input**: Objetivo, Alcance, Dependencias (definidos por el arquitecto)
   - **Output**: Entregables, Evidencia requerida (definidos por el arquitecto)
+ - Asegurar que el frontmatter `owner` refleje el agente responsable definido en `plan.md` (o el default).
 
 #### 3.2 Asignar al agente
 - El `architect-agent` **DEBE** activar al agente correspondiente:

package/dist/agent/workflows/tasklifecycle-short/index.md

@@ -33,14 +33,17 @@ aliases:
         id: init
         workflow: .agent/workflows/init.md
       short_phase_1:
-        id: short-phase-1-brief
-        workflow: .agent/workflows/tasklifecycle-short/short-phase-1-brief.md
+        id: short-phase-1-analisis
+        workflow: .agent/workflows/tasklifecycle-short/short-phase-1-analisis.md
       short_phase_2:
-        id: short-phase-2-implementation
-        workflow: .agent/workflows/tasklifecycle-short/short-phase-2-implementation.md
+        id: short-phase-2-plan
+        workflow: .agent/workflows/tasklifecycle-short/short-phase-2-plan.md
       short_phase_3:
-        id: short-phase-3-closure
-        workflow: .agent/workflows/tasklifecycle-short/short-phase-3-closure.md
+        id: short-phase-3-implementation
+        workflow: .agent/workflows/tasklifecycle-short/short-phase-3-implementation.md
+      short_phase_4:
+        id: short-phase-4-qa-results
+        workflow: .agent/workflows/tasklifecycle-short/short-phase-4-qa-results.md
 ```
 
 ## Input (REQUIRED)
@@ -49,19 +52,20 @@ aliases:
 
 ## Output (REQUIRED)
 - Task candidate con `task.strategy: short`.
-- Artefactos de cada fase: `brief.md`, `implementation.md`, `closure.md`.
+- Artefactos de cada fase: `analisis.md`, `plan.md`, `implementation.md`, `qa-results.md`.
 
 ## Objetivo (ONLY)
-- Ejecutar un ciclo simplificado de 3 fases para tareas de baja complejidad.
+- Ejecutar un ciclo simplificado de 4 fases para tareas de baja complejidad.
 - Mantener la integridad de los gates arquitectónicos.
-- Si se detecta complejidad alta en Brief, ofrecer abortar a Long.
+- Si se detecta complejidad alta en Analisis, ofrecer abortar a Long.
 
 ## Orden oficial de ejecución de fases
 Las fases del ciclo Short **DEBEN ejecutarse estrictamente en orden**:
 
-1. `aliases.tasklifecycle-short.phases.short_phase_1.id` (Brief)
-2. `aliases.tasklifecycle-short.phases.short_phase_2.id` (Implementation)
-3. `aliases.tasklifecycle-short.phases.short_phase_3.id` (Closure)
+1. `aliases.tasklifecycle-short.phases.short_phase_1.id` (Analisis)
+2. `aliases.tasklifecycle-short.phases.short_phase_2.id` (Plan)
+3. `aliases.tasklifecycle-short.phases.short_phase_3.id` (Implementation)
+4. `aliases.tasklifecycle-short.phases.short_phase_4.id` (QA + Resultados)
 
 ## Gate (REQUIRED)
 Requisitos (todos obligatorios):

package/dist/agent/workflows/tasklifecycle-short/short-phase-1-analisis.md

@@ -0,0 +1,116 @@
+---
+id: workflow.tasklifecycle-short.short-phase-1-analisis
+description: Fase 1 del ciclo Short. Ejecuta analisis y define acceptance criteria basados en 5 preguntas obligatorias.
+owner: architect-agent
+version: 1.0.0
+severity: PERMANENT
+trigger:
+  commands: ["short-phase-1", "analisis", "analysis"]
+blocking: true
+---
+
+# WORKFLOW: tasklifecycle-short.short-phase-1-analisis
+
+## Input (REQUIRED)
+- Existe task candidate con `task.strategy: short`.
+- El desarrollador ha proporcionado titulo y objetivo.
+
+> [!IMPORTANT]
+> **Constitucion activa (OBLIGATORIO)**:
+> - Cargar `constitution.clean_code` antes de iniciar
+> - Cargar `constitution.agents_behavior` (seccion 7: Gates, seccion 8: Constitucion)
+> - **Activar `skill.runtime-governance`** (Para validacion de gate y trazabilidad por el Architect)
+
+## Output (REQUIRED)
+- Artefacto: `.agent/artifacts/<taskId>-<taskTitle>/analisis.md`
+- Artefacto: `.agent/artifacts/<taskId>-<taskTitle>/acceptance.md`
+- Task actualizado con fase actual = `short-phase-1-analisis`
+
+## Objetivo (ONLY)
+- Ejecutar las **5 preguntas obligatorias** para definir acceptance criteria.
+- Documentar el analisis de la tarea (estado actual y riesgos basicos).
+- Si se detecta complejidad alta, **ofrecer abortar** y reiniciar en modo Long.
+
+> Esta fase **NO implementa codigo**.
+> Esta fase **REQUIERE aprobacion explicita del desarrollador (SI/NO)**.
+
+---
+
+## Pasos obligatorios
+
+0. Activar `architect-agent` y usar prefijo obligatorio en cada mensaje.
+
+### 1. Verificar inputs
+- Existe task candidate.
+- `task.strategy == "short"`.
+- Si falla -> **FAIL**.
+
+### 2. Ejecutar 5 preguntas obligatorias
+El architect-agent **DEBE** formular 5 preguntas especificas basadas en la tarea:
+- Las preguntas varian segun la tarea concreta.
+- Sin respuestas completas, la fase NO avanza.
+
+### 2.1 Definir owner de implementacion (OBLIGATORIO)
+- El desarrollador **DEBE** indicar el agente responsable de la implementacion.
+- Registrar el valor en `analisis.md` como `implementation_owner`.
+- Si no se define, usar `architect-agent` por defecto y dejar trazado en el analisis.
+
+### 3. Analisis de complejidad
+Evaluar indicadores de complejidad:
+- Afecta mas de 3 paquetes/modulos? -> Alta
+- Requiere investigacion de APIs externas? -> Alta
+- Introduce cambios breaking? -> Alta
+- Necesita tests E2E complejos? -> Alta
+
+**Si complejidad es ALTA**:
+- Notificar al desarrollador.
+- Ofrecer opcion de abortar y crear nueva tarea en modo Long.
+- Si decide abortar -> terminar fase con estado "aborted".
+
+### 4. Crear artefactos (analisis.md y acceptance.md)
+- Usar templates `templates.analisis` y `templates.acceptance`.
+- En `acceptance.md` incluir:
+  - Acceptance criteria derivados de las 5 preguntas.
+- En `analisis.md` incluir:
+  - Estado actual (As-Is) simplificado.
+  - Riesgos basicos.
+  - Evaluacion de complejidad.
+  - `implementation_owner` explicito (agente responsable de implementacion).
+  - **Evaluacion de Agentes**: Desempeno y propuestas de mejora.
+
+### 5. Solicitar aprobacion del desarrollador (por consola)
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```
+- Si `decision != SI` -> **FAIL**.
+
+### 6. PASS
+- Actualizar task.md:
+  - Marcar fase como completada.
+  - Establecer `task.lifecycle.phases.short-phase-1-analisis.validated_at = <ISO-8601>`.
+  - Actualizar `task.phase.updated_at = <ISO-8601>`.
+  - Avanzar a `short-phase-2-plan`.
+
+---
+
+## Gate (REQUIRED)
+Requisitos (todos obligatorios):
+1. Existen `analisis.md` y `acceptance.md` con templates correctos.
+2. El `analisis.md` inicia con el prefijo del `architect-agent`.
+3. Las 5 preguntas estan respondidas.
+4. La evaluacion de complejidad esta documentada.
+5. Existe aprobacion explicita del desarrollador.
+6. task.md refleja fase completada.
+7. task.md refleja timestamp y estado:
+   - `task.lifecycle.phases.short-phase-1-analisis.completed == true`
+   - `task.lifecycle.phases.short-phase-1-analisis.validated_at` no nulo
+   - `task.phase.updated_at` no nulo
+8. **Gobernanza verificada**: El historial de logs muestra la secuencia de herramientas MCP definida en `skill.runtime-governance`.
+
+Si Gate FAIL:
+- Indicar que requisito falta.
+- Bloquear hasta resolver.

package/dist/agent/workflows/tasklifecycle-short/short-phase-2-plan.md

@@ -0,0 +1,81 @@
+---
+id: workflow.tasklifecycle-short.short-phase-2-plan
+description: Fase 2 del ciclo Short. Define el plan de implementacion basado en el analisis aprobado.
+owner: architect-agent
+version: 1.0.0
+severity: PERMANENT
+trigger:
+  commands: ["short-phase-2", "plan", "planning"]
+blocking: true
+---
+
+# WORKFLOW: tasklifecycle-short.short-phase-2-plan
+
+## Input (REQUIRED)
+- Existe analisis aprobado: `.agent/artifacts/<taskId>-<taskTitle>/analisis.md`
+- task.md refleja `task.phase.current == "short-phase-2-plan"`
+
+> [!IMPORTANT]
+> **Constitucion activa (OBLIGATORIO)**:
+> - Cargar `constitution.clean_code` antes de iniciar
+> - Cargar `constitution.agents_behavior` (seccion 7: Gates, seccion 8: Constitucion)
+
+## Output (REQUIRED)
+- Plan de implementacion: `.agent/artifacts/<taskId>-<taskTitle>/plan.md`
+- Task actualizado.
+
+## Objetivo (ONLY)
+- Traducir el analisis a un plan ejecutable.
+- Definir pasos, entregables y verificacion.
+
+> Esta fase **NO implementa codigo**.
+> Esta fase **REQUIERE aprobacion explicita del desarrollador (SI/NO)**.
+
+---
+
+## Pasos obligatorios
+
+0. Activar `architect-agent` y usar prefijo obligatorio en cada mensaje.
+
+### 1. Verificar inputs
+- Existe `analisis.md` aprobado.
+- `task.phase.current == "short-phase-2-plan"`.
+- Si falla -> **FAIL**.
+
+### 2. Crear artefacto plan.md
+- Usar template `templates.plan`.
+- Incluir pasos ordenados, entregables y estrategia de verificacion.
+
+### 3. Solicitar aprobacion del desarrollador (por consola)
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```
+- Si `decision != SI` -> **FAIL**.
+
+### 4. PASS
+- Actualizar task.md:
+  - Marcar fase como completada.
+  - Establecer `task.lifecycle.phases.short-phase-2-plan.validated_at = <ISO-8601>`.
+  - Actualizar `task.phase.updated_at = <ISO-8601>`.
+  - Avanzar a `short-phase-3-implementation`.
+
+---
+
+## Gate (REQUIRED)
+Requisitos (todos obligatorios):
+1. Existe `plan.md` con template correcto.
+2. El `plan.md` inicia con el prefijo del `architect-agent`.
+3. Existe aprobacion explicita del desarrollador.
+4. task.md refleja fase completada.
+5. task.md refleja timestamp y estado:
+   - `task.lifecycle.phases.short-phase-2-plan.completed == true`
+   - `task.lifecycle.phases.short-phase-2-plan.validated_at` no nulo
+   - `task.phase.updated_at` no nulo
+
+Si Gate FAIL:
+- Indicar que requisito falta.
+- Bloquear hasta resolver.