@christianmaf80/agentic-workflow 1.14.0-beta.1 → 1.14.0-beta.2

package/dist/artifacts/4-adr-workflows-modulos/analysis.md

@@ -1,353 +0,0 @@
----
-artifact: analysis
-phase: phase-2-analysis
-owner: architect-agent
-status: draft
-related_task: 4-adr-workflows-modulos
----
-
-# Analysis — 4-adr-workflows-modulos
-
-## 1. Resumen ejecutivo
-
-### Problema
-El framework Extensio tiene un sistema maduro para gestionar el ciclo de vida de **drivers** (create, refactor, delete), pero carece de un sistema equivalente para **módulos**. Los módulos tienen mayor complejidad arquitectónica que los drivers y requieren un sistema de governance específico.
-
-### Objetivo
-Diseñar y documentar la arquitectura completa para gestionar el ciclo de vida de módulos mediante un ADR que especifique: agentes, workflows, templates, constitution y extensiones MCP.
-
-### Criterio de éxito
-El análisis es válido si:
-1. Cubre todos los acceptance criteria definidos en `task.md`
-2. Define claramente los componentes necesarios
-3. Establece las diferencias arquitectónicas con drivers
-4. Proporciona especificación técnica suficiente para la fase de planning
-
----
-
-## 2. Estado del proyecto (As-Is)
-
-### Estructura relevante
-
-```
-.agent/
-├── workflows/
-│   ├── drivers/          # ✓ Existe y es maduro
-│   │   ├── index.md
-│   │   ├── create.md
-│   │   ├── refactor.md
-│   │   └── delete.md
-│   └── modules/          # ✗ NO EXISTE
-├── templates/
-│   ├── driver-create.md  # ✓ Existe
-│   ├── driver-refactor.md
-│   ├── driver-delete.md
-│   └── module-*.md       # ✗ NO EXISTE
-├── rules/
-│   ├── constitution/
-│   │   ├── drivers.md    # ✓ Existe (295 líneas)
-│   │   └── modules.md    # ✗ NO EXISTE
-│   └── roles/
-│       ├── driver.md     # ✓ Existe
-│       └── module.md     # ✗ NO EXISTE
-```
-
-### Drivers existentes
-| Driver | Estado | Responsabilidad |
-|--------|--------|-----------------|
-| `driver-tabs` | Activo | Gestión de pestañas |
-| `driver-windows` | Activo | Gestión de ventanas |
-| `driver-storage` | Activo | Persistencia |
-| `driver-runtime` | Activo | Mensajería |
-| `driver-offscreen` | Activo | Offscreen documents |
-| `driver-prompt-ai` | Activo | Chrome AI API |
-
-### Core / Engine / Surfaces
-- **Engine**: Clase base en `packages/core/src/engine/engine.mts`
-- **Context**: Clase base en `packages/core/src/engine/context.mts`
-- **Surfaces**: Sistema de Shards/Pages en `packages/core/src/surface/`
-- **Decorators**: `@property`, `@onChanged` en `packages/core/src/decorator/`
-
-### Artifacts / tareas previas
-| Task ID | Título | Relevancia |
-|---------|--------|------------|
-| 1 | MCP Server Extensio CLI | Herramientas MCP ya implementadas |
-| 2 | Review MCP Agent System | Validación del sistema MCP |
-| 3 | Developer Feedback Gate | Mejora de gates de aprobación |
-
-### Limitaciones detectadas
-1. **No existe directorio `packages/modules/`** — Los módulos se integran en apps
-2. **El recurso MCP `extensio://modules` retorna array vacío** — No hay módulos registrados
-3. **La constitución de módulos está fragmentada** — Parte en `extensio-architecture.md`, sin documento dedicado
-
----
-
-## 3. Cobertura de Acceptance Criteria
-
-### AC-1: ADR completo con especificación técnica de todos los componentes
-
-**Interpretación**
-El ADR debe incluir especificación técnica detallada de:
-- 4 workflows (index + create + refactor + delete)
-- 3 templates (create, refactor, delete)
-- 1 constitution (modules.md)
-- 1 rol (module-agent)
-
-**Verificación**
-- Cada componente tiene sección dedicada con estructura completa
-- Los workflows incluyen pasos obligatorios, inputs, outputs y gates
-- Los templates definen todas las secciones requeridas
-- La constitution cubre reglas verificables y auditables
-
-**Riesgos / ambigüedades**
-- Riesgo: Duplicar contenido de `extensio-architecture.md`
-- Mitigación: La constitution de módulos DEBE referenciar la arquitectura base, solo añadir reglas operativas
-
----
-
-### AC-2: Documentación del rol `module-agent` y su relación con `architect-agent`
-
-**Interpretación**
-Definir el rol `module-agent` como owner del dominio de módulos, con:
-- Identidad y misión
-- Contrato obligatorio (sources of truth)
-- Responsabilidades principales
-- Relación de delegación con `architect-agent`
-- Capacidades y herramientas
-
-**Verificación**
-- El rol sigue el formato de `driver.md` (rol modelo)
-- Define capabilities.modules con permisos explícitos
-- Incluye sección de comunicación con architect-agent
-- Define DoD (Definition of Done)
-
-**Riesgos / ambigüedades**
-- Riesgo: Solapamiento de responsabilidades con architect-agent
-- Mitigación: El architect-agent detecta la necesidad y delega; module-agent ejecuta
-
----
-
-### AC-3: Especificación de workflows (create, refactor, delete)
-
-**Interpretación**
-Tres workflows con estructura paralela a drivers:
-- `modules/index.md`: Índice del dominio
-- `modules/create.md`: Creación de módulos
-- `modules/refactor.md`: Refactorización
-- `modules/delete.md`: Eliminación
-
-**Verificación**
-- Cada workflow tiene: Input, Output, Objetivo, Template, Pasos obligatorios, FAIL, Gate
-- Los workflows referencian `constitution.modules`
-- Los gates son verificables
-
-**Riesgos / ambigüedades**
-- Los módulos tienen scopes adicionales (Engine, Context, Surface)
-- El workflow de create debe validar scopes correctamente
-
----
-
-### AC-4: Especificación de templates necesarios
-
-**Interpretación**
-Tres templates de informe:
-- `module-create.md`: Informe de creación
-- `module-refactor.md`: Informe de refactorización
-- `module-delete.md`: Informe de eliminación
-
-**Verificación**
-- Cada template cubre las secciones específicas de módulos
-- Incluyen validación de scopes (Engine, Context, Surface)
-- Incluyen checklist de ciclo de vida
-
-**Riesgos / ambigüedades**
-- Los templates deben reflejar la mayor complejidad de módulos vs drivers
-
----
-
-### AC-5: Especificación de reglas de constitución
-
-**Interpretación**
-Documento `constitution.modules` que defina:
-- Qué es un módulo
-- Estructura obligatoria
-- Ciclo de vida (7 métodos)
-- Scopes permitidos
-- Reglas de reactividad
-- Prohibiciones
-- Criterios de auditoría
-
-**Verificación**
-- El documento sigue el formato de `drivers.md`
-- Incluye sección de severidad
-- Incluye ejemplos de código
-- No duplica `extensio-architecture.md`
-
-**Riesgos / ambigüedades**
-- Riesgo: La constitution se desactualiza respecto a `extensio-architecture.md`
-- Mitigación: Referenciar como source of truth, no copiar
-
----
-
-### AC-6: Especificación de extensiones MCP en `extensio-cli`
-
-**Interpretación**
-Documentar que las herramientas MCP existentes ya soportan módulos:
-- `extensio_create --type module` ✓
-- `extensio_build` ✓
-- `extensio_test` ✓
-- `extensio_demo --type module` ✓
-- `extensio://modules` (recurso) ✓
-
-**Verificación**
-- El ADR confirma que no se requieren nuevas herramientas
-- Documenta el uso de las herramientas existentes para módulos
-
-**Riesgos / ambigüedades**
-- Ninguno — Las herramientas ya existen
-
----
-
-### AC-7: ADR aprobado explícitamente por el desarrollador
-
-**Interpretación**
-El ADR final debe tener aprobación binaria (SI/NO) del desarrollador.
-
-**Verificación**
-- Sección de aprobación en el documento
-- Registro de fecha y comentarios
-
-**Riesgos / ambigüedades**
-- Ninguno — Es un gate estándar
-
----
-
-## 4. Research técnico
-
-### Basado en `researcher/research.md` (aprobado)
-
-**Decisión recomendada: Paralelismo con drivers**
-
-Los módulos deben seguir exactamente el mismo modelo estructural que los drivers:
-- Workflows en `.agent/workflows/modules/`
-- Templates en `.agent/templates/module-*.md`
-- Constitution en `.agent/rules/constitution/modules.md`
-- Rol en `.agent/rules/roles/module.md`
-
-**Justificación**:
-1. Consistencia con el modelo existente
-2. Curva de aprendizaje baja para agentes
-3. Reutilización de patrones probados
-4. Evolución independiente de cada dominio
-
----
-
-## 5. Agentes participantes
-
-### architect-agent
-**Responsabilidades**:
-- Detectar cuándo una tarea requiere crear/modificar/eliminar módulos
-- Delegar al `module-agent` durante la implementación
-- Validar la coherencia arquitectónica del resultado
-
-**Subáreas asignadas**:
-- Aprobación del ADR
-- Review arquitectónico post-implementación
-
-### module-agent (NUEVO)
-**Responsabilidades**:
-- Owner del ciclo de vida de módulos
-- Ejecutar workflows de create/refactor/delete
-- Auditar cumplimiento de `constitution.modules`
-- Validar scopes (Engine, Context, Surface)
-- Verificar uso correcto de decoradores
-- Detectar dependencias cruzadas prohibidas
-- Registrar lecciones aprendidas
-
-**Subáreas asignadas**:
-- Estructura de módulos
-- Ciclo de vida
-- Reactividad
-- Integración con Core
-
-### researcher-agent
-**Responsabilidades**:
-- Investigación técnica en Phase 1 (ya completada)
-
-### qa-agent
-**Responsabilidades**:
-- Validar tests unitarios y E2E (cuando aplique)
-- No aplica para este ADR (entregable es documentación)
-
-### Handoffs
-```
-architect-agent → module-agent (delegación de implementación)
-module-agent → architect-agent (review y aprobación)
-```
-
-### Componentes necesarios
-
-| Componente | Acción | Ubicación |
-|------------|--------|-----------|
-| Workflows | CREAR | `.agent/workflows/modules/` |
-| Templates | CREAR | `.agent/templates/module-*.md` |
-| Constitution | CREAR | `.agent/rules/constitution/modules.md` |
-| Rol | CREAR | `.agent/rules/roles/module.md` |
-| Índices | ACTUALIZAR | `.agent/workflows/index.md`, `.agent/templates/index.md`, `.agent/rules/roles/index.md`, `.agent/rules/constitution/index.md` |
-
-### Demo
-**No aplica** — El entregable es un ADR (documentación).
-
----
-
-## 6. Impacto de la tarea
-
-### Arquitectura
-- **Cambios estructurales**: Creación de nuevo dominio `workflows/modules/`
-- **Paralelismo**: Estructura idéntica a `workflows/drivers/`
-- **Extensibilidad**: Permite futuras operaciones sobre módulos
-
-### APIs / contratos
-- **Nuevos contratos**: `constitution.modules`, `role.module-agent`
-- **Sin cambios en código**: El ADR no modifica código fuente
-
-### Compatibilidad
-- **Sin breaking changes**: Es adición pura
-- **Retrocompatibilidad**: Los módulos existentes no se ven afectados
-
-### Testing / verificación
-- **Validación documental**: Revisión del ADR
-- **Sin tests automatizados**: El entregable es documentación
-
----
-
-## 7. Riesgos y mitigaciones
-
-| Riesgo | Impacto | Probabilidad | Mitigación |
-|--------|---------|--------------|------------|
-| Duplicar contenido de extensio-architecture.md | Medio | Alto | Constitution referencia sin copiar |
-| Rol module-agent se solapa con architect | Bajo | Medio | Definir boundaries claros |
-| Workflows demasiado rígidos | Bajo | Bajo | Gates verificables pero flexibles |
-| Desactualización futura | Medio | Medio | Versionado en frontmatter |
-
----
-
-## 8. Preguntas abiertas
-
-*Ninguna — Los acceptance criteria están claros tras Phase 0.*
-
----
-
-## 9. Aprobación
-
-Este análisis **requiere aprobación explícita del desarrollador**.
-
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: "2026-01-07T07:35:17+01:00"
-    comments: "Aprobado para avanzar a Phase 3"
-```
-
-> Sin aprobación, esta fase **NO puede darse por completada** ni avanzar a Phase 3.

package/dist/artifacts/4-adr-workflows-modulos/plan.md

@@ -1,301 +0,0 @@
----
-artifact: plan
-phase: phase-3-planning
-owner: architect-agent
-status: draft
-related_task: 4-adr-workflows-modulos
----
-
-# Implementation Plan — 4-adr-workflows-modulos
-
-## 1. Resumen del plan
-
-### Contexto
-El framework Extensio necesita un sistema de workflows para módulos equivalente al existente para drivers. Se ha completado la investigación técnica y el análisis arquitectónico.
-
-### Resultado esperado
-Al finalizar, existirá un **ADR completo** con especificación técnica de:
-- 4 workflows (index + create + refactor + delete)
-- 3 templates (create, refactor, delete)
-- 1 constitution (modules.md)
-- 1 rol (module.md / module-agent)
-- Actualización de 4 índices
-
-### Alcance
-**Incluye**:
-- Creación de todos los documentos especificados
-- Actualización de índices para registrar los nuevos componentes
-- Especificación técnica detallada
-
-**Excluye**:
-- Implementación de código
-- Tests automatizados (el entregable es documentación)
-- Demo (no aplica)
-
----
-
-## 2. Inputs contractuales
-
-- **Task**: `.agent/artifacts/4-adr-workflows-modulos/task.md`
-- **Analysis**: `.agent/artifacts/4-adr-workflows-modulos/analysis.md`
-- **Research**: `.agent/artifacts/4-adr-workflows-modulos/researcher/research.md`
-- **Acceptance Criteria**: AC-1 a AC-7 (definidos en task.md)
-
-### Dispatch de dominios
-
-```yaml
-plan:
-  workflows:
-    drivers:
-      action: none
-    modules:
-      action: none  # No se ejecuta workflow de módulos, se CREA el workflow
-
-  dispatch:
-    - domain: documentation
-      action: create
-      workflow: manual  # Creación directa de documentos
-```
-
-> **Nota**: Esta tarea crea la infraestructura documental para módulos. No hay dispatch a workflows existentes porque estamos creando los propios workflows.
-
----
-
-## 3. Desglose de implementación (pasos)
-
-### Paso 1: Crear constitution de módulos
-- **Descripción**: Crear `modules.md` con reglas contractuales para módulos
-- **Dependencias**: Ninguna
-- **Entregables**: `.agent/rules/constitution/modules.md`
-- **Agente responsable**: architect-agent
-- **Estimación**: Media
-
-### Paso 2: Crear rol module-agent
-- **Descripción**: Crear `module.md` con definición del rol
-- **Dependencias**: Paso 1 (para referenciar constitution)
-- **Entregables**: `.agent/rules/roles/module.md`
-- **Agente responsable**: architect-agent
-- **Estimación**: Media
-
-### Paso 3: Crear workflows de módulos
-- **Descripción**: Crear los 4 archivos de workflows
-- **Dependencias**: Paso 1 y 2
-- **Entregables**:
-  - `.agent/workflows/modules/index.md`
-  - `.agent/workflows/modules/create.md`
-  - `.agent/workflows/modules/refactor.md`
-  - `.agent/workflows/modules/delete.md`
-- **Agente responsable**: architect-agent
-- **Estimación**: Alta
-
-### Paso 4: Crear templates de módulos
-- **Descripción**: Crear los 3 templates de informes
-- **Dependencias**: Paso 3 (para alinear con workflows)
-- **Entregables**:
-  - `.agent/templates/module-create.md`
-  - `.agent/templates/module-refactor.md`
-  - `.agent/templates/module-delete.md`
-- **Agente responsable**: architect-agent
-- **Estimación**: Media
-
-### Paso 5: Actualizar índices
-- **Descripción**: Registrar nuevos componentes en los índices existentes
-- **Dependencias**: Pasos 1-4
-- **Entregables**:
-  - `.agent/workflows/index.md` (añadir modules)
-  - `.agent/templates/index.md` (añadir module-*)
-  - `.agent/rules/constitution/index.md` (añadir modules)
-  - `.agent/rules/roles/index.md` (añadir module)
-- **Agente responsable**: architect-agent
-- **Estimación**: Baja
-
-### Paso 6: Crear ADR consolidado
-- **Descripción**: Documento ADR final que referencia todos los componentes
-- **Dependencias**: Pasos 1-5
-- **Entregables**: `.agent/artifacts/4-adr-workflows-modulos/adr.md`
-- **Agente responsable**: architect-agent
-- **Estimación**: Media
-
----
-
-## 4. Asignación de responsabilidades (Agentes)
-
-### architect-agent
-**Responsabilidades**:
-- Crear todos los documentos (constitution, rol, workflows, templates)
-- Actualizar índices
-- Crear ADR consolidado
-- Solicitar aprobación del desarrollador
-
-**Subáreas**:
-- Constitution de módulos
-- Rol module-agent
-- Workflows de módulos
-- Templates de módulos
-- ADR final
-
-### module-agent
-**Responsabilidades**:
-- No participa en esta tarea (el agente se define, no se usa)
-
-### qa-agent
-**Responsabilidades**:
-- No aplica (el entregable es documentación)
-
-### Handoffs
-```
-architect-agent → desarrollador (aprobación final del ADR)
-```
-
-### Componentes
-
-| Componente | Ejecutor | Cómo | Herramienta |
-|------------|----------|------|-------------|
-| Constitution | architect-agent | Creación manual de .md | Editor (write_to_file) |
-| Rol | architect-agent | Creación manual de .md | Editor (write_to_file) |
-| Workflows | architect-agent | Creación manual de .md | Editor (write_to_file) |
-| Templates | architect-agent | Creación manual de .md | Editor (write_to_file) |
-
-> **Justificación de herramienta**: No hay tool MCP para crear workflows/templates/constitutions. La creación es manual siguiendo los modelos existentes de drivers.
-
-### Demo
-**No aplica** — El entregable es un ADR (documentación).
-
----
-
-## 5. Estrategia de testing y validación
-
-### Unit tests
-**No aplica** — El entregable es documentación.
-
-### Integration tests
-**No aplica** — El entregable es documentación.
-
-### E2E / Manual
-- **Validación de estructura**: Verificar que cada documento sigue el formato del modelo de drivers
-- **Validación de consistencia**: Verificar referencias cruzadas entre documentos
-- **Validación de completitud**: Verificar que todos los AC están cubiertos
-
-### Trazabilidad
-
-| AC | Verificación |
-|----|--------------|
-| AC-1 (Especificación técnica) | ADR contiene todos los componentes |
-| AC-2 (Rol module-agent) | Existe `module.md` con estructura correcta |
-| AC-3 (Workflows) | Existen los 4 workflows con gates |
-| AC-4 (Templates) | Existen los 3 templates |
-| AC-5 (Constitution) | Existe `modules.md` con reglas auditables |
-| AC-6 (MCP) | ADR documenta herramientas existentes |
-| AC-7 (Aprobación) | Desarrollador aprueba el ADR |
-
----
-
-## 6. Plan de demo
-
-**No aplica** — El entregable es un ADR (documentación).
-
----
-
-## 7. Estimaciones y pesos de implementación
-
-| Paso | Componente | Esfuerzo | Archivos |
-|------|------------|----------|----------|
-| 1 | Constitution | Medio | 1 |
-| 2 | Rol | Medio | 1 |
-| 3 | Workflows | Alto | 4 |
-| 4 | Templates | Medio | 3 |
-| 5 | Índices | Bajo | 4 |
-| 6 | ADR | Medio | 1 |
-| **Total** | | | **14 archivos** |
-
-### Timeline aproximado
-- Fase de implementación: 1 sesión
-- Total estimado: ~2000 líneas de documentación
-
-### Suposiciones
-- Los modelos de drivers están disponibles y son correctos
-- No hay cambios en la arquitectura base durante la implementación
-
----
-
-## 8. Puntos críticos y resolución
-
-### Punto crítico 1: Duplicación con extensio-architecture.md
-- **Riesgo**: La constitution de módulos podría duplicar contenido de extensio-architecture.md
-- **Impacto**: Medio — Desactualización futura
-- **Estrategia de resolución**: 
-  - La constitution REFERENCIA extensio-architecture.md como source of truth
-  - Solo añade reglas operativas específicas de módulos
-  - Usar notas explícitas: "Ver extensio-architecture.md, sección X"
-
-### Punto crítico 2: Diferenciación de scopes
-- **Riesgo**: Los workflows podrían no capturar la complejidad de scopes (Engine, Context, Surface)
-- **Impacto**: Medio — Auditorías incompletas
-- **Estrategia de resolución**:
-  - Templates incluyen secciones específicas por scope
-  - Constitution define reglas por scope
-  - Workflows validan scopes en gates
-
-### Punto crítico 3: Consistencia con modelo de drivers
-- **Riesgo**: Desviación estructural respecto al modelo de drivers
-- **Impacto**: Bajo — Confusión operativa
-- **Estrategia de resolución**:
-  - Usar drivers como modelo literal
-  - Verificar paralelismo estructural al final
-
----
-
-## 9. Dependencias y compatibilidad
-
-### Dependencias internas
-- `extensio-architecture.md` — Source of truth
-- `drivers.md` — Modelo estructural
-- `driver.md` (rol) — Modelo de rol
-
-### Dependencias externas
-- Ninguna
-
-### Compatibilidad entre navegadores
-- No aplica (el entregable es documentación)
-
-### Restricciones arquitectónicas
-- Todos los documentos DEBEN seguir el formato YAML frontmatter de Extensio
-- Los workflows DEBEN tener Input, Output, Objetivo, Template, Pasos, FAIL, Gate
-
----
-
-## 10. Criterios de finalización
-
-### Checklist final
-
-- [ ] Constitution `modules.md` creada y cumple formato
-- [ ] Rol `module.md` creado y cumple formato
-- [ ] Workflow `modules/index.md` creado
-- [ ] Workflow `modules/create.md` creado con gates
-- [ ] Workflow `modules/refactor.md` creado con gates
-- [ ] Workflow `modules/delete.md` creado con gates
-- [ ] Template `module-create.md` creado
-- [ ] Template `module-refactor.md` creado
-- [ ] Template `module-delete.md` creado
-- [ ] Índice `workflows/index.md` actualizado
-- [ ] Índice `templates/index.md` actualizado
-- [ ] Índice `rules/constitution/index.md` actualizado
-- [ ] Índice `rules/roles/index.md` actualizado
-- [ ] ADR consolidado creado
-- [ ] Desarrollador ha aprobado el ADR (SI)
-
----
-
-## 11. Aprobación del desarrollador (OBLIGATORIA)
-
-Este plan **requiere aprobación explícita y binaria**.
-
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: "2026-01-07T07:37:29+01:00"
-    comments: "Aprobado para iniciar implementación"
-```
-
-> Sin aprobación, esta fase **NO puede darse por completada** ni avanzar a Phase 4.