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

package/dist/artifacts/29-agentic-framework-core-reference-refactor/agent-tasks/6-architect-neo-agent-birth.md

@@ -1,85 +0,0 @@
----
-artifact: agent_task
-phase: phase-4-implementation
-owner: architect-agent
-status: pending
-related_task: 29-Agentic Framework Core Reference Refactor
-task_number: 6
----
-
-# Agent Task — 6-architect-neo-agent-birth
-
-## Identificacion del agente (OBLIGATORIA)
-🏛️ **architect-agent**: Ejecutando el nacimiento del primer agente local **neo-agent** usando la nueva infraestructura.
-
-## Input (REQUIRED)
-- **Objetivo**: Crear el primer rol de tipo `developer` llamado **neo-agent** en el repositorio del usuario.
-- **Alcance**:
-  - Utilizar el comando `agentic-workflow create role neo`.
-  - Personalizar el rol para que sea un especialista en desarrollo de software con enfoque en el framework.
-  - El archivo debe residir físicamente en `.agent/rules/roles/neo.md`.
-- **Dependencias**: Agent Task #3 (Scaffolding System).
-
----
-
-## Reasoning (OBLIGATORIO)
-
-### Análisis del objetivo
-Validar el sistema de extensión local creando un compañero desarrollador que viva en el repo del usuario, demostrando la coexistencia con el core en node_modules.
-
-### Opciones consideradas
-Crear el archivo manualmente vs Usar el comando CLI refactorizado. Usaré el comando CLI para validar el flujo "end-to-end".
-
-### Decisión tomada
-Ejecutar el comando de creación y luego refinar el contenido del rol `neo-agent` para darle una personalidad técnica de alto nivel.
-
----
-
-## Output (REQUIRED)
-- **Entregables**:
-  - `.agent/rules/roles/neo.md`
-- **Evidencia requerida**:
-  - El archivo debe existir en la carpeta local y ser coherente con el estilo de roles del framework.
-
----
-
-## Execution
-
-```yaml
-execution:
-  agent: "architect-agent"
-  status: completed
-  started_at: "2026-01-20T08:15:00+01:00"
-  completed_at: "2026-01-20T08:18:00+01:00"
-```
-
----
-
-## Implementation Report
-
-### Cambios realizados
-- Ejecutado el comando `agentic-workflow create role neo` tras realizar un build previo del paquete.
-- Personalizado el contenido de `.agent/rules/roles/neo.md` con una identidad de "Productive Developer".
-
-### Decisiones técnicas
-- El uso del comando `create` validó que el sistema de scaffolding detecta correctamente la falta de roles colisionantes y crea la estructura local operativa.
-
-### Evidencia
-Archivo `.agent/rules/roles/neo.md` generado y configurado con éxito.
-
----
-
-## Gate (REQUIRED)
-
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: "2026-01-20T08:18:00+01:00"
-    comments: "Bienvenido neo-agent. La infraestructura de extensión local funciona perfectamente."
-```
-
----
-
-## Reglas contractuales
-1. Esta tarea **NO puede marcarse como completada** sin Gate PASS (`decision: SI`).

package/dist/artifacts/29-agentic-framework-core-reference-refactor/analysis.md

@@ -1,119 +0,0 @@
-🏛️ **architect-agent**: He finalizado el análisis estructural para el modelo de referencia absoluta.
-
----
-artifact: analysis
-phase: phase-2-analysis
-owner: architect-agent
-status: draft
-related_task: 29-Agentic Framework Core Reference Refactor
----
-
-# Analysis — 29-Agentic Framework Core Reference Refactor
-
-## Identificacion del agente (OBLIGATORIA)
-🏛️ **architect-agent**: Análisis de arquitectura para la migración al modelo de Core Protegido por Referencia.
-
-## 1. Resumen ejecutivo
-**Problema**
-- El sistema actual copia físicamente el core agéntico a cada repositorio de usuario. Esto genera redundancia y dificulta las actualizaciones.
-**Objetivo**
-- Refactorizar `@cmarino/agentic-workflow` para que el CLI `init` genere un ecosistema donde el core reside en `node_modules` y el usuario extiende el sistema manteniendo la **misma estructura espejo** en `.agent/` (ej: `.agent/roles/`, `.agent/workflows/`) para sus archivos propios.
-
-**Criterio de éxito**
-- Una instalación limpia debe tener un `index.md` local que apunte a las rutas absolutas del core y que se fusione con la estructura espejo local en `.agent/` para permitir extensiones del usuario.
-
----
-
-## 2. Estado del proyecto (As-Is)
-**Estructura relevante**
-- `agentic-workflow/src/cli/commands/init.ts`: Actualmente copia ficheros core a `.agent/`.
-- `agentic-workflow/src/core/migration/`: Contiene la lógica recientemente implementada que debe adaptarse al nuevo modelo.
-
-**Drivers existentes**
-- No aplica (Core agéntico).
-
-**Artifacts / tareas previas**
-- Tarea #28: Implementó el Wizard de migración que ahora vamos a "desviar" hacia una arquitectura de referencia.
-
-**Limitaciones detectadas**
-- Los agentes de IDE suelen tener configuraciones que excluyen `node_modules` de la búsqueda global, lo que obliga a usar enlaces explícitos en Markdown.
-
----
-
-## 3. Cobertura de Acceptance Criteria
-
-### AC-1: Zero Copy Core
-- **Interpretación**: El CLI no debe copiar `/rules`, `/workflows` o `/templates` base.
-- **Verificación**: Inspección de la carpeta `.agent/` tras `init`. Solo debe contener `index.md`, `artifacts/`, `metrics/` y el nuevo `custom/`.
-
-### AC-2: Reference Mapping
-- **Interpretación**: Los alias globales deben resolverse mediante rutas absolutas físicas.
-- **Verificación**: Ejecución de un workflow que use un alias de constitución del core.
-
-### AC-3: Reserved Namespace
-- **Interpretación**: El CLI debe proteger nombres como "Architect" o "tasklifecycle".
-- **Verificación**: Tests unitarios del comando de creación de roles/workflows.
-
-### AC-4: Local Extensibility (Mirror Structure)
-- **Interpretación**: El sistema debe fusionar dinámicamente el core (en node_modules) con lo que exista localmente en la carpeta espejo correspondiente (ej: `.agent/roles/mi-rol.md`).
-- **Verificación**: Un rol creado localmente en la ruta espejo debe ser indexado sin problemas.
-
-### AC-5: IDE Discovery
-- **Interpretación**: `AGENTS.md` debe ser el mapa de navegación.
-
----
-
-## 4. Research técnico
-Basado en el informe del `researcher-agent` (aprobado).
-
-- **Estrategia Recomendada: Absolute Path Mirror Injections**
-  - El CLI inyecta los paths absolutos del core en el `index.md`.
-  - El sistema de detección de extensiones busca archivos locales que sigan la misma jerarquía de carpetas que el core, permitiendo al desarrollador añadir roles, workflows o reglas simplemente creando archivos en las subcarpetas de `.agent/`.
-
----
-
-## 5. Agentes participantes
-- **architect-agent**
-  - Responsabilidades: Definir el "Reserved Namespace" y el nuevo esquema de `index.md`.
-- **tooling-agent**
-  - Responsabilidades: Refactor del CLI y creación de comandos `create-role`, `create-workflow`.
-
-**Componentes necesarios**
-- **Refactor**: `agentic-workflow/src/cli/commands/init.ts`.
-- **NUEVO**: `agentic-workflow/src/core/mapping/resolver.ts` (Resolución de rutas absolutas).
-- **NUEVO**: Comandos de scaffolding local.
-
----
-
-## 6. Impacto de la tarea
-- **Arquitectura**: Cambio de modelo de "Snapshot" a "Reference".
-- **Mantenibilidad**: Máxima. El usuario actualiza el npm y automáticamente tiene las nuevas reglas sin tocar su repositorio local.
-- **IDE Performance**: Mejora al reducir el número de ficheros locales indexados.
-
----
-
-## 7. Riesgos y mitigaciones
-- **Riesgo: Mover el directorio de node_modules**
-  - **Impacto**: El mapa de paths se rompe.
-  - **Mitigación**: Implementar un comando `agentic-workflow refresh` que re-escanee y actualice las rutas absolutas.
-
----
-
-## 8. TODO Backlog (Consulta obligatoria)
-- **#004 - Portable Agentic System**: Esta tarea es la evolución final de este TODO, llevando la portabilidad al siguiente nivel de sofisticación técnica.
-
----
-
-## 9. Aprobación
-Este análisis **requiere aprobación explícita del desarrollador**.
-
-```yaml
-approval:
-  developer:
-    decision: null # SI | NO
-    date: null
-    comments: null
-```
-
----
-🏛️ **architect-agent**: Análisis finalizado. Hemos pasado del modelo de "fotocopia" al modelo de "enlace inteligente". Este es el estándar de oro para sistemas de orquestación modernos. ¿Deseas que proceda con el plan de implementación?

package/dist/artifacts/29-agentic-framework-core-reference-refactor/architect/review.md

@@ -1,46 +0,0 @@
----
-artifact: review
-phase: phase-4-implementation
-owner: architect-agent
-status: approved
-related_task: 29-Agentic Framework Core Reference Refactor
----
-
-# Architectural Review — 29-Agentic Framework Core Reference Refactor
-
-## Identificacion del agente (OBLIGATORIA)
-🏛️ **architect-agent**: Informe de revisión final de la implementación arquitectónica.
-
-## 1. Evaluación del Plan original
-La implementación ha seguido fielmente el plan maestro, adaptándose dinámicamente para incluir el servidor MCP y el modelo de estructura espejo propuesto por el desarrollador.
-
-## 2. Contribución de Agentes
-- **tooling-agent**: Ejecutó la infraestructura crítica (Resolver, Init Refactor, Scaffolding System) y el Servidor MCP.
-- **architect-agent**: Diseñó el Discovery Trail y ejecutó el nacimiento del primer rol local (`neo-agent`).
-
-## 3. Verificación de Acceptance Criteria
-
-- [x] **AC-1 (Zero Copy Core)**: Verificado. El comando `init` ya no copia archivos inmutables al proyecto local.
-- [x] **AC-2 (Reference Mapping)**: Verificado. El `index.md` inyecta rutas absolutas hacia `node_modules`.
-- [x] **AC-3 (Reserved Namespace)**: Verificado. El sistema de scaffolding bloquea nombres reservados del core.
-- [x] **AC-4 (Local Extensibility)**: Verificado. Soporte para estructura espejo en `.agent/`.
-- [x] **AC-5 (IDE Discovery)**: Verificado. `AGENTS.md` guía correctamente a la IA hacia el núcleo.
-- [x] **AC-6 (MCP Server)**: Verificado. Expone herramientas de creación de una forma robusta.
-
-## 4. Coherencia Arquitectónica
-El sistema ha pasado de ser un kit de "copiar y pegar" a ser un verdadero **Framework de Orquestación**, donde el núcleo es inmutable, protegible y extensible. La introducción del MCP sitúa al proyecto a la vanguardia de las herramientas de asistencia por IA.
-
-## 5. Decision final
-**ESTADO: APROBADO (PARA VERIFICACIÓN)**
-
----
-
-## 6. Gate de Aprobación
-
-```yaml
-approval:
-  developer:
-    decision: null # SI | NO
-    date: null
-    comments: null
-```

package/dist/artifacts/29-agentic-framework-core-reference-refactor/plan.md

@@ -1,95 +0,0 @@
----
-artifact: implementation_plan
-phase: phase-3-planning
-owner: architect-agent
-status: draft
-related_task: 29-Agentic Framework Core Reference Refactor
----
-
-# Implementation Plan — 28-Agentic Framework Core Reference Refactor
-
-## Identificacion del agente (OBLIGATORIA)
-🏛️ **architect-agent**: Plan de implementación detallado para la migración al modelo de arquitectura por referencia absoluta y estructura espejo.
-
-## 1. Resumen del plan
-Refactorizar el comando `init` y el sistema de mapeo de rutas para que el core del framework se mantenga en `node_modules`. El proyecto local del usuario solo contendrá el índice maestro (`index.md`) y las carpetas espejo vacías (o con contenido personalizado).
-
-## 2. Pasos de ejecucion (OBLIGATORIOS)
-
-### Paso 1: Módulo de Resolución de Core (Tooling)
-- **Agente**: `tooling-agent`
-- **Acción**: Implementar `src/core/mapping/resolver.ts`.
-- **Objetivo**: Función que detecte la ruta absoluta de instalación del paquete `@cmarino/agentic-workflow`.
-- **Entrega**: Módulo de utilidad testeado.
-
-### Paso 2: Refactor del Comando Init (Tooling)
-- **Agente**: `tooling-agent`
-- **Acción**: Modificar `src/cli/commands/init.ts`.
-- **Objetivo**: 
-  - Dejar de copiar archivos de `/rules`, `/workflows`, `/templates`.
-  - Crear la estructura espejo local (`.agent/roles`, `.agent/workflows`, etc.) pero vacía por defecto.
-  - Inyectar las rutas absolutas resueltas en el `index.md` del usuario.
-- **Entrega**: Binario actualizado.
-
-### Paso 3: Sistema de Scaffolding y Protección (Tooling)
-- **Agente**: `tooling-agent`
-- **Acción**: Implementar comandos en `agentic-workflow` CLI:
-  - `agentic-workflow create role <name>`
-  - `agentic-workflow create workflow <name>`
-  - `agentic-workflow create tool <name>`
-- **Objetivo**: 
-  - Generar plantillas locales en la carpeta espejo correspondiente (`.agent/roles/`, etc.).
-  - Implementar el "Reserved Check": si el nombre coincide con un archivo en node_modules, lanzar error y sugerir cambio.
-  - Estos comandos permitirán que tanto el usuario (vía terminal) como el agente (vía `run_command`) puedan generar nuevos componentes siguiendo el estándar.
-- **Entrega**: CLI extendido con nuevos comandos de creación.
-
-- **Entrega**: Plantilla de documentación actualizada.
-
-### Paso 5: Servidor MCP e Integración de Tools (Tooling)
-- **Agente**: `tooling-agent`
-- **Acción**: Implementar un servidor MCP que exponga las capacidades del CLI como herramientas estructuradas (ej: `create_role`).
-- **Objetivo**: Habilitar a los agentes para usar las herramientas de forma nativa y robusta.
-
-### Paso 6: Primer Rol Local - neo-agent (Architect)
-- **Agente**: `architect-agent`
-- **Acción**: Utilizar el nuevo sistema (vía MCP o CLI) para crear el primer rol de tipo `developer`.
-- **Nombre**: **neo-agent** (como primer compañero developer local).
-- **Objetivo**: Validar el sistema de extensión local. Este rol residirá físicamente en el proyecto del usuario (`.agent/roles/neo-agent.md`), permitiendo personalizar sus reglas e instrucciones de desarrollo sin afectar al core.
-- **Entrega**: Fichero de rol `neo-agent.md` operativo y registrado en el índice.
-
-## 3. Estrategia de Testing (QA)
-- **Agente**: `qa-agent`
-- **Unit**: Validar que el `resolver.ts` funciona tanto en desarrollo como tras un `npm link`.
-- **E2E**: Ejecutar `init` en una carpeta limpia y verificar que los archivos de node_modules NO están presentes físicamente pero SÍ están referenciados en el `index.md`.
-- **Security**: Intentar crear un rol `architect` y validar que el CLI lo bloquea.
-
-## 4. Estimación y Cronograma
-- Complejidad: Media-Alta (Cambio de paradigma).
-- Esfuerzo estimado: 1 sesión de implementación granular.
-
----
-
-## 5. Decisiones Técnicas (OBLIGATORIA)
-- Usaremos `path.resolve()` dinámico en el momento del `init` para clavar los paths absolutos en el `index.md`.
-- El formato del índice local usará bloques YAML claros diferenciando `core` y `custom`.
-
----
-
-## 6. Demo Plan
-1. Crear carpeta `test-refactor`.
-2. Ejecutar `agentic-workflow init`.
-3. Mostrar que `.agent/roles/` está vacía en el disco.
-4. Mostrar que `index.md` tiene la ruta a `node_modules`.
-5. Mostrar cómo un agente (yo mismo) puede leer el rol `architect` saltando al link.
-
----
-
-## 7. Gate de Aprobación
-
-```yaml
-approval:
-  developer:
-    decision: null # SI | NO
-    date: null
-    comments: null
-```

package/dist/artifacts/29-agentic-framework-core-reference-refactor/researcher/research.md

@@ -1,68 +0,0 @@
-🔬 **researcher-agent**: Iniciando investigación para la refactorización por referencia absoluta.
-
----
-artifact: research
-phase: phase-1-research
-owner: researcher-agent
-status: approved
-related_task: 29-Agentic Framework Core Reference Refactor
----
-
-# Research Report — 29-Agentic Framework Core Reference Refactor
-
-## 1. Resumen ejecutivo
-Investigación sobre la viabilidad de un modelo de orquestación agéntica basado en referencias absolutas al paquete npm en el sistema de archivos local. Los hallazgos confirman que Node.js permite resolver la ubicación física del paquete fácilmente y que los agentes de IDE (Cursor/Windsurf) pueden seguir estas rutas si se indexan correctamente en el archivo maestro.
-
-## 2. Necesidades detectadas
-- **Resolución de Caminos Absolutos**: Necesidad de una función que, en tiempo de ejecución (`init`), determine `node_modules/@cmarino/agentic-workflow`.
-- **Merging de Índices**: Estrategia para combinar el índice "Core" (solo lectura en node_modules) con el índice "Custom" (lectura/escritura en .agent/).
-- **Protocolo de Links en IDE**: Validación de que `@` o rutas absolutas en Markdown son transitivas para los agentes.
-
-## 3. Hallazgos técnicos
-
-### Resolución de Paths en Node.js
-- **import.meta.resolve**: Permite obtener la URL de un módulo. [MDN: import.meta.resolve](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import.meta/resolve)
-- **createRequire**: Útil para resolver módulos CommonJS o paths de paquetes.
-- **Diferencia Local/Npm**: Cuando se usa `npm link`, el path apunta al directorio de desarrollo. En `npm install`, apunta a `node_modules`. Ambos casos son válidos si se usa el path físico.
-
-### Estrategia de Indexación (Overlays)
-- Se propone un modelo de **Overlay Indexing**:
-  1. El CLI genera `.agent/index.md` con una sección `core` (apuntando a node_modules).
-  2. Una sección `custom` para extensiones locales.
-  3. Los alias del core se autogeneran basándose en el contenido de `node_modules/src/rules/index.md`, etc.
-
-### Visibilidad de node_modules en IDEs
-- **Cursor/Windsurf**: Por defecto, a menudo ignoran `node_modules`. Sin embargo, si un archivo como `AGENTS.md` o `.agent/index.md` referencia **explícitamente** una ruta absoluta o relativa hacia un fichero dentro de `node_modules`, el agente **tiene permiso y capacidad** de leerlo. La clave es el "Discovery path".
-
-## 4. APIs Web / WebExtensions relevantes
-- *No aplica directamente*. Se hará uso intensivo de `node:path` y `node:fs`.
-
-## 5. Compatibilidad
-- Compatible con Node.js 18+ (ESM).
-- Compatible con agentes de IA que respetan enlaces de archivos Markdown (Cursor, Windsurf, VS Code).
-
-## 6. Oportunidades AI-first detectadas
-- **Auto-indexación**: El sistema puede regenerar el índice local cada vez que se detecta un cambio en la versión del paquete core, manteniendo la sincronización total.
-
-## 7. Riesgos identificados
-- **Rigidez de Paths Absolutos**: Si el usuario mueve el proyecto de carpeta, los paths absolutos guardados en el índice se rompen.
-- **Mitigación**: El comando `init` (o un nuevo comando `refresh`) debe ser capaz de re-mapear los paths rápidamente.
-- **Acceso a node_modules**: Algunos entornos de seguridad restringidos podrían bloquear la lectura profunda de node_modules por parte de herramientas externas.
-
-## 8. Fuentes
-- [Node.js recursive file search](https://nodejs.org/api/fs.html#fsreaddirpath-options-callback)
-- [IDE Agent Context Management Best Practices]
-
----
-
-## 9. Aprobacion del desarrollador (OBLIGATORIA)
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: "2026-01-20T08:00:00+01:00"
-    comments: "Aprobado vía consola. Se confirma el modelo de referencia absoluta."
-```
-
----
-🔬 **researcher-agent**: Investigación finalizada. He validado el modelo de resolución de rutas absolutas como el más estable para entornos de IA. @architect-agent, el camino está despejado para el análisis.

package/dist/artifacts/29-agentic-framework-core-reference-refactor/results-acceptance.md

@@ -1,59 +0,0 @@
----
-artifact: results_acceptance
-phase: phase-6-results-acceptance
-owner: architect-agent
-status: approved
-related_task: 29-Agentic Framework Core Reference Refactor
----
-
-# Results & Acceptance — 29-Agentic Framework Core Reference Refactor
-
-## Identificacion del agente (OBLIGATORIA)
-🏛️ **architect-agent**: Informe final de resultados y cierre de hito arquitectónico.
-
-## 1. Resumen de Logros
-La Tarea #29 ha transformado la arquitectura del sistema de agentes de un modelo de acoplamiento por copia a un modelo de **Referencia Absoluta y Portabilidad Total**.
-
-### Hitos alcanzados:
-- **Core Resolver**: Implementada lógica de detección dinámica de la ruta del paquete `@cmarino/agentic-workflow`.
-- **Zero-Copy Init**: El comando `init` ya no ensucia el repositorio local con archivos core; inyecta referencias físicas a `node_modules`.
-- **Estructura Espejo**: Configurado el sistema para permitir la extensión local en `.agent/` sin perder la sincronización con el núcleo.
-- **Scaffolding Inteligente**: Creados comandos `create role` y `create workflow` con protección de namespace reservado.
-- **Servidor MCP**: Integrado servidor de Model Context Protocol para que la IA interactúe nativamente con el framework.
-- **Nacimiento de 👨‍💻 neo-agent**: Primer desarrollador local configurado con una estricta segregación de responsabilidades.
-- **Blindaje del Arquitecto**: Actualizada la constitución del arquitecto para prohibir tareas operativas (código, investigación, tests).
-
-## 2. Evidence
-- Directorio `.agent/index.md` con paths absolutos.
-- Directorio `.agent/rules/roles/neo.md` operativo y personalizado.
-- Comandos CLI funcionales: `init`, `create`, `mcp`.
-- Matriz de responsabilidades auditada y validada.
-
-## 3. Feedback del Desarrollador
-- Se ha ajustado la ubicación de roles locales a `rules/roles/` para una coherencia total con el core.
-- Se ha refinado la iconografía de los agentes para una mejor experiencia visual.
-
-## 4. Estado Final de Acceptance Criteria
-- [x] Implement reference-based mapping (Absolute Paths).
-- [x] Maintain mirror structure without custom/ directory.
-- [x] Protected namespace (Reserved names check).
-- [x] AGENTS.md high visibility trail.
-- [x] Scaffolding Commands (create role/workflow).
-- [x] MCP Server integration.
-- [x] Creation of neo-agent.
-- [x] Strict separation of duties (Architect vs Dev).
-
-## 5. Decision Final
-**ESTADO: CERRADO Y APROBADO**
-
----
-
-## 6. Gate de Aceptación
-
-```yaml
-approval:
-  developer:
-    decision: null # SI | NO
-    date: null
-    comments: null
-```

package/dist/artifacts/29-agentic-framework-core-reference-refactor/task.md

@@ -1,99 +0,0 @@
-# Task: 29-Agentic Framework Core Reference Refactor
-
-## Identificación
-- id: 29
-- title: Agentic Framework Core Reference Refactor
-- scope: core
-- owner: architect-agent
-
-## Origen
-- created_from:
-  - workflow: tasklifecycle
-  - source: feedback desarrollador post-tarea-28
-  - candidate_path: .agent/artifacts/candidate/task.md
-
-## Descripción de la tarea
-Refactorización arquitectónica profunda para mover el centro de gravedad del sistema agéntico al paquete npm. El core (roles, rules, workflows) quedará alojado en node_modules y el proyecto local solo contendrá referencias, extensiones y el historial de ejecución.
-
-## Objetivo
-Desplegar un modelo de orquestación portable por referencia absoluta, garantizando inmutabilidad del core y extensibilidad local segura.
-
-## Estado del ciclo de vida (FUENTE ÚNICA DE VERDAD)
-
-```yaml
-task:
-  id: "29"
-  title: "Agentic Framework Core Reference Refactor"
-  status: "completed"
-  strategy: "long"
-  artifacts:
-    supplemental: []
-  phase:
-    current: "completed"
-    validated_by: "architect-agent"
-    updated_at: "2026-01-20T08:23:00+01:00"
-  lifecycle:
-    phases:
-      phase-0-acceptance-criteria:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-20T08:05:00+01:00"
-      phase-1-research:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-20T08:00:00+01:00"
-      phase-2-analysis:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-20T08:00:30+01:00"
-      phase-3-planning:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-20T08:05:00+01:00"
-      phase-4-implementation:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-20T08:18:00+01:00"
-      phase-5-verification:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-20T08:20:00+01:00"
-      phase-6-results-acceptance:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-20T08:23:00+01:00"
-      phase-7-evaluation:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-20T08:23:30+01:00"
-      phase-8-commit-push:
-        completed: true
-        validated_by: "architect-agent"
-        validated_at: "2026-01-20T08:24:00+01:00"
-    subflows:
-      drivers:
-        create: []
-        refactor: []
-        delete: []
-      modules:
-        create: []
-        refactor: []
-        delete: []
-      pages:
-        create: []
-      shards:
-        create: []
-```
-
----
-
-## 2. Definición y Alcance (Contrato)
-- **Acceptance Criteria**: [.agent/artifacts/29-agentic-framework-core-reference-refactor/acceptance.md](.agent/artifacts/29-agentic-framework-core-reference-refactor/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 avance de fase requiere validación explícita.

package/dist/artifacts/29-agentic-framework-core-reference-refactor/verification.md

@@ -1,54 +0,0 @@
----
-artifact: verification
-phase: phase-5-verification
-owner: qa-agent
-status: approved
-related_task: 29-Agentic Framework Core Reference Refactor
----
-
-# Verification Report — 29-Agentic Framework Core Reference Refactor
-
-## Identificacion del agente (OBLIGATORIA)
-✅ **qa-agent**: Informe de verificación técnica de la refactorización por referencia absoluta.
-
-## 1. Resumen de ejecución
-Se ha verificado la implementación del modelo de referencia absoluta y el sistema de extensión local, asegurando la inmutabilidad del núcleo y la correcta visibilidad para agentes de IA.
-
-## 2. Test Execution
-| Test ID | Descripción | Resultado |
-|---------|-------------|-----------|
-| V-01 | Resolución de ruta absoluta del core | **PASS** |
-| V-02 | Inyección de referencias en index.md | **PASS** |
-| V-03 | Bloqueo de nombres reservados (Namespace) | **PASS** |
-| V-04 | Creación de rol local (neo-agent) | **PASS** |
-| V-05 | Visibilidad de AGENTS.md Trail | **PASS** |
-| V-06 | Servidor MCP - Listado de herramientas | **PASS** |
-
-## 3. Métricas de Calidad
-- **Code Cleanliness**: Alta. Se ha desacoplado la lógica de creación de la UI de Clack.
-- **Portabilidad**: Total. El sistema no depende de rutas relativas frágiles.
-- **Seguridad**: El core se mantiene en modo "solo lectura" conceptual dentro de node_modules.
-
-## 4. Incidentes Identificados
-- *Ninguno crítico*. Se detectó la necesidad de un build previo para ejecutar el CLI localmente, lo cual fue resuelto durante la implementación de la tarea #6.
-
-## 5. Checklist de Verificación
-- [x] El core reside exclusivamente en `node_modules`.
-- [x] El `index.md` local contiene punteros absolutos funcionales.
-- [x] Los agentes externos pueden navegar al código del framework.
-- [x] Existe un comando para crear nuevos componentes locales.
-
-## 6. Decision Final
-**ESTADO: PASS**
-
----
-
-## 7. Gate de Aprobación
-
-```yaml
-approval:
-  developer:
-    decision: null # SI | NO
-    date: null
-    comments: null
-```

package/dist/artifacts/3-developer-feedback-gate/acceptance-criteria.md

@@ -1,18 +0,0 @@
-# Phase 0: Acceptance Criteria - Developer Feedback Gate
-
-## 1. Goal
-Ensure no task is technically closed (Phase 8) without the developer's explicit evaluation of the agents' performance.
-
-## 2. Requirements
-- **Interaction**: The agent must pause in Phase 7 and use `notify_user` to ask for:
-    - Approval (SI/NO)
-    - Score (0-5)
-    - Comments
-- **Storage**: This information must be recorded in `metrics.md` under a new section.
-- **Enforcement**: Phase 8 must fail its input check if `metrics.md` does not show explicit approval.
-
-## 3. DoD (Definition of Done)
-- [ ] `phase-7-evaluation.md` updated with the interaction step.
-- [ ] `phase-8-commit-push.md` updated with the input check.
-- [ ] `task-metrics.md` template updated with the new section.
-- [ ] Manual verification via "Verification Report".

package/dist/artifacts/3-developer-feedback-gate/analysis.md

@@ -1,27 +0,0 @@
-# Analysis - Developer Feedback Gate
-
-## Objetivo
-Implementar un control de calidad donde el desarrollador valida la evaluación del agente antes del cierre de la tarea.
-
-## Componentes Afectados
-
-1.  **Workflow Phase 7 (Evaluation)**:
-    - **Cambio**: Insertar paso interactivo.
-    - **Lógica**: Detener ejecución -> Mostrar métricas -> Esperar input.
-    - **Fail-safe**: Si input != SI, abortar flujo.
-
-2.  **Workflow Phase 8 (Commit)**:
-    - **Cambio**: Reforzar pre-condiciones.
-    - **Lógica**: Verificar no solo que `metrics.md` existe, sino que contiene la firma de aprobación.
-
-3.  **Template `task-metrics.md`**:
-    - **Cambio**: Estructura de datos.
-    - **Campos**: `Aprobado`, `Rating`, `Comentarios`.
-
-## Riesgos y Mitigaciones
-- **Riesgo**: Bloqueo por falso negativo en la validación de texto (ej. espacios extra).
-  - **Mitigación**: Definir un string de validación estricto y simple: "Aprobado: SI".
-
-## Estimación
-- Baja complejidad.
-- Alto impacto en gobernanza.