@christianmaf80/agentic-workflow 1.24.0-beta.3 → 1.25.0-beta.3

package/dist/agent/artifacts/8-create-agentic-runtime-cli-first-as-the-single-execution-engine/task.md

@@ -0,0 +1,126 @@
+---
+id: 8
+title: create-agentic-runtime-cli-first-as-the-single-execution-engine
+owner: architect-agent
+strategy: long
+---
+
+# Task (Template)
+
+## Identificación
+- id: 8
+- title: create-agentic-runtime-cli-first-as-the-single-execution-engine
+- scope: candidate | current
+- owner: architect-agent
+
+## Origen
+- created_from:
+  - workflow: tasklifecycle
+  - source: init / tasklifecycle
+  - candidate_path: artifacts.candidate.task
+
+## Descripción de la tarea
+Construir un runtime headless CLI-first que ejecute workflows existentes, resuelva contexto y ciclo de vida de tareas, ejecute pasos reales, persista estado fuera de memoria y emita eventos/logs para una UI futura.
+
+## Objetivo
+Implementar un runtime CLI-first, sin UI, gobernado por MCP, que ejecute workflows existentes, gestione el ciclo de vida con persistencia externa, asigne tareas por owner de agente y permita chat (Codex/antigravity) vía MCP; excluyendo la extensión de distribución.
+
+## Estado del ciclo de vida (FUENTE ÚNICA DE VERDAD)
+
+```yaml
+task:
+  id: "8"
+  title: "create-agentic-runtime-cli-first-as-the-single-execution-engine"
+  strategy: "long"  # long | short
+  artifacts:
+    supplemental: []
+  phase:
+    current: "phase-8-commit-push"
+    validated_by: "architect-agent"
+    updated_at: "2026-02-02T16:55:00+01:00"
+  lifecycle:
+    phases:
+      phase-0-acceptance-criteria:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-02T08:27:11Z"
+      phase-1-research:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-02T08:38:45Z"
+      phase-2-analysis:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-02T08:44:15Z"
+      phase-3-planning:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-02T08:55:35Z"
+      phase-4-implementation:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-02T13:58:38Z"
+      phase-5-verification:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-02T14:03:09Z"
+      phase-6-results-acceptance:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-02T14:08:50Z"
+      phase-7-evaluation:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-02T14:11:44Z"
+      phase-8-commit-push:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-02T16:55:00+01:00"
+    subflows:
+      components:
+        create:
+          - name: <component-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+        refactor:
+          - name: <component-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+        delete:
+          - name: <component-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+      short-phase-1-brief:
+        completed: false
+        validated_by: null
+        validated_at: null
+      short-phase-2-implementation:
+        completed: false
+        validated_by: null
+        validated_at: null
+      short-phase-3-closure:
+        completed: false
+        validated_by: null
+        validated_at: null
+```
+
+---
+
+## 2. Definición y Alcance (Contrato)
+- **Acceptance Criteria**: [acceptance.md](file:///.agent/artifacts/8-create-agentic-runtime-cli-first-as-the-single-execution-engine/acceptance.md)
+- **Alias**: `task.acceptance`
+
+---
+
+## 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/agent/artifacts/candidate/acceptance.md

@@ -0,0 +1,23 @@
+# Acceptance Criteria: Beta Release of Agentic System Structure
+
+> **Task**: Beta Release of Agentic System Structure
+> **Strategy**: Short
+
+## 1. Scope & Deliverables
+- [ ] **README.md Updated**: Must reflect the latest capabilities and structure of `src/agentic-system-structure`.
+- [ ] **Clean Distribution**: The published package MUST NOT include the VSCode extension code, only CLI and Agnostic Agent System Structure.
+- [ ] **Core Structure**: The published package MUST include various core files (`dist/agent`) derived from `src/agentic-system-structure`.
+- [ ] **CLI Functionality**: The `agentic-workflow` CLI must function independently of VSCode.
+
+## 2. Release & Versioning
+- [ ] **Version Bump**: Update `package.json` to the next beta version (e.g., `1.22.0-beta.8`).
+- [ ] **Branching**: Create a release branch named `ci/publish/v<version>`.
+- [ ] **Automation**: rely on existing GitHub Action `publish.yml` for the actual npm publish.
+
+## 3. Verification (Pre-Release)
+- **Local Install Test**:
+    1. Build the project locally.
+    2. Create a clean, temporary directory.
+    3. Execute `init` using the local CLI build.
+    4. **Pass Condition**: The `.agent` directory is created, populated, and `init.md` can be generated without errors.
+    5. **Pass Condition**: No references to VSCode APIs cause runtime errors.

package/dist/agent/artifacts/candidate/brief.md

@@ -0,0 +1,39 @@
+# Brief: Beta Release of Agentic System Structure
+
+> **Task**: Beta Release of Agentic System Structure
+> **Strategy**: Short
+
+## 1. Analysis (Current State)
+- **Repo**: `agentic-workflow`
+- **Current Version**: `1.22.0-beta.7`
+- **Structure**: `src/agentic-system-structure` contains the source of truth for the agentic system.
+- **Publishing**: Automated via `publish.yml` on `ci/publish` branch merge.
+- **Exclusion**: `package.json` correctly excludes `dist/extension` but includes `dist/agent` (copied from `src/agentic-system-structure`).
+
+## 2. Implementation Plan
+### Step 1: Verification (Pre-Flight)
+- Build the project locally (`npm run build`).
+- Validate that `dist/extension` is excluded effectively or ignored by the `files` directive.
+- Run a local `init` test in a clean directory to ensure the CLI works without the VSCode environment.
+
+### Step 2: Documentation
+- Update `README.md` to reflect the latest state of the structure (e.g., number of available workflows, rules, etc.).
+
+### Step 3: Versioning & Release
+- Bump version to `1.22.0-beta.8` (or next available).
+- Create branch `ci/publish/v1.22.0-beta.8`.
+- Commit changes (README + package.json).
+
+### Step 4: Publish
+- Push branch to origin.
+- (User action required to merge PR if branch protection exists, or push directly if allowed).
+
+## 3. Complexity Evaluation
+- **Level**: LOW
+- **Risk**: Low (Beta release, limited scope).
+- **Breaking Changes**: None expected in the CLI logic itself.
+
+## 4. Agent Evaluation
+- **Architect**: Plan defined.
+- **Verification**: Essential to prove CLI independence from VSCode.
+- **DevOps**: Standard release process.

package/dist/agent/artifacts/candidate/init.md

@@ -1,12 +1,6 @@
----
-kind: artifact
-name: init
-source: agentic-system-structure
----
-
 # init bootstrap
 
-- command: init
+- command: /init
 - role.architect: architect-agent
 - constitution.loaded.in_context: true
 
@@ -24,7 +18,7 @@ constitution:
     - .agent/rules/constitution/clean-code.md
     - .agent/rules/constitution/agents-behavior.md
 language:
-  value: Español
+  value: Spanish
   confirmed: true
-strategy: short
+strategy: long
 ```

package/dist/agent/artifacts/candidate/task.md

@@ -1,72 +1,5 @@
----
-kind: artifact
-name: task
-source: agentic-system-structure
----
+# Task Candidate
 
-# Task: Reorganización de estructura de archivos y backups
-
-## Identificación
-- id: task-20260128-reorganize-structure
-- title: Reorganización de estructura
-- scope: candidate
-- owner: architect-agent
-
-## Origen
-- created_from:
-  - workflow: tasklifecycle-short
-  - source: init
-  - candidate_path: artifacts.candidate.task
-
-## Descripción de la tarea
-Reorganizar la carpeta `src` trasladando el sistema de markdowns a una nueva carpeta `agentic-system-structure` y mover las carpetas de backups a una carpeta unificada `.backups`.
-
-## Objetivo
-Mejorar la organización del repositorio siguiendo una estructura más clara y centralizada para los archivos del sistema y los respaldos.
-
-## Estado del ciclo de vida (FUENTE ÚNICA DE VERDAD)
-
-```yaml
-task:
-  id: "task-20260128-reorganize-structure"
-  title: "Reorganización de estructura"
-  strategy: "short"
-  artifacts:
-    supplemental: []
-  phase:
-    current: "short-phase-2-implementation"
-    validated_by: "architect-agent"
-    updated_at: "2026-01-28T08:21:00+01:00"
-  lifecycle:
-    phases:
-      short-phase-1-brief:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-28T08:21:00+01:00"
-      short-phase-2-implementation:
-        completed: false
-        validated_by: null
-        validated_at: null
-      short-phase-3-closure:
-        completed: false
-        validated_by: null
-        validated_at: null
-```
-
----
-
-## 2. Definición y Alcance (Contrato)
-- **Acceptance Criteria**: [.agent/artifacts/task-20260128-reorganize-structure/acceptance.md](file:///.agent/artifacts/task-20260128-reorganize-structure/acceptance.md)
-- **Alias**: `task.acceptance`
-
----
-
-## 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
+- title: Re-implement Setup/Config (D1)
+- description: Re-implement the Setup and Configuration domain (D1) to align with the new modular architecture. This includes implementing a real `SettingsStorage` in the Core Background layer and recreating the Configuration UI using Lit components, ensuring strict separation of concerns and proper state management.
+- goal: Implement persistent SettingsStorage and a new Lit-based Configuration UI.

package/dist/agent/artifacts/task-20260128-reorganize-structure/acceptance.md

@@ -1,9 +1,3 @@
----
-kind: artifact
-name: acceptance
-source: agentic-system-structure
----
-
 # Acceptance Criteria — task-20260128-reorganize-structure
 
 ## Identificacion del agente (OBLIGATORIA)

package/dist/agent/artifacts/task-20260128-reorganize-structure/brief.md

@@ -38,7 +38,7 @@ Derivados de las respuestas anteriores:
 1. **Alcance**: Reubicación de carpetas `rules`, `workflows`, `templates`, `artifacts` e `index.md` de `src/` a `.agent/`. Consolidación de `.agent.backup_*` en `/.backups/`.
 2. **Entradas/Datos**: Ficheros actuales en `src/` y carpetas de backup en raíz.
 3. **Salidas esperadas**: Nueva estructura de directorios funcional y coherente, con scripts y referencias actualizadas.
-4. **Restricciones**: No modificar el código lógico en `src/cli`, `src/infrastructure`, `src/test` ni `src/extension.ts`.
+4. **Restricciones**: No modificar el código lógico en `src/cli`, `src/core`, `src/test` ni `src/extension.ts`.
 5. **Criterio de Done**: Estructura movida, `.backups` consolidado, `init` funcional y build exitosa sin errores de paths.
 
 ---

package/dist/agent/artifacts/task-20260128-reorganize-structure/closure.md

@@ -21,13 +21,13 @@ Se han cumplido todos los objetivos establecidos en el Brief:
 - **Estrategia**: Short (3 fases).
 - **Ficheros modificados**:
   - `package.json`
-  - `src/infrastructure/utils/backup.ts`
-  - `src/infrastructure/migration/backup.ts`
+  - `src/core/utils/backup.ts`
+  - `src/core/migration/backup.ts`
   - `src/cli/commands/init.ts`
   - Toda la documentación agéntica (.md).
 
 ## 3. Resultado Final
-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/`.
+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/`.
 
 ## 4. Confirmación de Cierre
 La tarea se considera **finalizada con éxito**.

package/dist/agent/artifacts/task-20260128-reorganize-structure/implementation.md

@@ -26,7 +26,7 @@ Se ha realizado una reorganización profunda del sistema para mejorar la manteni
 ### Actualización de Código y Scripts
 - **package.json**: Se ha actualizado el script `copy-assets` para que la build (`dist/`) se genere correctamente desde la nueva ubicación.
 - **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.
-- **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/`.
+- **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/`.
 
 ## 2. Verificación Técnica
 
@@ -41,7 +41,7 @@ Se ha realizado una reorganización profunda del sistema para mejorar la manteni
 | Carpetas movidas a `.agent/` | ☑ Cumplido | Verificado mediante `ls`. |
 | Backups movidos a `/.backups/` | ☑ Cumplido | Verificado mediante `ls`. |
 | Scripts de build actualizados | ☑ Cumplido | `npm run build` ejecutado con éxito. |
-| Lógica de backup en código actualizada | ☑ Cumplido | Código en `src/infrastructure` modificado. |
+| Lógica de backup en código actualizada | ☑ Cumplido | Código en `src/core` modificado. |
 | Sistema inicializable tras cambio | ☑ Cumplido | Lógica de `init` preparada. |
 
 ## 4. Notas Adicionales

package/dist/agent/artifacts/task-20260128-reorganize-structure/task.md

@@ -1,9 +1,3 @@
----
-kind: artifact
-name: task
-source: agentic-system-structure
----
-
 # Task: Reorganización de estructura de archivos y backups
 
 ## Identificación

package/dist/agent/artifacts/task-20260130-chatkit-mainview/acceptance.md

@@ -0,0 +1,65 @@
+# Acceptance Criteria — task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+
+🏛️ **architect-agent**: Criterios de aceptación para integrar ChatKit (advanced) con agente dinámico en `mainView`.
+
+## 1. Definición Consolidada
+Integrar ChatKit en `mainView` usando la integración avanzada (backend local en extension host), crear un agente dinámico “Neo” con modelo `gpt-5` por sesión, y exponer un botón “Test” que envíe “Hello I am the first agent called Neo”. La API key se guarda en SecretStorage y el webview consume el servidor ChatKit vía `apiURL`.
+
+## 2. Respuestas a Preguntas de Clarificación
+> Esta sección documenta las respuestas del desarrollador a las 5 preguntas formuladas por el architect-agent.
+
+| # | Pregunta (formulada por architect) | Respuesta (del desarrollador) |
+|---|-----------------------------------|-------------------------------|
+| 1 | ¿Modelo exacto a usar? | `gpt-5`. |
+| 2 | ¿Dónde corre el servidor ChatKit? | Local en la extensión (extension host). |
+| 3 | ¿Creación y cacheo del `agent_id`? | Crear en cada sesión (no persistir). |
+| 4 | ¿Roles iniciales? | Solo Neo; se le inyecta rol y constitutions desde `.agent`. |
+| 5 | ¿UI mínima? | ChatKit embebido + botón “Test” que dispara el mensaje “Hello I am the first agent called Neo” (auto‑send). |
+
+---
+
+## 3. Criterios de Aceptación Verificables
+> Listado de criterios derivados de las respuestas anteriores que deben ser verificados en la Fase 5.
+
+1. Alcance:
+   - ChatKit se renderiza en `mainView` y usa `apiURL` hacia el servidor local.
+
+2. Entradas / Datos:
+   - API key almacenada en SecretStorage.
+   - Modelo `gpt-5` usado en la creación del agente Neo.
+
+3. Salidas / Resultado esperado:
+   - Botón “Test” envía “Hello I am the first agent called Neo”.
+   - Se muestra la respuesta del agente en el chat.
+
+4. Restricciones:
+   - No exponer API key en el webview.
+   - Mantener un único `mainView` en Activity Bar.
+
+5. Criterio de aceptación (Done):
+   - El flujo completo funciona en F5: se carga ChatKit, crea agente por sesión, y el botón “Test” produce respuesta real.
+
+---
+
+## Aprobación (Gate 0)
+Este documento constituye el contrato de la tarea. Su aprobación es bloqueante para pasar a Phase 1.
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-30T00:00:00Z
+    comments: null
+```
+
+---
+
+## Historial de validaciones (Phase 0)
+```yaml
+history:
+  - phase: "phase-0-acceptance-criteria"
+    action: "completed"
+    validated_by: "architect-agent"
+    timestamp: "2026-01-30T00:00:00Z"
+    notes: "Acceptance criteria definidos"
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-scores.md

@@ -0,0 +1,26 @@
+---
+artifact: agent_scores
+owner: architect-agent
+status: ongoing
+---
+
+# Agent Scores
+
+## 1. Resumen por agente
+- **vscode-specialist**
+  - score: 9 (dev: 6)
+  - notas: Implementación y fixes complejos completados.
+- **qa-agent**
+  - score: 8 (dev: 7)
+  - notas: Tests y coverage completos.
+- **neo-agent**
+  - score: 7 (dev: 5)
+  - notas: Aporte inicial de dependencias.
+- **architect-agent**
+  - score: 8 (dev: 5)
+  - notas: Coordinación de fases y constitución.
+
+---
+
+## 2. Meta
+- Ultima actualizacion: 2026-02-01T11:35:00Z

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/1-neo-agent-deps-chatkit.md

@@ -0,0 +1,108 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: neo-agent
+status: completed
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 1
+---
+
+🤖 **neo-agent**: Preparar dependencias y configuración base para ChatKit.
+
+# Agent Task — 1-neo-agent-deps-chatkit
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Añadir dependencias oficiales necesarias para ChatKit/SDK y wiring básico sin exponer la API key.
+- **Alcance**: `package.json`, ajustes de build si aplican; sin tocar lógica de servidor ni UI aún.
+- **Dependencias**: Plan aprobado; reglas de `constitution.vscode_extensions`; documentación oficial OpenAI.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+> [!IMPORTANT]
+> El agente **DEBE** completar esta sección ANTES de ejecutar.
+> Documentar el razonamiento mejora la calidad y permite detectar errores temprano.
+
+### Análisis del objetivo
+- Añadir dependencias oficiales necesarias para ChatKit (backend) y dejar lista la base para el servidor local.
+- Decidir si la UI se carga por CDN o dependencia local.
+
+### Opciones consideradas
+- **Opción A**: Instalar `openai` SDK y usar ChatKit JS vía CDN.
+- **Opción B**: Instalar también un paquete de ChatKit UI (si existe) para servir localmente.
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: El SDK oficial `openai` es necesario para crear sesiones ChatKit en el backend; la UI puede cargarse por CDN sin empaquetado adicional.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - `package.json` actualizado (si aplica)
+  - Build `npm run compile` sin errores
+- **Evidencia requerida**:
+  - Lista de dependencias añadidas/evitadas
+  - Notas de compatibilidad
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "neo-agent"
+  status: completed
+  started_at: 2026-01-30T00:00:00Z
+  completed_at: 2026-01-30T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+> Esta sección la completa el agente asignado durante la ejecución.
+
+### Cambios realizados
+- Añadida dependencia `openai@6.17.0` para crear sesiones ChatKit desde el extension host.
+- Actualizado `package.json` y `package-lock.json`.
+
+### Decisiones técnicas
+- UI ChatKit se cargará por CDN para evitar empaquetado adicional en la extensión.
+- El backend usará el SDK oficial `openai` para las llamadas a ChatKit.
+
+### Evidencia
+- `npm install openai@6.17.0` ejecutado sin errores.
+
+### Desviaciones del objetivo
+- La tarea estaba asignada a vscode-specialist según el plan, pero fue ejecutada por neo-agent. Se requiere revisión/validación del especialista.
+
+---
+
+## Gate (REQUIRED)
+
+El desarrollador **DEBE** aprobar esta tarea antes de que el arquitecto asigne la siguiente.
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-30T00:00:00Z
+    comments: "Aprobado con revisión del vscode-specialist."
+```
+
+---
+
+## Reglas contractuales
+
+1. Esta tarea **NO puede marcarse como completada** sin Gate PASS (`decision: SI`).
+2. Si Gate FAIL (`decision: NO`):
+   - El arquitecto define acciones correctivas.
+   - Se genera una nueva tarea de corrección si procede.
+3. El agente asignado **NO puede modificar** el Input ni el Output definidos por el arquitecto.
+4. El Gate es **síncrono y bloqueante**: el flujo se detiene hasta obtener respuesta del desarrollador.

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/15-vscode-specialist-views-router.md

@@ -0,0 +1,89 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: vscode-specialist
+status: in-progress
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 15
+---
+
+🧩 **vscode-specialist**: Implementar router de vistas y nuevas views (chat, history, workflow, key).
+
+# Agent Task — 15-vscode-specialist-views-router
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Crear arquitectura de router para vistas y estructurar cada view en su carpeta con `index.ts` y `types.d.ts`. Registrar múltiples views en un único View Container.
+- **Alcance**: `src/extension/views/**`, `src/extension/extension.ts`, `package.json` (contributes/activationEvents).
+- **Dependencias**: ChatKit view existente.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- Se requiere soporte para múltiples views visibles simultáneamente y escalable a futuro.
+
+### Opciones consideradas
+- **Opción A**: Router central con registry y factories.
+- **Opción B**: Registro manual por view sin router.
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: escalabilidad y consistencia.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Router/registry de views.
+  - Carpetas por view con `index.ts` y `types.d.ts`.
+  - Views visibles simultáneamente en el panel.
+- **Evidencia requerida**:
+  - `npm run compile` OK.
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "vscode-specialist"
+  status: completed
+  started_at: 2026-01-31T00:00:00Z
+  completed_at: 2026-01-31T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+### Cambios realizados
+- Router de views en `src/extension/views/router` y tipos compartidos en `src/extension/views/types.ts`.
+- Nuevas vistas: `chat`, `history`, `workflow`, `key` con carpetas e `index.ts`.
+- `ApiKeyBroadcaster` para sincronizar estado de API key entre views.
+- Actualizado `src/extension/extension.ts` para registrar el registry.
+- Actualizado `package.json` con nuevos view ids y activation events.
+
+### Decisiones técnicas
+- Todas las views son `webview` por ahora; TreeView queda como TODO futuro.
+
+### Evidencia
+- `npm run compile` OK.
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-31T00:00:00Z
+    comments: "Aprobado."
+```