@christianmaf80/agentic-workflow 1.8.0-beta.1 → 1.11.0-beta.1

package/dist/templates/task.md

@@ -1,28 +1,24 @@
 # Task (Template)
 
-## Agent Identification (MANDATORY)
-First line of the document:
-`<icon> **<agent-name>**: <message>`
-
-## Identification
+## Identificación
 - id: {{task.id}}
 - title: {{task.title}}
 - scope: candidate | current
 - owner: architect-agent
 
-## Source
+## Origen
 - created_from:
   - workflow: tasklifecycle
   - source: init / tasklifecycle
   - candidate_path: artifacts.candidate.task
 
-## Task Description
+## Descripción de la tarea
 {{task.description}}
 
-## Objective
+## Objetivo
 {{task.goal}}
 
-## Lifecycle Status (SINGLE SOURCE OF TRUTH)
+## Estado del ciclo de vida (FUENTE ÚNICA DE VERDAD)
 
 ```yaml
 task:
@@ -134,18 +130,18 @@ task:
 
 ---
 
-## 2. Definition and Scope (Contract)
+## 2. Definición y Alcance (Contrato)
 - **Acceptance Criteria**: [acceptance.md](file:///{{task.acceptance_path}})
 - **Alias**: `task.acceptance`
 
 ---
 
-## Contractual Rules
-- This file is the **single source of truth** for the task status.
-- The `task.phase.current` field **ONLY can be modified by `architect-agent`**.
-- The `task.lifecycle.phases.*` field **ONLY can be marked as completed by `architect-agent`**.
-- A phase **cannot be marked as completed** if it is not the current phase.
-- Advancing to the next phase requires:
-  1. Marking the current phase as `completed: true`
-  2. Explicit validation from the architect
-  3. Updating `task.phase.current` to the next phase
+## Reglas contractuales
+- Este fichero es la **fuente única de verdad** del estado de la tarea.
+- El campo `task.phase.current` **SOLO puede ser modificado por `architect-agent`**.
+- El campo `task.lifecycle.phases.*` **SOLO puede ser marcado como completed por `architect-agent`**.
+- Una fase **NO puede marcarse como completed** si no es la fase actual.
+- El avance de fase requiere:
+  1. Marcar la fase actual como `completed: true`
+  2. Validación explícita del architect
+  3. Actualización de `task.phase.current` a la siguiente fase

package/dist/templates/todo-item.md

@@ -2,48 +2,44 @@
 artifact: todo_item
 owner: architect-agent
 status: open | in-progress | done | cancelled
-priority: high | medium | low
+priority: alta | media | baja
 ---
 
-# TODO: <brief title>
+# TODO: <título breve>
 
-## Agent Identification (MANDATORY)
-First line of the document:
-`<icon> **<agent-name>**: <message>`
+## Origen
+- **Detectado en tarea**: <taskId>-<taskTitle>
+- **Fase**: <phase donde se detectó>
+- **Fecha**: <ISO-8601>
+- **Agente**: <agente que lo detectó>
 
-## Source
-- **Detected in task**: <taskId>-<taskTitle>
-- **Phase**: <phase where it was detected>
-- **Date**: <ISO-8601>
-- **Agent**: <agent who detected it>
+## Descripción
+<Descripción clara de la mejora propuesta>
 
-## Description
-<Clear description of the proposed improvement>
+## Justificación
+<Por qué es importante hacer este cambio>
 
-## Justification
-<Why it is important to make this change>
+## Impacto estimado
+- **Complejidad**: baja | media | alta
+- **Áreas afectadas**: <componentes/workflows/templates>
 
-## Estimated Impact
-- **Complexity**: low | medium | high
-- **Affected Areas**: <components/workflows/templates>
+## Criterio de aceptación
+- [ ] <Condición verificable 1>
+- [ ] <Condición verificable 2>
 
-## Acceptance Criteria
-- [ ] <Verifiable condition 1>
-- [ ] <Verifiable condition 2>
-
-## Notes
-<Additional relevant information>
+## Notas
+<Información adicional relevante>
 
 ---
 
-## History
+## Historial
 ```yaml
 history:
   - action: created
     date: <ISO-8601>
-    by: <agent>
+    by: <agente>
   # - action: started | completed | cancelled
   #   date: <ISO-8601>
-  #   by: <agent>
-  #   task: <taskId where it was implemented>
+  #   by: <agente>
+  #   task: <taskId donde se implementó>
 ```

package/dist/templates/verification.md

@@ -10,68 +10,68 @@ related_review: .agent/artifacts/<taskId>-<taskTitle>/architect/review.md
 
 # Verification Report — <taskId>-<taskTitle>
 
-## Agent Identification (MANDATORY)
-First line of the document:
-`<icon> **<agent-name>**: <message>`
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
 
-## 1. Verification Scope
-- What was verified
-- What was excluded
+## 1. Alcance de verificacion
+- Que se verifico
+- Que quedo fuera
 
 ---
 
-## 2. Executed Tests
-- Unit tests (as per `constitution.project_architecture`)
+## 2. Tests ejecutados
+- Unit tests (segun `constitution.extensio-architecture`)
   - Suites
-  - Result (pass/fail)
-- Integration tests (as per `constitution.project_architecture`, if applicable)
+  - Resultado (pass/fail)
+- Integration tests (segun `constitution.extensio-architecture`, si aplica)
   - Suites
-  - Result (pass/fail)
-- E2E tests (as per `constitution.project_architecture`, if applicable)
+  - Resultado (pass/fail)
+- E2E tests (segun `constitution.extensio-architecture`, si aplica)
   - Suites
-  - Result (pass/fail)
+  - Resultado (pass/fail)
 
 ---
 
-## 3. Coverage and Thresholds
-- Total Coverage (%)
-- Coverage per area (if applicable)
-- Thresholds defined in the plan (met / not met)
+## 3. Coverage y thresholds
+- Coverage total (%)
+- Coverage por area (si aplica)
+- Thresholds definidos en el plan (cumple / no cumple)
 
 ---
 
-## 4. Performance (if applicable)
-- Collected metrics
-- Thresholds (met / not met)
+## 4. Performance (si aplica)
+- Metricas recopiladas
+- Thresholds (cumple / no cumple)
 
 ---
 
-## 5. Evidence
+## 5. Evidencias
 - Logs
-- Test reports
-- Screenshots (if applicable)
+- Reportes de tests
+- Capturas (si aplica)
 
 ---
 
-## 6. Issues
-- Bugs found
-- Severity
-- Status
+## 6. Incidencias
+- Bugs encontrados
+- Severidad
+- Estado
 
 ---
 
 ## 7. Checklist
-- [ ] Verification completed
-- [ ] Testing thresholds met
-- [ ] Ready for Phase 6
+- [ ] Verificacion completada
+- [ ] Thresholds de testing cumplidos
+- [ ] Listo para fase 5
 
 ---
 
-## 8. Developer Approval (MANDATORY)
+## 8. Aprobacion del desarrollador (OBLIGATORIA)
 ```yaml
 approval:
   developer:
-    decision: YES | NO
+    decision: SI | NO
     date: <ISO-8601>
-    comments: <optional>
+    comments: <opcional>
 ```

package/dist/todo/001-anadir-seccion-reasoning.md

@@ -0,0 +1,42 @@
+---
+artifact: todo_item
+owner: architect-agent
+status: done
+priority: alta
+---
+
+# TODO: Añadir sección Reasoning a agent-task
+
+## Origen
+- **Detectado en tarea**: 19-refinar-sistema-agentes-ciclo-vida
+- **Fase**: Auditoría post-tarea
+- **Fecha**: 2026-01-18T18:51:27+01:00
+- **Agente**: architect-agent
+
+## Descripción
+Añadir una sección "Reasoning" obligatoria al template `agent-task.md` para forzar a los agentes a documentar su proceso de razonamiento (Chain of Thought) antes de implementar.
+
+## Justificación
+Según las best practices de OpenAI y LearnPrompting, documentar el razonamiento mejora la precisión del modelo y permite detectar errores de lógica antes de la implementación.
+
+## Impacto estimado
+- **Complejidad**: baja
+- **Áreas afectadas**: `templates/agent-task.md`
+
+## Criterio de aceptación
+- [ ] `agent-task.md` tiene sección "Reasoning (OBLIGATORIO)"
+- [ ] La sección incluye: Análisis del objetivo, Opciones consideradas, Decisión tomada
+- [ ] Al menos 1 tarea ejecutada usando el nuevo formato
+
+## Notas
+Referencia: Research Task #19, sección 3.5 Chain of Thought
+
+---
+
+## Historial
+```yaml
+history:
+  - action: created
+    date: 2026-01-18T18:51:27+01:00
+    by: architect-agent
+```

package/dist/todo/002-anadir-ejemplos-few-shot.md

@@ -0,0 +1,46 @@
+---
+artifact: todo_item
+owner: architect-agent
+status: open
+priority: media
+---
+
+# TODO: Añadir ejemplos Few-Shot a templates
+
+## Origen
+- **Detectado en tarea**: 19-refinar-sistema-agentes-ciclo-vida
+- **Fase**: Auditoría post-tarea
+- **Fecha**: 2026-01-18T18:51:27+01:00
+- **Agente**: architect-agent
+
+## Descripción
+Añadir ejemplos concretos (Few-Shot) a los templates críticos para demostrar el formato esperado y mejorar la adherencia del LLM.
+
+## Justificación
+Según las best practices de AWS y Microsoft, incluir ejemplos de alta calidad mejora significativamente el rendimiento del modelo respecto a zero-shot.
+
+## Impacto estimado
+- **Complejidad**: media
+- **Áreas afectadas**: 
+  - `templates/agent-task.md`
+  - `templates/research.md`
+  - `templates/analysis.md`
+  - `templates/todo-item.md`
+
+## Criterio de aceptación
+- [ ] Cada template tiene una sección "Ejemplo (Few-Shot)" o similar
+- [ ] Los ejemplos están completos y son realistas
+- [ ] Los ejemplos no aumentan excesivamente el tamaño del template
+
+## Notas
+Referencia: Research Task #19, sección 3.4 Few-Shot Prompting
+
+---
+
+## Historial
+```yaml
+history:
+  - action: created
+    date: 2026-01-18T18:51:27+01:00
+    by: architect-agent
+```

package/dist/todo/003-explorar-paralelizacion-phase4.md

@@ -0,0 +1,46 @@
+---
+artifact: todo_item
+owner: architect-agent
+status: open
+priority: baja
+---
+
+# TODO: Explorar paralelización en Phase 4
+
+## Origen
+- **Detectado en tarea**: 19-refinar-sistema-agentes-ciclo-vida
+- **Fase**: Auditoría post-tarea
+- **Fecha**: 2026-01-18T18:51:27+01:00
+- **Agente**: architect-agent
+
+## Descripción
+Investigar la posibilidad de ejecutar subtareas independientes en paralelo durante Phase 4 (Implementation) para mejorar la velocidad de ejecución.
+
+## Justificación
+El patrón "Task Force" documentado en el research permite ejecutar tareas sin dependencias simultáneamente, lo que podría reducir el tiempo total de implementación.
+
+## Impacto estimado
+- **Complejidad**: alta
+- **Áreas afectadas**: 
+  - `workflows/tasklifecycle-long/phase-4-implementation.md`
+  - `templates/agent-task.md` (añadir campo de dependencias)
+
+## Criterio de aceptación
+- [ ] Investigar si el sistema actual soporta ejecución paralela
+- [ ] Definir cómo marcar tareas como "paralelizables"
+- [ ] Documentar si el Gate puede ejecutarse en batch o debe ser secuencial
+- [ ] Decidir SI/NO implementar
+
+## Notas
+Referencia: Research Task #19, sección 4.3 Task Force Pattern
+Este TODO puede descartarse si se decide que la paralelización no aporta valor suficiente.
+
+---
+
+## Historial
+```yaml
+history:
+  - action: created
+    date: 2026-01-18T18:51:27+01:00
+    by: architect-agent
+```

package/dist/todo/004-portable-agentic-system.md

@@ -0,0 +1,44 @@
+---
+artifact: todo_item
+owner: architect-agent
+status: open
+priority: alta
+---
+
+# TODO: Portable Agentic System
+
+## Origen
+- **Detectado en tarea**: 21-portable-agentic-system
+- **Fase**: phase-1-research
+- **Fecha**: 2026-01-19
+- **Agente**: researcher-agent
+
+## Descripción
+Crear un paquete npm portable (`@cmarino/agentic-workflow`) que permita distribuir el sistema de agentes (workflows, roles, templates) de forma agnóstica a Extensio. Incluye un CLI `agentic-workflow init` con asistente de configuración.
+
+## Justificación
+Permite aplicar este robusto sistema de orquestación a cualquier tipo de proyecto, desacoplándolo del framework Extensio.
+
+## Impacto estimado
+- **Complejidad**: alta
+- **Áreas afectadas**: workflows, templates, rules, CLI (nuevo paquete)
+
+## Criterio de aceptación
+- [ ] Paquete npm `@cmarino/agentic-workflow` creado y funcional.
+- [ ] CLI con comando `init` que crea `AGENTS.md` y carpeta `.agent/`.
+- [ ] Asistente de configuración guiado.
+- [ ] Workflows y templates desacoplados de Extensio.
+
+## Notas
+- Ver investigación inicial en `.agent/artifacts/21-portable-agentic-system/researcher/research.md`.
+- **Auditoría Tarea 23**: Se confirma que `AGENTS.md` es el único descriptor contractual faltante para el descubrimiento externo.
+
+---
+
+## Historial
+```yaml
+history:
+  - action: created
+    date: 2026-01-19
+    by: architect-agent
+```

package/dist/todo/README.md

@@ -0,0 +1,58 @@
+# TODO Backlog — Extensio
+
+> [!IMPORTANT]
+> Este directorio contiene el **backlog de mejora continua** del sistema agéntico.
+> El architect-agent **DEBE** consultar este directorio en cada Phase 2 (Analysis).
+
+## Propósito
+
+El TODO backlog captura mejoras detectadas durante la ejecución de tareas que:
+- No son bloqueantes para la tarea actual
+- Requieren planificación futura
+- Podrían mejorar el sistema agéntico o la arquitectura
+
+## Reglas de Uso
+
+### Cuándo crear un TODO
+1. Durante **Phase 4 (Implementation)**: si el desarrollador detecta una mejora no bloqueante
+2. Durante **Phase 5 (Verification)**: si QA identifica oportunidades de mejora
+3. Durante cualquier fase: si el architect-agent detecta deuda técnica
+
+### Cuándo consultar el TODO
+- **OBLIGATORIO** en Phase 2 (Analysis) — ver paso 5.5 del workflow
+- El architect-agent debe evaluar si algún item impacta en la tarea actual
+
+### Estructura de ficheros
+```
+.agent/todo/
+├── README.md              # Este fichero
+├── 001-mejorar-xxx.md     # Item de backlog (usa templates/todo-item.md)
+├── 002-refactor-yyy.md    # Otro item
+└── ...
+```
+
+### Nomenclatura
+- Formato: `<NNN>-<descripcion-corta>.md`
+- NNN: número secuencial de 3 dígitos
+- descripcion-corta: kebab-case, máximo 30 caracteres
+
+### Prioridades
+| Prioridad | Significado |
+|-----------|-------------|
+| **alta** | Debería implementarse en las próximas 2-3 tareas |
+| **media** | Implementar cuando sea conveniente |
+| **baja** | Nice-to-have, sin urgencia |
+
+## Estado actual
+
+**Items pendientes**: 3
+
+| # | Prioridad | Item |
+|---|-----------|------|
+| 001 | Alta | Añadir sección Reasoning a agent-task |
+| 002 | Media | Añadir ejemplos Few-Shot a templates |
+| 003 | Baja | Explorar paralelización en Phase 4 |
+
+---
+
+> Template para nuevos items: `templates/todo-item.md`

package/dist/todo/index.md

@@ -0,0 +1,27 @@
+---
+id: todo.index
+owner: architect-agent
+version: 1.0.0
+severity: PERMANENT
+---
+
+# INDEX — TODO Backlog
+
+## Objetivo
+Este fichero enumera los items pendientes del backlog de mejoras del sistema de agentes.
+
+## Aliases (YAML)
+```yaml
+todo:
+  readme: .agent/todo/README.md
+  items:
+    - .agent/todo/001-anadir-seccion-reasoning.md
+    - .agent/todo/002-anadir-ejemplos-few-shot.md
+    - .agent/todo/003-explorar-paralelizacion-phase4.md
+    - .agent/todo/004-portable-agentic-system.md
+```
+
+## Reglas
+- Los items **DEBEN** seguir el formato `NNN-descripcion-corta.md`.
+- Cada item **DEBE** usar el template `templates.todo_item`.
+- El architect-agent revisa el backlog en Phase 2 (Analysis).

package/dist/tools/extensio-cli.md

@@ -0,0 +1,76 @@
+---
+id: tool.extensio_cli
+type: tool
+owner: architect-agent
+version: 1.0.0
+severity: PERMANENT
+scope: global
+
+name: "@extensio/cli"
+runtime: node
+invocation: shell
+
+allowed_commands:
+  - "npx @extensio/cli --help"
+  - "npx @extensio/cli create --type driver --name <name> <params>"
+  - "npx @extensio/cli create --type module --name <name> <params>"
+  - "npx @extensio/cli create --type project --name <name> <params>"
+  - "npx @extensio/cli demo --type <type> --name <name> <params>"
+  - "npx @extensio/cli build"
+  - "npx @extensio/cli test"
+
+constraints:
+  destructive_requires_approval: true
+  requires_constitution:
+    - constitution.drivers
+---
+
+# TOOL: @extensio/cli
+
+## Objetivo
+Tool oficial para **scaffolding, build y testing** en Extensio.
+Permite crear entidades (drivers, modules, projects) y ejecutar build/test siguiendo la constitucion.
+
+## Uso
+- Los agentes **DEBEN** usar este tool para crear drivers cuando el comando exista.
+- La ejecución real del comando se realiza fuera de Antigravity
+  (IDE, CI o intervención humana).
+- `ext build` compila el `src/` del directorio actual. Debe ejecutarse desde el root
+  del modulo. Si una demo es un modulo dentro de un modulo padre, tambien se usa
+  `ext build` ejecutandolo desde la carpeta de la demo.
+
+## Ejemplos de uso
+- Ayuda:
+  - `npx @extensio/cli --help`
+- Crear driver:
+  - `npx @extensio/cli create --type driver --name prompt-ai --methods "createSession,prompt,close" --platforms "chrome" --includeDemo true --non-interactive`
+- Crear modulo:
+  - `npx @extensio/cli create --type module --name storage-core --inheritsCore true --withEngine true --withSurface false --non-interactive`
+- Crear proyecto:
+  - `npx @extensio/cli create --type project --name extensio-app --targetPath ./packages --non-interactive`
+- Crear demo para driver existente:
+  - `npx @extensio/cli demo --type driver --name prompt-ai --non-interactive`
+- Crear demo para modulo existente:
+  - `npx @extensio/cli demo --type module --name storage-core --non-interactive`
+- Build:
+  - `npx @extensio/cli build --browsers chrome,firefox --types --no-launch`
+- Tests:
+  - `npx @extensio/cli test --type unit --coverage --non-interactive`
+  - `npx @extensio/cli test --type e2e --browsers chromium --no-headless --non-interactive`
+
+## Seguridad
+- Los comandos destructivos requieren aprobación explícita del desarrollador (`SI | NO`).
+
+## Notas
+- Usar siempre `npx` para evitar dependencias globales.
+
+## Guia rapida (CLI local)
+Si agregas un comando nuevo al CLI, debes regenerar `dist/`:
+1. Instalar dependencias del workspace:
+   - `npm install`
+2. Compilar el CLI:
+   - `cd packages/cli && npm run build`
+3. Verificar el bin:
+   - `node dist/index.mjs --help`
+
+Nota: `packages/**/dist` esta en `.gitignore`, por lo que el bin requiere build local.

package/dist/tools/index.md

@@ -0,0 +1,14 @@
+---
+id: tools.index
+type: rule
+owner: architect-agent
+version: 1.0.0
+severity: PERMANENT
+scope: global
+---
+
+```yaml
+tools:
+  extensio_cli: .agent/tools/extensio-cli.md
+  run_command: .agent/tools/run-command.md
+```

package/dist/tools/run-command.md

@@ -0,0 +1,42 @@
+---
+id: tool.run_command
+type: tool
+owner: architect-agent
+version: 1.0.0
+severity: PERMANENT
+scope: global
+
+name: run_command
+runtime: shell
+invocation: shell
+
+allowed_commands:
+  - "npx tsc --noEmit"
+  - "npx eslint . --ext .ts,.mts,.tsx"
+  - "git diff --name-only --diff-filter=ACMR"
+
+constraints:
+  destructive_requires_approval: true
+  network_access_requires_approval: true
+---
+
+# TOOL: run_command
+
+## Objetivo
+Tool generico para ejecutar comandos de terminal cuando no existe un MCP tool especifico.
+Se usa principalmente para validaciones locales (TypeScript, ESLint) y utilidades de git.
+
+## Uso
+- Usar este tool solo cuando no haya un tool dedicado en `.agent/tools/index.md`.
+- Si el comando es destructivo o requiere red, pedir aprobacion explicita.
+
+## Ejemplos de uso
+- Validacion TypeScript:
+  - `npx tsc --noEmit`
+- Validacion ESLint:
+  - `npx eslint . --ext .ts,.mts,.tsx`
+- Archivos modificados:
+  - `git diff --name-only --diff-filter=ACMR`
+
+## Seguridad
+- Comandos destructivos o con acceso a red requieren aprobacion explicita del desarrollador.