@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.
Files changed (118) hide show
  1. package/README.es.md +84 -13
  2. package/README.md +83 -12
  3. package/RELEASE_PROCESS.md +4 -3
  4. package/bin/cli.js +39 -18
  5. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/acceptance.md +6 -0
  6. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-scores.md +6 -0
  7. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/1-dev-agent-scaffold.md +6 -0
  8. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/2-dev-agent-manifest-command.md +6 -0
  9. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/3-dev-agent-marketplace-evidence.md +6 -0
  10. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/4-qa-agent-verify-build.md +6 -0
  11. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/analysis.md +6 -0
  12. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/architect/review.md +6 -0
  13. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/metrics.md +6 -0
  14. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/plan.md +6 -0
  15. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/researcher/research.md +6 -0
  16. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/results-acceptance.md +6 -0
  17. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/task.md +6 -0
  18. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/verification.md +6 -0
  19. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/acceptance.md +6 -0
  20. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/task.md +6 -0
  21. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/acceptance.md +6 -0
  22. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/task.md +6 -0
  23. package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/acceptance.md +6 -0
  24. package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/architect/implementation.md +6 -0
  25. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/acceptance.md +6 -0
  26. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/1-dev-agent-reestructurar-carpetas.md +1 -1
  27. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/task.md +6 -0
  28. package/dist/agent/artifacts/6-release-beta-11/task.md +6 -0
  29. package/dist/agent/artifacts/candidate/init.md +8 -4
  30. package/dist/agent/artifacts/candidate/task.md +6 -0
  31. package/dist/agent/artifacts/task-20260128-reorganize-structure/acceptance.md +6 -0
  32. package/dist/agent/artifacts/task-20260128-reorganize-structure/brief.md +1 -1
  33. package/dist/agent/artifacts/task-20260128-reorganize-structure/closure.md +3 -3
  34. package/dist/agent/artifacts/task-20260128-reorganize-structure/implementation.md +2 -2
  35. package/dist/agent/artifacts/task-20260128-reorganize-structure/task.md +6 -0
  36. package/dist/agent/index.md +3 -0
  37. package/dist/agent/rules/constitution/agents-behavior.md +0 -1
  38. package/dist/agent/rules/constitution/clean-code.md +6 -0
  39. package/dist/agent/rules/constitution/index.md +1 -1
  40. package/dist/agent/rules/constitution/runtime-integration.md +101 -0
  41. package/dist/agent/rules/index.md +0 -1
  42. package/dist/agent/rules/roles/architect.md +2 -1
  43. package/dist/agent/templates/acceptance.md +6 -0
  44. package/dist/agent/templates/init.md +18 -0
  45. package/dist/agent/templates/supplemental-report.md +6 -0
  46. package/dist/agent/templates/task.md +7 -0
  47. package/dist/agent/workflows/init.md +29 -10
  48. package/dist/agent/workflows/tasklifecycle-long/index.md +27 -27
  49. package/dist/agent/workflows/tasklifecycle-long/phase-0-acceptance-criteria.md +13 -3
  50. package/dist/agent/workflows/tasklifecycle-long/phase-1-research.md +6 -4
  51. package/dist/agent/workflows/tasklifecycle-long/phase-2-analysis.md +4 -4
  52. package/dist/agent/workflows/tasklifecycle-long/phase-3-planning.md +4 -4
  53. package/dist/agent/workflows/tasklifecycle-long/phase-4-implementation.md +4 -4
  54. package/dist/agent/workflows/tasklifecycle-long/phase-5-verification.md +4 -4
  55. package/dist/agent/workflows/tasklifecycle-long/phase-6-results-acceptance.md +4 -4
  56. package/dist/agent/workflows/tasklifecycle-long/phase-7-evaluation.md +4 -4
  57. package/dist/agent/workflows/tasklifecycle-long/phase-8-commit-push.md +2 -2
  58. package/dist/agent/workflows/tasklifecycle-short/index.md +12 -9
  59. package/dist/agent/workflows/tasklifecycle-short/short-phase-1-brief.md +2 -0
  60. package/dist/cli/commands/create.js +30 -5
  61. package/dist/cli/commands/create.js.map +1 -1
  62. package/dist/cli/commands/init.js +9 -3
  63. package/dist/cli/commands/init.js.map +1 -1
  64. package/dist/cli/commands/mcp.js +11 -0
  65. package/dist/cli/commands/mcp.js.map +1 -0
  66. package/dist/cli/commands/register-mcp.js +116 -0
  67. package/dist/cli/commands/register-mcp.js.map +1 -0
  68. package/dist/cli/index.js +1 -0
  69. package/dist/cli/index.js.map +1 -1
  70. package/dist/infrastructure/context/index.js +2 -0
  71. package/dist/infrastructure/context/index.js.map +1 -0
  72. package/dist/{core → infrastructure}/context/manager.js +0 -1
  73. package/dist/infrastructure/context/manager.js.map +1 -0
  74. package/dist/infrastructure/index.js +7 -0
  75. package/dist/infrastructure/index.js.map +1 -0
  76. package/dist/infrastructure/logger/index.js +41 -0
  77. package/dist/infrastructure/logger/index.js.map +1 -0
  78. package/dist/infrastructure/mapping/index.js +2 -0
  79. package/dist/infrastructure/mapping/index.js.map +1 -0
  80. package/dist/{core → infrastructure}/mapping/resolver.js +5 -5
  81. package/dist/infrastructure/mapping/resolver.js.map +1 -0
  82. package/dist/infrastructure/migration/backup.js.map +1 -0
  83. package/dist/infrastructure/migration/detector.js.map +1 -0
  84. package/dist/infrastructure/migration/index.js +4 -0
  85. package/dist/infrastructure/migration/index.js.map +1 -0
  86. package/dist/infrastructure/migration/transformer.js.map +1 -0
  87. package/dist/infrastructure/utils/backup.js.map +1 -0
  88. package/dist/infrastructure/utils/index.js +2 -0
  89. package/dist/infrastructure/utils/index.js.map +1 -0
  90. package/dist/runtime/index.js +4 -0
  91. package/dist/runtime/index.js.map +1 -0
  92. package/dist/runtime/runtime.js +254 -0
  93. package/dist/runtime/runtime.js.map +1 -0
  94. package/dist/runtime/task-loader.js +32 -0
  95. package/dist/runtime/task-loader.js.map +1 -0
  96. package/dist/runtime/task-resolver.js +201 -0
  97. package/dist/runtime/task-resolver.js.map +1 -0
  98. package/package.json +16 -9
  99. package/dist/agent/rules/constitution/GEMINI.location.md +0 -32
  100. package/dist/core/context/manager.js.map +0 -1
  101. package/dist/core/index.js +0 -2
  102. package/dist/core/index.js.map +0 -1
  103. package/dist/core/mapping/resolver.js.map +0 -1
  104. package/dist/core/migration/backup.js.map +0 -1
  105. package/dist/core/migration/detector.js.map +0 -1
  106. package/dist/core/migration/transformer.js.map +0 -1
  107. package/dist/core/utils/backup.js.map +0 -1
  108. package/dist/extension/extension.js +0 -6
  109. package/dist/extension/extension.js.map +0 -1
  110. package/dist/extension/views/index.js +0 -2
  111. package/dist/extension/views/index.js.map +0 -1
  112. package/dist/extension/views/main-view.js +0 -53
  113. package/dist/extension/views/main-view.js.map +0 -1
  114. package/media/agent-chat.svg +0 -20
  115. /package/dist/{core → infrastructure}/migration/backup.js +0 -0
  116. /package/dist/{core → infrastructure}/migration/detector.js +0 -0
  117. /package/dist/{core → infrastructure}/migration/transformer.js +0 -0
  118. /package/dist/{core → infrastructure}/utils/backup.js +0 -0
@@ -1,3 +1,9 @@
1
+ ---
2
+ kind: artifact
3
+ name: task
4
+ source: agentic-system-structure
5
+ ---
6
+
1
7
  # Task: Reorganización de estructura de archivos y backups
2
8
 
3
9
  ## Identificación
@@ -1,3 +1,9 @@
1
+ ---
2
+ kind: artifact
3
+ name: acceptance
4
+ source: agentic-system-structure
5
+ ---
6
+
1
7
  # Acceptance Criteria — task-20260128-reorganize-structure
2
8
 
3
9
  ## Identificacion del agente (OBLIGATORIA)
@@ -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/core`, `src/test` ni `src/extension.ts`.
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/core/utils/backup.ts`
25
- - `src/core/migration/backup.ts`
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/core`, `src/cli`) y la configuración del sistema agéntico (`src/agentic-system-structure`). Se ha mantenido compatibilidad mediante un mirror en `.agent/`.
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
- - **Core (Backup Logic)**: Se ha actualizado la lógica de creación de backups en `src/core/migration/backup.ts` y `src/core/utils/backup.ts` para que los nuevos respaldos se guarden siempre en `.backups/`.
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/core` modificado. |
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
@@ -1,3 +1,9 @@
1
+ ---
2
+ kind: artifact
3
+ name: task
4
+ source: agentic-system-structure
5
+ ---
6
+
1
7
  # Task: Reorganización de estructura de archivos y backups
2
8
 
3
9
  ## Identificación
@@ -38,6 +38,9 @@ agent:
38
38
  rules:
39
39
  index: .agent/rules/index.md
40
40
 
41
+ skills:
42
+ index: .agent/skills/index.md
43
+
41
44
  ```
42
45
 
43
46
  ## Reglas
@@ -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`.
@@ -1,3 +1,9 @@
1
+ ---
2
+ kind: rule
3
+ name: clean-code
4
+ source: agentic-system-structure
5
+ ---
6
+
1
7
  # Clean Code Rules
2
8
 
3
9
  type: rules
@@ -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,9 @@
1
+ ---
2
+ kind: template
3
+ name: acceptance
4
+ source: agentic-system-structure
5
+ ---
6
+
1
7
  # Acceptance Criteria — {{task.id}}-{{task.title}}
2
8
 
3
9
  ## Identificacion del agente (OBLIGATORIA)
@@ -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,3 +1,9 @@
1
+ ---
2
+ kind: template
3
+ name: supplemental-report
4
+ source: agentic-system-structure
5
+ ---
6
+
1
7
  # Supplemental Report (Template)
2
8
 
3
9
  ## Identificacion
@@ -1,3 +1,10 @@
1
+ ---
2
+ id: {{task.id}}
3
+ title: {{task.title}}
4
+ owner: architect-agent
5
+ strategy: {{task.strategy}}
6
+ ---
7
+
1
8
  # Task (Template)
2
9
 
3
10
  ## Identificación
@@ -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.GEMINI_location`
64
- 2) `constitution.clean_code`
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. Evaluar Gate.
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) No se cargaron índices fuera del set permitido (solo `.agent/index.md`, `agent.domains.rules.index`, `rules.constitution.index`).
122
- 7) El Root Index `.agent/index.md` fue cargado antes de cualquier otro índice.
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 (`taskcycle-long`).
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 `taskcycle-long` (OBLIGATORIO)
22
- Este workflow define aliases **solo** del dominio `taskcycle-long` (task lifecycle long).
23
- Existe **un único namespace** `aliases.taskcycle-long.phases.*` que contiene:
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
- taskcycle-long:
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 `taskcycle-long` existen y se pueden cargar.
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.taskcycle-long.phases.*.workflow`.
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.taskcycle-long.phases.phase_0.id`.
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.taskcycle-long.phases.phase_0.workflow`
123
- - `aliases.taskcycle-long.phases.phase_1.workflow`
124
- - `aliases.taskcycle-long.phases.phase_2.workflow`
125
- - `aliases.taskcycle-long.phases.phase_3.workflow`
126
- - `aliases.taskcycle-long.phases.phase_4.workflow`
127
- - `aliases.taskcycle-long.phases.phase_5.workflow`
128
- - `aliases.taskcycle-long.phases.phase_6.workflow`
129
- - `aliases.taskcycle-long.phases.phase_7.workflow`
130
- - `aliases.taskcycle-long.phases.phase_8.workflow`
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.taskcycle-long.phases.*.workflow`)
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.taskcycle-long.phases.phase_0.id`
156
- 1. `aliases.taskcycle-long.phases.phase_1.id`
157
- 2. `aliases.taskcycle-long.phases.phase_2.id`
158
- 3. `aliases.taskcycle-long.phases.phase_3.id`
159
- 4. `aliases.taskcycle-long.phases.phase_4.id`
160
- 5. `aliases.taskcycle-long.phases.phase_5.id`
161
- 6. `aliases.taskcycle-long.phases.phase_6.id`
162
- 7. `aliases.taskcycle-long.phases.phase_7.id`
163
- 8. `aliases.taskcycle-long.phases.phase_8.id`
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. Activar `architect-agent` y usar prefijo obligatorio en cada mensaje.
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.taskcycle-long.phases.phase_1.id`
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.taskcycle-long.phases.phase_1.id`
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.taskcycle-long.phases.phase_1.id`
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.taskcycle-long.phases.phase_1.id`
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.taskcycle-long.phases.phase_2.id`
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.taskcycle-long.phases.phase_2.id`
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.taskcycle-long.phases.phase_2.id`
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.taskcycle-long.phases.phase_2.id`
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.taskcycle-long.phases.phase_3.id`
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.taskcycle-long.phases.phase_3.id`
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