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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,110 +0,0 @@
1
- ---
2
- id: workflow.tasklifecycle-short.short-phase-1-brief
3
- description: Fase 1 del ciclo Short. Fusiona Acceptance + Analysis + Planning. Incluye 5 preguntas obligatorias y detección de complejidad.
4
- owner: architect-agent
5
- version: 1.0.0
6
- severity: PERMANENT
7
- trigger:
8
- commands: ["short-phase-1", "brief"]
9
- blocking: true
10
- ---
11
-
12
- # WORKFLOW: tasklifecycle-short.short-phase-1-brief
13
-
14
- ## Input (REQUIRED)
15
- - Existe task candidate con `task.strategy: short`.
16
- - El desarrollador ha proporcionado título y objetivo.
17
-
18
- > [!IMPORTANT]
19
- > **Constitución activa (OBLIGATORIO)**:
20
- > - Cargar `constitution.clean_code` antes de iniciar
21
- > - Cargar `constitution.agents_behavior` (sección 7: Gates, sección 8: Constitución)
22
- > - **Activar `skill.runtime-governance`** (Para validación de gate y trazabilidad por el Architect)
23
-
24
- ## Output (REQUIRED)
25
- - Artefacto: `.agent/artifacts/<taskId>-<taskTitle>/brief.md`
26
- - Artefacto: `.agent/artifacts/<taskId>-<taskTitle>/acceptance.md` (NUEVO)
27
- - Task actualizado con fase actual = `short-phase-1-brief`
28
-
29
- ## Objetivo (ONLY)
30
- - Ejecutar las **5 preguntas obligatorias** para definir acceptance criteria.
31
- - Realizar un **análisis profundo** para detectar complejidad.
32
- - Crear un **plan simplificado** de implementación.
33
- - Si se detecta complejidad alta, **ofrecer abortar** y reiniciar en modo Long.
34
-
35
- > Esta fase **NO implementa código**.
36
- > Esta fase **REQUIERE aprobación explícita del desarrollador (SI/NO)**.
37
-
38
- ---
39
-
40
- ## Pasos obligatorios
41
-
42
- 0. Activar `architect-agent` y usar prefijo obligatorio en cada mensaje.
43
-
44
- ### 1. Verificar inputs
45
- - Existe task candidate.
46
- - `task.strategy == "short"`.
47
- - Si falla → **FAIL**.
48
-
49
- ### 2. Ejecutar 5 preguntas obligatorias
50
- El architect-agent **DEBE** formular 5 preguntas específicas basadas en la tarea:
51
- - Las preguntas varían según la tarea concreta.
52
- - Sin respuestas completas, la fase NO avanza.
53
-
54
- ### 3. Análisis de complejidad
55
- Evaluar indicadores de complejidad:
56
- - ¿Afecta más de 3 paquetes/módulos? → Alta
57
- - ¿Requiere investigación de APIs externas? → Alta
58
- - ¿Introduce cambios breaking? → Alta
59
- - ¿Necesita tests E2E complejos? → Alta
60
-
61
- **Si complejidad es ALTA**:
62
- - Notificar al desarrollador.
63
- - Ofrecer opción de abortar y crear nueva tarea en modo Long.
64
- - Si decide abortar → terminar fase con estado "aborted".
65
- ### 4. Crear artefactos (brief.md y acceptance.md)
66
- - Usar templates `templates.brief` y `templates.acceptance`.
67
- - En `acceptance.md` incluir:
68
- - Acceptance criteria derivados de las 5 preguntas.
69
- - En `brief.md` incluir:
70
- - Análisis simplificado del estado actual.
71
- - Plan de implementación con pasos ejecutables.
72
- - Evaluación de complejidad.
73
- - **Evaluación de Agentes**: Desempeño y propuestas de mejora.
74
-
75
- ### 5. Solicitar aprobación del desarrollador (por consola)
76
- ```yaml
77
- approval:
78
- developer:
79
- decision: SI | NO
80
- date: <ISO-8601>
81
- comments: <opcional>
82
- ```
83
- - Si `decision != SI` → **FAIL**.
84
-
85
- ### 6. PASS
86
- - Actualizar task.md:
87
- - Marcar fase como completada.
88
- - Establecer `task.lifecycle.phases.short-phase-1-brief.validated_at = <ISO-8601>`.
89
- - Actualizar `task.phase.updated_at = <ISO-8601>`.
90
- - Avanzar a `short-phase-2-implementation`.
91
-
92
- ---
93
-
94
- ## Gate (REQUIRED)
95
- Requisitos (todos obligatorios):
96
- 1. Existen `brief.md` y `acceptance.md` con templates correctos.
97
- 2. El `brief.md` inicia con el prefijo del `architect-agent`.
98
- 3. Las 5 preguntas están respondidas.
99
- 4. La evaluación de complejidad está documentada.
100
- 5. Existe aprobación explícita del desarrollador.
101
- 6. task.md refleja fase completada.
102
- 7. task.md refleja timestamp y estado:
103
- - `task.lifecycle.phases.short-phase-1-brief.completed == true`
104
- - `task.lifecycle.phases.short-phase-1-brief.validated_at` no nulo
105
- - `task.phase.updated_at` no nulo
106
- 8. **Gobernanza verificada**: El historial de logs muestra la secuencia de herramientas MCP definida en `skill.runtime-governance`.
107
-
108
- Si Gate FAIL:
109
- - Indicar qué requisito falta.
110
- - Bloquear hasta resolver.
@@ -1,104 +0,0 @@
1
- ---
2
- id: workflow.tasklifecycle-short.short-phase-3-closure
3
- description: Fase 3 del ciclo Short. Fusiona Verification + Results + Commit.
4
- owner: architect-agent
5
- version: 1.0.0
6
- severity: PERMANENT
7
- trigger:
8
- commands: ["short-phase-3", "closure"]
9
- blocking: true
10
- ---
11
-
12
- # WORKFLOW: tasklifecycle-short.short-phase-3-closure
13
-
14
- ## Input (REQUIRED)
15
- - Existe informe de implementación aprobado.
16
- - task.md refleja `task.phase.current == "short-phase-3-closure"`
17
-
18
- > [!IMPORTANT]
19
- > **Constitución activa (OBLIGATORIO)**:
20
- > - Cargar `constitution.clean_code` antes de iniciar
21
- > - Cargar `constitution.agents_behavior` (sección 7: Gates, sección 8: Constitución)
22
-
23
- ## Output (REQUIRED)
24
- - Artefacto de cierre: `.agent/artifacts/<taskId>-<taskTitle>/closure.md`
25
- - Commits realizados (si aplica).
26
- - Task completado.
27
-
28
- ## Objetivo (ONLY)
29
- - Verificar la implementación mediante tests (si aplica).
30
- - Presentar resultados al desarrollador.
31
- - Obtener aceptación final.
32
- - Consolidar y realizar commit.
33
-
34
- > Esta fase **NO implementa código nuevo**.
35
- > Esta fase **CIERRA el ciclo de la tarea**.
36
-
37
- ---
38
-
39
- ## Pasos obligatorios
40
-
41
- 0. Activar `architect-agent` y usar prefijo obligatorio en cada mensaje.
42
-
43
- ### 1. Protocolo de Validación Pre-Vuelo (OBLIGATORIO)
44
- - El agente **DEBE** leer físicamente el informe de implementación aprobado: `.agent/artifacts/<taskId>-<taskTitle>/architect/implementation.md`.
45
- - **Citar explícitamente** la decisión de aprobación (ej: "Estado: APROBADO").
46
- - Si el informe no existe o no está aprobado, el proceso **DEBE** detenerse inmediatamente (FAIL).
47
- - Verificar que la fase en `task.md` sea la correcta.
48
-
49
- ### 2. Ejecutar verificación
50
- Si la tarea requiere tests:
51
- - Ejecutar tests según `constitution.clean_code`.
52
- - Documentar resultados.
53
-
54
- Si no requiere tests:
55
- - Documentar justificación.
56
-
57
- ### 3. Crear artefacto closure.md
58
- - Usar template `templates.closure`.
59
- - Incluir:
60
- - Resumen de verificación.
61
- - Estado de cada acceptance criteria (✅/❌).
62
- - Evidencia de tests (si aplica).
63
-
64
- ### 4. Presentar resultados al desarrollador
65
- - Mostrar closure.md.
66
- - Resolver dudas.
67
- - Solicitar aceptación final por consola (SI/NO) y registrarla en `closure.md`.
68
-
69
- ### 6. Evaluar agentes (OBLIGATORIO)
70
- - Solicitar puntuación (1-10) del desarrollador para cada agente que haya intervenido.
71
- - **GATE OBLIGATORIO**: Sin puntuación, la tarea NO puede cerrarse.
72
- - Registrar las puntuaciones en `closure.md`.
73
-
74
- ### 7. Consolidar commits
75
- Si hay cambios de código:
76
- - Preparar commits siguiendo Conventional Commits.
77
- - Solicitar aprobación del desarrollador para push.
78
-
79
- ### 8. PASS
80
- - Marcar tarea como **COMPLETADA**.
81
- - Generar changelog (si aplica).
82
- - Actualizar task.md con estado final.
83
- - Establecer `task.lifecycle.phases.short-phase-3-closure.validated_at = <ISO-8601>`.
84
- - Actualizar `task.phase.updated_at = <ISO-8601>`.
85
-
86
- ---
87
-
88
- ## Gate (REQUIRED)
89
- Requisitos (todos obligatorios):
90
- 1. Existe closure.md con template correcto.
91
- 2. El `closure.md` inicia con el prefijo del `architect-agent`.
92
- 3. Todos los acceptance criteria están marcados.
93
- 4. Existe aceptación final del desarrollador.
94
- 5. Se han registrado las puntuaciones de los agentes en `closure.md`.
95
- 6. Commits realizados (si aplica).
96
- 7. task.md refleja tarea completada.
97
- 8. task.md refleja timestamp y estado:
98
- - `task.lifecycle.phases.short-phase-3-closure.completed == true`
99
- - `task.lifecycle.phases.short-phase-3-closure.validated_at` no nulo
100
- - `task.phase.updated_at` no nulo
101
-
102
- Si Gate FAIL:
103
- - Indicar qué requisito falta.
104
- - Bloquear hasta resolver.