@christianmaf80/agentic-workflow 1.19.1-beta.10 → 1.19.2-beta.1
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/README.es.md +84 -13
- package/README.md +83 -12
- package/RELEASE_PROCESS.md +4 -3
- package/bin/cli.js +39 -18
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/acceptance.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-scores.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/1-dev-agent-scaffold.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/2-dev-agent-manifest-command.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/3-dev-agent-marketplace-evidence.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/4-qa-agent-verify-build.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/analysis.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/architect/review.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/metrics.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/plan.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/researcher/research.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/results-acceptance.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/task.md +6 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/verification.md +6 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/acceptance.md +6 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/task.md +6 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/acceptance.md +6 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/task.md +6 -0
- package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/acceptance.md +6 -0
- package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/architect/implementation.md +6 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/acceptance.md +6 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/1-dev-agent-reestructurar-carpetas.md +1 -1
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/task.md +6 -0
- package/dist/agent/artifacts/6-release-beta-11/task.md +6 -0
- package/dist/agent/artifacts/candidate/init.md +8 -4
- package/dist/agent/artifacts/candidate/task.md +6 -0
- package/dist/agent/artifacts/task-20260128-reorganize-structure/acceptance.md +6 -0
- package/dist/agent/artifacts/task-20260128-reorganize-structure/brief.md +1 -1
- package/dist/agent/artifacts/task-20260128-reorganize-structure/closure.md +3 -3
- package/dist/agent/artifacts/task-20260128-reorganize-structure/implementation.md +2 -2
- package/dist/agent/artifacts/task-20260128-reorganize-structure/task.md +6 -0
- package/dist/agent/index.md +3 -0
- package/dist/agent/rules/constitution/agents-behavior.md +0 -1
- package/dist/agent/rules/constitution/clean-code.md +6 -0
- package/dist/agent/rules/constitution/index.md +1 -1
- package/dist/agent/rules/constitution/runtime-integration.md +101 -0
- package/dist/agent/rules/index.md +0 -1
- package/dist/agent/rules/roles/architect.md +2 -1
- package/dist/agent/templates/acceptance.md +6 -0
- package/dist/agent/templates/init.md +18 -0
- package/dist/agent/templates/supplemental-report.md +6 -0
- package/dist/agent/templates/task.md +7 -0
- package/dist/agent/workflows/init.md +29 -10
- package/dist/agent/workflows/tasklifecycle-long/index.md +27 -27
- package/dist/agent/workflows/tasklifecycle-long/phase-0-acceptance-criteria.md +13 -3
- package/dist/agent/workflows/tasklifecycle-long/phase-1-research.md +6 -4
- package/dist/agent/workflows/tasklifecycle-long/phase-2-analysis.md +4 -4
- package/dist/agent/workflows/tasklifecycle-long/phase-3-planning.md +4 -4
- package/dist/agent/workflows/tasklifecycle-long/phase-4-implementation.md +4 -4
- package/dist/agent/workflows/tasklifecycle-long/phase-5-verification.md +4 -4
- package/dist/agent/workflows/tasklifecycle-long/phase-6-results-acceptance.md +4 -4
- package/dist/agent/workflows/tasklifecycle-long/phase-7-evaluation.md +4 -4
- package/dist/agent/workflows/tasklifecycle-long/phase-8-commit-push.md +2 -2
- package/dist/agent/workflows/tasklifecycle-short/index.md +12 -9
- package/dist/agent/workflows/tasklifecycle-short/short-phase-1-brief.md +2 -0
- package/dist/cli/commands/create.js +30 -5
- package/dist/cli/commands/create.js.map +1 -1
- package/dist/cli/commands/init.js +9 -3
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/mcp.js +11 -0
- package/dist/cli/commands/mcp.js.map +1 -0
- package/dist/cli/commands/register-mcp.js +116 -0
- package/dist/cli/commands/register-mcp.js.map +1 -0
- package/dist/cli/index.js +1 -0
- package/dist/cli/index.js.map +1 -1
- package/dist/infrastructure/context/index.js +2 -0
- package/dist/infrastructure/context/index.js.map +1 -0
- package/dist/{core → infrastructure}/context/manager.js +0 -1
- package/dist/infrastructure/context/manager.js.map +1 -0
- package/dist/infrastructure/index.js +7 -0
- package/dist/infrastructure/index.js.map +1 -0
- package/dist/infrastructure/logger/index.js +41 -0
- package/dist/infrastructure/logger/index.js.map +1 -0
- package/dist/infrastructure/mapping/index.js +2 -0
- package/dist/infrastructure/mapping/index.js.map +1 -0
- package/dist/{core → infrastructure}/mapping/resolver.js +5 -5
- package/dist/infrastructure/mapping/resolver.js.map +1 -0
- package/dist/infrastructure/migration/backup.js.map +1 -0
- package/dist/infrastructure/migration/detector.js.map +1 -0
- package/dist/infrastructure/migration/index.js +4 -0
- package/dist/infrastructure/migration/index.js.map +1 -0
- package/dist/infrastructure/migration/transformer.js.map +1 -0
- package/dist/infrastructure/utils/backup.js.map +1 -0
- package/dist/infrastructure/utils/index.js +2 -0
- package/dist/infrastructure/utils/index.js.map +1 -0
- package/dist/runtime/index.js +4 -0
- package/dist/runtime/index.js.map +1 -0
- package/dist/runtime/runtime.js +254 -0
- package/dist/runtime/runtime.js.map +1 -0
- package/dist/runtime/task-loader.js +32 -0
- package/dist/runtime/task-loader.js.map +1 -0
- package/dist/runtime/task-resolver.js +201 -0
- package/dist/runtime/task-resolver.js.map +1 -0
- package/package.json +16 -9
- package/dist/agent/rules/constitution/GEMINI.location.md +0 -32
- package/dist/core/context/manager.js.map +0 -1
- package/dist/core/index.js +0 -2
- package/dist/core/index.js.map +0 -1
- package/dist/core/mapping/resolver.js.map +0 -1
- package/dist/core/migration/backup.js.map +0 -1
- package/dist/core/migration/detector.js.map +0 -1
- package/dist/core/migration/transformer.js.map +0 -1
- package/dist/core/utils/backup.js.map +0 -1
- package/dist/extension/extension.js +0 -6
- package/dist/extension/extension.js.map +0 -1
- package/dist/extension/views/index.js +0 -2
- package/dist/extension/views/index.js.map +0 -1
- package/dist/extension/views/main-view.js +0 -53
- package/dist/extension/views/main-view.js.map +0 -1
- package/media/agent-chat.svg +0 -20
- /package/dist/{core → infrastructure}/migration/backup.js +0 -0
- /package/dist/{core → infrastructure}/migration/detector.js +0 -0
- /package/dist/{core → infrastructure}/migration/transformer.js +0 -0
- /package/dist/{core → infrastructure}/utils/backup.js +0 -0
|
@@ -38,7 +38,7 @@ Derivados de las respuestas anteriores:
|
|
|
38
38
|
1. **Alcance**: Reubicación de carpetas `rules`, `workflows`, `templates`, `artifacts` e `index.md` de `src/` a `.agent/`. Consolidación de `.agent.backup_*` en `/.backups/`.
|
|
39
39
|
2. **Entradas/Datos**: Ficheros actuales en `src/` y carpetas de backup en raíz.
|
|
40
40
|
3. **Salidas esperadas**: Nueva estructura de directorios funcional y coherente, con scripts y referencias actualizadas.
|
|
41
|
-
4. **Restricciones**: No modificar el código lógico en `src/cli`, `src/
|
|
41
|
+
4. **Restricciones**: No modificar el código lógico en `src/cli`, `src/infrastructure`, `src/test` ni `src/extension.ts`.
|
|
42
42
|
5. **Criterio de Done**: Estructura movida, `.backups` consolidado, `init` funcional y build exitosa sin errores de paths.
|
|
43
43
|
|
|
44
44
|
---
|
|
@@ -21,13 +21,13 @@ Se han cumplido todos los objetivos establecidos en el Brief:
|
|
|
21
21
|
- **Estrategia**: Short (3 fases).
|
|
22
22
|
- **Ficheros modificados**:
|
|
23
23
|
- `package.json`
|
|
24
|
-
- `src/
|
|
25
|
-
- `src/
|
|
24
|
+
- `src/infrastructure/utils/backup.ts`
|
|
25
|
+
- `src/infrastructure/migration/backup.ts`
|
|
26
26
|
- `src/cli/commands/init.ts`
|
|
27
27
|
- Toda la documentación agéntica (.md).
|
|
28
28
|
|
|
29
29
|
## 3. Resultado Final
|
|
30
|
-
El repositorio presenta ahora una separación clara entre el código fuente de la extensión (`src/
|
|
30
|
+
El repositorio presenta ahora una separación clara entre el código fuente de la extensión (`src/infrastructure`, `src/cli`) y la configuración del sistema agéntico (`src/agentic-system-structure`). Se ha mantenido compatibilidad mediante un mirror en `.agent/`.
|
|
31
31
|
|
|
32
32
|
## 4. Confirmación de Cierre
|
|
33
33
|
La tarea se considera **finalizada con éxito**.
|
|
@@ -26,7 +26,7 @@ Se ha realizado una reorganización profunda del sistema para mejorar la manteni
|
|
|
26
26
|
### Actualización de Código y Scripts
|
|
27
27
|
- **package.json**: Se ha actualizado el script `copy-assets` para que la build (`dist/`) se genere correctamente desde la nueva ubicación.
|
|
28
28
|
- **CLI (initCommand)**: Se ha modificado la lógica de inicialización para asegurar que la carpeta `.backups` se cree automáticamente y que el contenido de `AGENTS.md` sea coherente con la nueva estructura.
|
|
29
|
-
- **
|
|
29
|
+
- **Infrastructure (Backup Logic)**: Se ha actualizado la lógica de creación de backups en `src/infrastructure/migration/backup.ts` y `src/infrastructure/utils/backup.ts` para que los nuevos respaldos se guarden siempre en `.backups/`.
|
|
30
30
|
|
|
31
31
|
## 2. Verificación Técnica
|
|
32
32
|
|
|
@@ -41,7 +41,7 @@ Se ha realizado una reorganización profunda del sistema para mejorar la manteni
|
|
|
41
41
|
| Carpetas movidas a `.agent/` | ☑ Cumplido | Verificado mediante `ls`. |
|
|
42
42
|
| Backups movidos a `/.backups/` | ☑ Cumplido | Verificado mediante `ls`. |
|
|
43
43
|
| Scripts de build actualizados | ☑ Cumplido | `npm run build` ejecutado con éxito. |
|
|
44
|
-
| Lógica de backup en código actualizada | ☑ Cumplido | Código en `src/
|
|
44
|
+
| Lógica de backup en código actualizada | ☑ Cumplido | Código en `src/infrastructure` modificado. |
|
|
45
45
|
| Sistema inicializable tras cambio | ☑ Cumplido | Lógica de `init` preparada. |
|
|
46
46
|
|
|
47
47
|
## 4. Notas Adicionales
|
package/dist/agent/index.md
CHANGED
|
@@ -46,7 +46,6 @@ Archivos protegidos:
|
|
|
46
46
|
- `.agent/rules/**/*.md` (Reglas)
|
|
47
47
|
- `.agent/workflows/**/*.md` (Workflows)
|
|
48
48
|
- Indices de sistema (`index.md`)
|
|
49
|
-
- `GEMINI.md`
|
|
50
49
|
|
|
51
50
|
### 2.2 Prohibición para Agentes Operativos
|
|
52
51
|
- ❌ **Prohibido**: Que el `qa-agent` o `researcher-agent` modifiquen archivos de la carpeta `.agent/rules` o `.agent/workflows`.
|
|
@@ -16,9 +16,9 @@ por alias en lugar de rutas directas.
|
|
|
16
16
|
## Aliases (YAML)
|
|
17
17
|
```yaml
|
|
18
18
|
constitution:
|
|
19
|
-
GEMINI_location: .agent/rules/constitution/GEMINI.location.md
|
|
20
19
|
clean_code: .agent/rules/constitution/clean-code.md
|
|
21
20
|
agents_behavior: .agent/rules/constitution/agents-behavior.md
|
|
21
|
+
runtime_integration: .agent/rules/constitution/runtime-integration.md
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
## Reglas
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: constitution.runtime_integration
|
|
3
|
+
owner: architect-agent
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
severity: PERMANENT
|
|
6
|
+
scope: global
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# RUNTIME INTEGRATION CONSTITUTION
|
|
10
|
+
|
|
11
|
+
Este documento define las reglas obligatorias para la integración del runtime MCP en la ejecución de workflows.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 1. REGLA DE INTEGRACIÓN RUNTIME (PERMANENT - CRITICAL)
|
|
16
|
+
|
|
17
|
+
Cuando cualquier agente ejecute un workflow del sistema (`init`, `tasklifecycle-short`, `tasklifecycle-long`), **DEBE** utilizar las herramientas del runtime MCP para garantizar trazabilidad y persistencia de estado.
|
|
18
|
+
|
|
19
|
+
### 1.1 Herramientas Obligatorias
|
|
20
|
+
|
|
21
|
+
| Evento | Herramienta MCP | Cuándo usar |
|
|
22
|
+
|--------|-----------------|-------------|
|
|
23
|
+
| Inicio de tarea | `runtime.run` | Al crear una nueva tarea |
|
|
24
|
+
| Avance de fase | `runtime.advance_phase` | Al completar cada fase del ciclo |
|
|
25
|
+
| Obtener estado | `runtime.get_state` | Para consultar el estado actual |
|
|
26
|
+
| Validar gate | `runtime.validate_gate` | Antes de solicitar aprobación |
|
|
27
|
+
| Evento importante | `runtime.emit_event` | Para eventos de chat, errores, etc. |
|
|
28
|
+
|
|
29
|
+
### 1.2 Flujo Obligatorio
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
1. Al iniciar workflow:
|
|
33
|
+
→ Llamar `runtime.run` con taskPath y agent
|
|
34
|
+
|
|
35
|
+
2. Al completar cada fase:
|
|
36
|
+
→ Llamar `runtime.validate_gate` para verificar precondiciones
|
|
37
|
+
→ Solicitar aprobación al desarrollador (notify_user)
|
|
38
|
+
→ Llamar `runtime.advance_phase` tras aprobación
|
|
39
|
+
|
|
40
|
+
3. Durante la ejecución:
|
|
41
|
+
→ Usar `runtime.emit_event` para eventos significativos
|
|
42
|
+
→ Usar `runtime.get_state` para consultar estado si es necesario
|
|
43
|
+
|
|
44
|
+
### 1.3 Regla de Nulidad (Bypass Detection)
|
|
45
|
+
Cualquier acción técnica de cambio de estado (creación de artefactos, avance de fase) realizada sin una llamada correspondiente registrada en el Runtime MCP será considerada **nula e inválida**.
|
|
46
|
+
- La "Huella Digital de Gobernanza" (logs de `validate_gate` y `advance_phase`) generada mediante el **Skill de Gobernanza** es el único comprobante legal de cumplimiento de proceso.
|
|
47
|
+
|
|
48
|
+
### 1.4 Skill de Gobernanza (Mejor Práctica)
|
|
49
|
+
El uso del `skill.runtime-governance` es la **mejor práctica y el método obligatorio** para el `architect-agent`.
|
|
50
|
+
- **Por qué**: Centraliza la complejidad técnica de las herramientas MCP y permite auditorías reactivas consistentes sin sobrecargar los archivos de workflow.
|
|
51
|
+
- **Invocación**: Los workflows deben simplemente invocar la acción de control, y el Arquitecto debe proveer el "Cómo" mediante este Skill exclusivo.
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 2. REQUISITOS PREVIOS (PERMANENT)
|
|
57
|
+
|
|
58
|
+
Para que esta constitución sea aplicable:
|
|
59
|
+
|
|
60
|
+
1. El servidor MCP debe estar registrado en el cliente (Antigravity/Codex).
|
|
61
|
+
- Si no está registrado, ejecutar: `agentic-workflow register-mcp`
|
|
62
|
+
|
|
63
|
+
2. El servidor MCP debe estar corriendo en background o ser invocable.
|
|
64
|
+
|
|
65
|
+
### 2.1 Verificación de Registro
|
|
66
|
+
|
|
67
|
+
Al iniciar cualquier workflow, el agente **DEBE** verificar que las herramientas del runtime están disponibles. Si no lo están:
|
|
68
|
+
- Informar al desarrollador.
|
|
69
|
+
- Sugerir ejecutar `agentic-workflow register-mcp`.
|
|
70
|
+
- Continuar con ejecución fallback (sin runtime) si el desarrollador lo autoriza.
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## 3. LOGS Y TRAZABILIDAD (PERMANENT)
|
|
75
|
+
|
|
76
|
+
Todas las llamadas al runtime generan logs en stderr. Estos logs son la **fuente de verdad** para auditar la ejecución de workflows.
|
|
77
|
+
|
|
78
|
+
### 3.1 Formato de Logs
|
|
79
|
+
```
|
|
80
|
+
[LEVEL] [SOURCE] Message {context}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 3.2 Herramienta de Debug
|
|
84
|
+
- `debug_read_logs`: Permite leer los logs almacenados en el buffer del runtime.
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 4. EXCEPCIONES (PERMANENT)
|
|
89
|
+
|
|
90
|
+
Esta constitución **NO aplica** cuando:
|
|
91
|
+
- El desarrollador solicita explícitamente ejecución sin runtime.
|
|
92
|
+
- Las herramientas MCP no están disponibles y el desarrollador autoriza fallback.
|
|
93
|
+
- Se trata de operaciones de solo lectura (consultas, investigación).
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## Authority
|
|
98
|
+
|
|
99
|
+
Esta constitución es **binding** cuando referenciada como `INJECTED` o `PERMANENT`.
|
|
100
|
+
Creada por: architect-agent
|
|
101
|
+
Fecha: 2026-02-02
|
|
@@ -46,7 +46,6 @@ Archivos protegidos:
|
|
|
46
46
|
- `.agent/rules/**/*.md` (todas las reglas)
|
|
47
47
|
- `.agent/workflows/**/*.md` (todos los workflows)
|
|
48
48
|
- `.agent/index.md`
|
|
49
|
-
- `GEMINI.md` (si existe en el repositorio)
|
|
50
49
|
|
|
51
50
|
**Prohibiciones**:
|
|
52
51
|
- ❌ Ningún agente (qa, researcher, neo) puede modificar reglas
|
|
@@ -11,7 +11,7 @@ severity: PERMANENT
|
|
|
11
11
|
scope: global
|
|
12
12
|
|
|
13
13
|
capabilities:
|
|
14
|
-
skills: []
|
|
14
|
+
skills: ["skill.runtime-governance"]
|
|
15
15
|
tools:
|
|
16
16
|
git: supported
|
|
17
17
|
---
|
|
@@ -97,3 +97,4 @@ Eres el maximo responsable de la integridad del ciclo de vida:
|
|
|
97
97
|
2. **Validacion fisica**: Nunca procedas a una fase si el artefacto de la fase anterior no contiene la marca fisica de aprobacion del usuario.
|
|
98
98
|
3. **Cero decision propia en gates**: No tienes autoridad para decidir que un gate es innecesario.
|
|
99
99
|
4. **Espejo del proceso**: Si el usuario pide saltarse un paso, tu rol es recordarle la constitucion y los riesgos.
|
|
100
|
+
5. **Gobernanza por Skill**: DEBES utilizar obligatoriamente el procedimiento de `skill.runtime-governance` para cada gate y cambio de fase. No tienes autoridad para prescindir de la trazabilidad MCP.
|
|
@@ -1,3 +1,10 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: task.init
|
|
3
|
+
title: Initialization
|
|
4
|
+
owner: {{architectAgentId}}
|
|
5
|
+
phase:
|
|
6
|
+
current: init
|
|
7
|
+
---
|
|
1
8
|
# init bootstrap
|
|
2
9
|
|
|
3
10
|
- command: {{command}}
|
|
@@ -19,3 +26,14 @@ constitution:
|
|
|
19
26
|
- {{constitutionPaths[0]}}
|
|
20
27
|
- {{constitutionPaths[1]}}
|
|
21
28
|
- {{constitutionPaths[2]}}
|
|
29
|
+
language:
|
|
30
|
+
value: {{language}}
|
|
31
|
+
confirmed: {{languageConfirmed}}
|
|
32
|
+
strategy: {{strategy}}
|
|
33
|
+
traceability:
|
|
34
|
+
verified: {{traceabilityVerified}}
|
|
35
|
+
mcp_tool: {{traceabilityTool}}
|
|
36
|
+
response: {{traceabilityResponse}}
|
|
37
|
+
timestamp: {{traceabilityTimestamp}}
|
|
38
|
+
runtime:
|
|
39
|
+
started: {{runtimeStarted}}
|
|
@@ -1,12 +1,9 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Workflow obligatorio de setup: verifica GEMINI.location, carga constitutions base y define el idioma de conversación y la estrategia Long/Short.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
1
|
---
|
|
6
2
|
id: workflow.init
|
|
7
3
|
owner: architect-agent
|
|
8
4
|
version: 4.0.0
|
|
9
5
|
severity: PERMANENT
|
|
6
|
+
description: "Workflow obligatorio de setup: carga constitutions base y define el idioma de conversación y la estrategia Long/Short."
|
|
10
7
|
trigger:
|
|
11
8
|
commands: ["init", "/init", "/agentic-init"]
|
|
12
9
|
blocking: true
|
|
@@ -45,6 +42,15 @@ El agente **DEBE** adherirse a estas meta-reglas de comportamiento durante TODA
|
|
|
45
42
|
- Si el usuario pide saltarse pasos, el agente **DEBE** recordar las reglas de constitución y rechazar amablemente el atajo.
|
|
46
43
|
|
|
47
44
|
## Pasos obligatorios
|
|
45
|
+
0. **Verificar Trazabilidad e Iniciar Runtime (OBLIGATORIO)**:
|
|
46
|
+
- Antes de cualquier acción, verificar conectividad MCP mediante `runtime_chat`.
|
|
47
|
+
- **Inmediatamente después**, llamar a `runtime.run` con:
|
|
48
|
+
- `taskPath`: Ruta al artefacto init que se creará (`.agent/artifacts/candidate/init.md`)
|
|
49
|
+
- `agent`: `architect-agent`
|
|
50
|
+
- El agente **DEBE** confirmar que ambas herramientas respondieron correctamente (`status: ok`).
|
|
51
|
+
- **PROHIBICIÓN ESTRICTA**: No se permite consolidar este paso con la creación de artefactos en una misma respuesta. El agente debe esperar la confirmación del sistema antes de proceder al paso 1.
|
|
52
|
+
- Si las herramientas MCP no están disponibles → ir a **Paso 9 (FAIL)**, a menos que el desarrollador autorice explícitamente el fallback.
|
|
53
|
+
|
|
48
54
|
1. Activar `architect-agent` como rol arquitecto.
|
|
49
55
|
- Mostrar un mensaje único de estado (ej: "Cargando init...") y **no** listar lecturas de ficheros individuales.
|
|
50
56
|
- En ese mismo mensaje, presentar al architect-agent y dar contexto al desarrollador: rol, objetivo del init y qué información se le pedirá a continuación.
|
|
@@ -60,9 +66,8 @@ El agente **DEBE** adherirse a estas meta-reglas de comportamiento durante TODA
|
|
|
60
66
|
- Si alguna falla → FAIL.
|
|
61
67
|
|
|
62
68
|
3. Cargar en contexto las constitutions (en orden):
|
|
63
|
-
1) `constitution.
|
|
64
|
-
2) `constitution.
|
|
65
|
-
3) `constitution.agents_behavior`
|
|
69
|
+
1) `constitution.clean_code`
|
|
70
|
+
2) `constitution.agents_behavior`
|
|
66
71
|
- **PROHIBIDO** cargar templates o artifacts en este paso.
|
|
67
72
|
- Si alguna falla → FAIL.
|
|
68
73
|
|
|
@@ -80,12 +85,19 @@ El agente **DEBE** adherirse a estas meta-reglas de comportamiento durante TODA
|
|
|
80
85
|
- `templates.init`
|
|
81
86
|
- Todos los campos obligatorios del template **DEBEN** completarse.
|
|
82
87
|
- Incluir el campo `strategy: long | short`.
|
|
88
|
+
- **REQUISITO DE TRAZABILIDAD**: Incluir una confirmación explícita de que el Paso 0 (MCP) fue ejecutado correctamente.
|
|
83
89
|
- No se permite modificar, omitir ni reinterpretar la estructura del template.
|
|
84
90
|
|
|
85
91
|
7. Escribir el fichero en:
|
|
86
92
|
- `artifacts.candidate.init`
|
|
87
93
|
|
|
88
|
-
8.
|
|
94
|
+
8. **Validar Gate con Runtime (OBLIGATORIO)**:
|
|
95
|
+
- **ANTES** de evaluar el Gate, el agente **DEBE** llamar a `runtime.validate_gate` con:
|
|
96
|
+
- `taskPath`: `.agent/artifacts/candidate/init.md`
|
|
97
|
+
- `agent`: `architect-agent`
|
|
98
|
+
- `expectedPhase`: `init`
|
|
99
|
+
- **Opcionalmente**, usar `debug_read_logs` para auditar que los pasos previos fueron registrados.
|
|
100
|
+
- Evaluar Gate según los requisitos definidos.
|
|
89
101
|
- Si Gate FAIL → ir a **Paso 9 (FAIL)**.
|
|
90
102
|
- Si Gate PASS → continuar.
|
|
91
103
|
|
|
@@ -115,8 +127,15 @@ Requisitos (todos obligatorios):
|
|
|
115
127
|
- `language.value` no vacío
|
|
116
128
|
- `language.confirmed == true`
|
|
117
129
|
- `strategy` es "long" o "short"
|
|
130
|
+
- **`traceability.verified == true`** (Confirma cumplimiento del Paso 0)
|
|
131
|
+
- **`runtime.started == true`** (Confirma que `runtime.run` fue llamado)
|
|
118
132
|
3) El artefacto cumple el template oficial.
|
|
119
133
|
4) Idioma definido y confirmado.
|
|
120
134
|
5) Estrategia seleccionada.
|
|
121
|
-
6)
|
|
122
|
-
|
|
135
|
+
6) **Trazabilidad completa**:
|
|
136
|
+
- El agente ha verificado conectividad MCP (`runtime_chat`).
|
|
137
|
+
- El agente ha llamado `runtime.run` para iniciar el workflow.
|
|
138
|
+
- El agente ha llamado `runtime.validate_gate` antes de evaluar el Gate.
|
|
139
|
+
7) No se cargaron índices fuera del set permitido (solo `.agent/index.md`, `agent.domains.rules.index`, `rules.constitution.index`).
|
|
140
|
+
8) El Root Index `.agent/index.md` fue cargado antes de cualquier otro índice.
|
|
141
|
+
9) **Auditoría de logs**: Los pasos del workflow deben estar registrados en el buffer de logs del runtime.
|
|
@@ -12,22 +12,22 @@ blocking: true
|
|
|
12
12
|
# WORKFLOW: tasklifecycle-long (Index)
|
|
13
13
|
|
|
14
14
|
## Índices requeridos (OBLIGATORIO)
|
|
15
|
-
Este workflow **NO** define aliases fuera de su dominio (`
|
|
15
|
+
Este workflow **NO** define aliases fuera de su dominio (`tasklifecycle-long`).
|
|
16
16
|
Para artifacts y templates, **DEBE** cargar índices globales:
|
|
17
17
|
|
|
18
18
|
- Artifacts index: `.agent/artifacts/index.md`
|
|
19
19
|
- Templates index: `.agent/templates/index.md`
|
|
20
20
|
|
|
21
|
-
## Aliases del dominio `
|
|
22
|
-
Este workflow define aliases **solo** del dominio `
|
|
23
|
-
Existe **un único namespace** `aliases.
|
|
21
|
+
## Aliases del dominio `tasklifecycle-long` (OBLIGATORIO)
|
|
22
|
+
Este workflow define aliases **solo** del dominio `tasklifecycle-long` (task lifecycle long).
|
|
23
|
+
Existe **un único namespace** `aliases.tasklifecycle-long.phases.*` que contiene:
|
|
24
24
|
- `id` de fase
|
|
25
25
|
- `workflow` (path del workflow de la fase)
|
|
26
26
|
|
|
27
27
|
## Aliases (YAML)
|
|
28
28
|
```yaml
|
|
29
29
|
aliases:
|
|
30
|
-
|
|
30
|
+
tasklifecycle-long:
|
|
31
31
|
phases:
|
|
32
32
|
phase_0:
|
|
33
33
|
id: phase-0-acceptance-criteria
|
|
@@ -77,7 +77,7 @@ aliases:
|
|
|
77
77
|
## Objetivo (ONLY)
|
|
78
78
|
- Verificar los requisitos mínimos para **iniciar la Fase 0** (inputs obligatorios).
|
|
79
79
|
- Crear el **task candidate** usando el template contractual.
|
|
80
|
-
- Verificar que los workflows de fase del dominio `
|
|
80
|
+
- Verificar que los workflows de fase del dominio `tasklifecycle-long` existen y se pueden cargar.
|
|
81
81
|
- Si falta algún requisito, **bloquear** y pedir la acción mínima para poder iniciar la **Fase 0**.
|
|
82
82
|
|
|
83
83
|
> Este workflow **NO** controla si las fases se han completado.
|
|
@@ -85,7 +85,7 @@ aliases:
|
|
|
85
85
|
|
|
86
86
|
## Dispatch / Routing (OBLIGATORIO)
|
|
87
87
|
- El routing de fases **DEBE** basarse en `task.phase.current`.
|
|
88
|
-
- La fase activa **DEBE** mapearse a `aliases.
|
|
88
|
+
- La fase activa **DEBE** mapearse a `aliases.tasklifecycle-long.phases.*.workflow`.
|
|
89
89
|
- Si no existe mapping → **FAIL** (fase inválida o índice corrupto).
|
|
90
90
|
- Solo el `architect-agent` puede cambiar `task.phase.current`.
|
|
91
91
|
|
|
@@ -114,20 +114,20 @@ aliases:
|
|
|
114
114
|
- **DEBE incluir** la información proporcionada por el desarrollador:
|
|
115
115
|
- descripción de la tarea
|
|
116
116
|
- objetivo de la tarea
|
|
117
|
-
- Inicializar `task.phase.current` a `aliases.
|
|
117
|
+
- Inicializar `task.phase.current` a `aliases.tasklifecycle-long.phases.phase_0.id`.
|
|
118
118
|
- Si no se puede crear/escribir → ir a **Paso 7 (FAIL)**.
|
|
119
119
|
|
|
120
120
|
6. Verificar disponibilidad de fases (solo existencia/carga)
|
|
121
121
|
- Los workflows de fase **DEBEN** existir como ficheros (no se ejecutan aquí):
|
|
122
|
-
- `aliases.
|
|
123
|
-
- `aliases.
|
|
124
|
-
- `aliases.
|
|
125
|
-
- `aliases.
|
|
126
|
-
- `aliases.
|
|
127
|
-
- `aliases.
|
|
128
|
-
- `aliases.
|
|
129
|
-
- `aliases.
|
|
130
|
-
- `aliases.
|
|
122
|
+
- `aliases.tasklifecycle-long.phases.phase_0.workflow`
|
|
123
|
+
- `aliases.tasklifecycle-long.phases.phase_1.workflow`
|
|
124
|
+
- `aliases.tasklifecycle-long.phases.phase_2.workflow`
|
|
125
|
+
- `aliases.tasklifecycle-long.phases.phase_3.workflow`
|
|
126
|
+
- `aliases.tasklifecycle-long.phases.phase_4.workflow`
|
|
127
|
+
- `aliases.tasklifecycle-long.phases.phase_5.workflow`
|
|
128
|
+
- `aliases.tasklifecycle-long.phases.phase_6.workflow`
|
|
129
|
+
- `aliases.tasklifecycle-long.phases.phase_7.workflow`
|
|
130
|
+
- `aliases.tasklifecycle-long.phases.phase_8.workflow`
|
|
131
131
|
- Si falta alguno → ir a **Paso 7 (FAIL)**.
|
|
132
132
|
|
|
133
133
|
7. FAIL (obligatorio)
|
|
@@ -138,7 +138,7 @@ aliases:
|
|
|
138
138
|
- idioma no definido o no confirmado en `init`
|
|
139
139
|
- template inaccesible (`templates.task`)
|
|
140
140
|
- no se pudo crear `task candidate` (`artifacts.candidate.task`)
|
|
141
|
-
- falta uno o más workflows de fase (`aliases.
|
|
141
|
+
- falta uno o más workflows de fase (`aliases.tasklifecycle-long.phases.*.workflow`)
|
|
142
142
|
- Pedir la acción mínima para solventar:
|
|
143
143
|
- ejecutar `init`
|
|
144
144
|
- confirmar idioma
|
|
@@ -152,15 +152,15 @@ Las fases del ciclo de vida **DEBEN ejecutarse estrictamente en el orden numéri
|
|
|
152
152
|
No se permite saltar, reordenar ni paralelizar fases.
|
|
153
153
|
|
|
154
154
|
Orden obligatorio:
|
|
155
|
-
0. `aliases.
|
|
156
|
-
1. `aliases.
|
|
157
|
-
2. `aliases.
|
|
158
|
-
3. `aliases.
|
|
159
|
-
4. `aliases.
|
|
160
|
-
5. `aliases.
|
|
161
|
-
6. `aliases.
|
|
162
|
-
7. `aliases.
|
|
163
|
-
8. `aliases.
|
|
155
|
+
0. `aliases.tasklifecycle-long.phases.phase_0.id`
|
|
156
|
+
1. `aliases.tasklifecycle-long.phases.phase_1.id`
|
|
157
|
+
2. `aliases.tasklifecycle-long.phases.phase_2.id`
|
|
158
|
+
3. `aliases.tasklifecycle-long.phases.phase_3.id`
|
|
159
|
+
4. `aliases.tasklifecycle-long.phases.phase_4.id`
|
|
160
|
+
5. `aliases.tasklifecycle-long.phases.phase_5.id`
|
|
161
|
+
6. `aliases.tasklifecycle-long.phases.phase_6.id`
|
|
162
|
+
7. `aliases.tasklifecycle-long.phases.phase_7.id`
|
|
163
|
+
8. `aliases.tasklifecycle-long.phases.phase_8.id`
|
|
164
164
|
|
|
165
165
|
## Gate (REQUIRED)
|
|
166
166
|
Requisitos (todos obligatorios):
|
|
@@ -22,6 +22,7 @@ blocking: true
|
|
|
22
22
|
> **Constitución activa (OBLIGATORIO)**:
|
|
23
23
|
> - Cargar `constitution.clean_code` antes de iniciar
|
|
24
24
|
> - Cargar `constitution.agents_behavior` (sección 7: Gates, sección 8: Constitución)
|
|
25
|
+
> - **Activar `skill.runtime-governance`** (Uso exclusivo del Architect para validación y trazabilidad)
|
|
25
26
|
|
|
26
27
|
## Output (REQUIRED)
|
|
27
28
|
- Current task (definitiva) con acceptance criteria completos:
|
|
@@ -39,7 +40,11 @@ blocking: true
|
|
|
39
40
|
- Registrar los acceptance criteria dentro del fichero de current task.
|
|
40
41
|
|
|
41
42
|
## Pasos obligatorios
|
|
42
|
-
0.
|
|
43
|
+
0. **Verificar Gobernanza (OBLIGATORIO)**:
|
|
44
|
+
- Activar `skill.runtime-governance`.
|
|
45
|
+
- Ejecutar el procedimiento de trazabilidad inicial (Paso 0 del Skill).
|
|
46
|
+
- El agente **DEBE** confirmar que el sistema de logs está activo antes de proceder.
|
|
47
|
+
- Usar prefijo obligatorio en cada mensaje.
|
|
43
48
|
1. Cargar y leer el task candidate:
|
|
44
49
|
- `artifacts.candidate.task`
|
|
45
50
|
- Extraer:
|
|
@@ -121,12 +126,16 @@ blocking: true
|
|
|
121
126
|
|
|
122
127
|
9. PASS
|
|
123
128
|
- Informar que la Fase 0 está completada correctamente.
|
|
129
|
+
- Seguimiento del protocolo de cierre en `skill.runtime-governance`:
|
|
130
|
+
- Llamar `runtime.validate_gate` para verificar integridad.
|
|
131
|
+
- Solicitar aprobación final al usuario.
|
|
132
|
+
- Llamar `runtime.advance_phase` tras el "SI".
|
|
124
133
|
- El `architect-agent` **DEBE realizar explícitamente** las siguientes acciones:
|
|
125
134
|
- Marcar la Fase 0 como completada en el `task.md`.
|
|
126
135
|
- Establecer `task.lifecycle.phases.phase-0-acceptance-criteria.validated_at = <ISO-8601>`.
|
|
127
136
|
- Actualizar `task.phase.updated_at = <ISO-8601>`.
|
|
128
137
|
- Actualizar el estado:
|
|
129
|
-
- `task.phase.current = aliases.
|
|
138
|
+
- `task.phase.current = aliases.tasklifecycle-long.phases.phase_1.id`
|
|
130
139
|
- Esta actualización **NO es automática** y **NO puede ser inferida**.
|
|
131
140
|
- Hasta que este cambio no se refleje en el `task.md`, **no se puede iniciar la Fase 1**.
|
|
132
141
|
|
|
@@ -162,12 +171,13 @@ Requisitos (todos obligatorios):
|
|
|
162
171
|
- `approval.developer.decision == SI`
|
|
163
172
|
8. El `architect-agent` ha marcado explícitamente:
|
|
164
173
|
- la Fase 0 como completada
|
|
165
|
-
- `task.phase.current == aliases.
|
|
174
|
+
- `task.phase.current == aliases.tasklifecycle-long.phases.phase_1.id`
|
|
166
175
|
9. `task.md` refleja timestamp y estado:
|
|
167
176
|
- `task.lifecycle.phases.phase-0-acceptance-criteria.completed == true`
|
|
168
177
|
- `task.lifecycle.phases.phase-0-acceptance-criteria.validated_at` no nulo
|
|
169
178
|
- `task.phase.updated_at` no nulo
|
|
170
179
|
10. Las 5 preguntas obligatorias fueron realizadas y respondidas por el desarrollador.
|
|
180
|
+
11. **Gobernanza verificada**: El historial de logs muestra la secuencia de herramientas MCP definida en `skill.runtime-governance`.
|
|
171
181
|
|
|
172
182
|
Si Gate FAIL:
|
|
173
183
|
- Ejecutar **FAIL**.
|
|
@@ -15,7 +15,7 @@ blocking: true
|
|
|
15
15
|
- Existe la current task:
|
|
16
16
|
- `.agent/artifacts/<taskId>-<taskTitle>/task.md`
|
|
17
17
|
- El `task.md` **DEBE** reflejar:
|
|
18
|
-
- `task.phase.current == aliases.
|
|
18
|
+
- `task.phase.current == aliases.tasklifecycle-long.phases.phase_1.id`
|
|
19
19
|
- El `task.md` **DEBE** incluir:
|
|
20
20
|
- descripcion
|
|
21
21
|
- objetivo
|
|
@@ -25,6 +25,7 @@ blocking: true
|
|
|
25
25
|
> **Constitución activa (OBLIGATORIO)**:
|
|
26
26
|
> - Cargar `constitution.clean_code` antes de iniciar
|
|
27
27
|
> - Cargar `constitution.agents_behavior` (sección 7: Gates, sección 8: Constitución)
|
|
28
|
+
> - **Activar `skill.runtime-governance`** (Para validación de gate y trazabilidad)
|
|
28
29
|
|
|
29
30
|
## Output (REQUIRED)
|
|
30
31
|
- Research report (obligatorio, generado por researcher-agent):
|
|
@@ -59,7 +60,7 @@ blocking: true
|
|
|
59
60
|
|
|
60
61
|
1. Verificar inputs (architect-agent)
|
|
61
62
|
- Existe `task.md`
|
|
62
|
-
- `task.phase.current == aliases.
|
|
63
|
+
- `task.phase.current == aliases.tasklifecycle-long.phases.phase_1.id`
|
|
63
64
|
- `task.md` contiene acceptance criteria
|
|
64
65
|
- Si falla → ir a **Paso 8 (FAIL)**.
|
|
65
66
|
|
|
@@ -113,7 +114,7 @@ blocking: true
|
|
|
113
114
|
- marcar Fase 1 como completada
|
|
114
115
|
- establecer `task.lifecycle.phases.phase-1-research.validated_at = <ISO-8601>`
|
|
115
116
|
- actualizar `task.phase.updated_at = <ISO-8601>`
|
|
116
|
-
- avanzar `task.phase.current = aliases.
|
|
117
|
+
- avanzar `task.phase.current = aliases.tasklifecycle-long.phases.phase_2.id`
|
|
117
118
|
|
|
118
119
|
---
|
|
119
120
|
|
|
@@ -145,10 +146,11 @@ Requisitos (todos obligatorios):
|
|
|
145
146
|
7. El informe **NO contiene** análisis, recomendaciones ni valoraciones.
|
|
146
147
|
8. `task.md` refleja:
|
|
147
148
|
- Fase 1 completada
|
|
148
|
-
- `task.phase.current == aliases.
|
|
149
|
+
- `task.phase.current == aliases.tasklifecycle-long.phases.phase_2.id`
|
|
149
150
|
- `task.lifecycle.phases.phase-1-research.completed == true`
|
|
150
151
|
- `task.lifecycle.phases.phase-1-research.validated_at` no nulo
|
|
151
152
|
- `task.phase.updated_at` no nulo
|
|
153
|
+
6. **Gobernanza verificada**: El historial de logs muestra la secuencia de herramientas MCP definida en `skill.runtime-governance`.
|
|
152
154
|
|
|
153
155
|
Si Gate FAIL:
|
|
154
156
|
- Ejecutar **Paso 8 (FAIL)**.
|
|
@@ -20,7 +20,7 @@ blocking: true
|
|
|
20
20
|
- descripcion
|
|
21
21
|
- objetivo
|
|
22
22
|
- acceptance criteria definidos
|
|
23
|
-
- `task.phase.current == aliases.
|
|
23
|
+
- `task.phase.current == aliases.tasklifecycle-long.phases.phase_2.id`
|
|
24
24
|
|
|
25
25
|
> [!IMPORTANT]
|
|
26
26
|
> **Constitución activa (OBLIGATORIO)**:
|
|
@@ -59,7 +59,7 @@ Crear un informe de **analisis** profundo que:
|
|
|
59
59
|
1. Verificar inputs
|
|
60
60
|
- Existe `.agent/artifacts/<taskId>-<taskTitle>/task.md`
|
|
61
61
|
- Existe `.agent/artifacts/<taskId>-<taskTitle>/researcher/research.md`
|
|
62
|
-
- `task.phase.current == aliases.
|
|
62
|
+
- `task.phase.current == aliases.tasklifecycle-long.phases.phase_2.id`
|
|
63
63
|
- El `task.md` contiene acceptance criteria definidos
|
|
64
64
|
- El research esta aprobado por el desarrollador (SI)
|
|
65
65
|
- Si falla → ir a **Paso 10 (FAIL)**.
|
|
@@ -109,7 +109,7 @@ Crear un informe de **analisis** profundo que:
|
|
|
109
109
|
- marcar Fase 2 como completada
|
|
110
110
|
- establecer `task.lifecycle.phases.phase-2-analysis.validated_at = <ISO-8601>`
|
|
111
111
|
- actualizar `task.phase.updated_at = <ISO-8601>`
|
|
112
|
-
- avanzar `task.phase.current = aliases.
|
|
112
|
+
- avanzar `task.phase.current = aliases.tasklifecycle-long.phases.phase_3.id`
|
|
113
113
|
- Indicar rutas:
|
|
114
114
|
- `analysis.md`
|
|
115
115
|
- `task.md` actualizado
|
|
@@ -136,7 +136,7 @@ Requisitos (todos obligatorios):
|
|
|
136
136
|
- `approval.developer.decision == SI`
|
|
137
137
|
6. `task.md` refleja:
|
|
138
138
|
- Fase 2 completada
|
|
139
|
-
- `task.phase.current == aliases.
|
|
139
|
+
- `task.phase.current == aliases.tasklifecycle-long.phases.phase_3.id`
|
|
140
140
|
- `task.lifecycle.phases.phase-2-analysis.completed == true`
|
|
141
141
|
- `task.lifecycle.phases.phase-2-analysis.validated_at` no nulo
|
|
142
142
|
- `task.phase.updated_at` no nulo
|