@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.
- package/dist/agent/rules/constitution/agents-behavior.md +28 -0
- package/dist/agent/templates/{brief.md → analisis.md} +24 -34
- package/dist/agent/templates/index.md +3 -2
- package/dist/agent/templates/plan.md +49 -0
- package/dist/agent/templates/{closure.md → qa-results.md} +12 -37
- package/dist/agent/templates/task.md +7 -3
- package/dist/agent/workflows/tasklifecycle-long/phase-4-implementation.md +4 -0
- package/dist/agent/workflows/tasklifecycle-short/index.md +16 -12
- package/dist/agent/workflows/tasklifecycle-short/short-phase-1-analisis.md +116 -0
- package/dist/agent/workflows/tasklifecycle-short/short-phase-2-plan.md +81 -0
- package/dist/agent/workflows/tasklifecycle-short/{short-phase-2-implementation.md → short-phase-3-implementation.md} +29 -20
- package/dist/agent/workflows/tasklifecycle-short/short-phase-4-qa-results.md +84 -0
- package/dist/cli/commands/init.js +16 -0
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/runtime/frontmatter-sync.js +100 -0
- package/dist/runtime/frontmatter-sync.js.map +1 -0
- package/dist/runtime/runtime.js +10 -1
- package/dist/runtime/runtime.js.map +1 -1
- package/dist/runtime/write-guard.js +3 -3
- package/dist/runtime/write-guard.js.map +1 -1
- package/package.json +2 -2
- package/dist/agent/workflows/tasklifecycle-short/short-phase-1-brief.md +0 -110
- package/dist/agent/workflows/tasklifecycle-short/short-phase-3-closure.md +0 -104
|
@@ -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.
|