@christianmaf80/agentic-workflow 1.22.0-beta.6 → 1.22.0-beta.8

package/README.es.md

@@ -11,8 +11,9 @@
 ## ✨ Características Principales
 
 - **Protocolo AHRP (Agentic Handover & Reasoning Protocol)**: Impone un flujo estricto de Triple-Puerta para cada tarea (Activación, Aprobación de Razonamiento y Aceptación de Resultados).
+- **Gobernanza de Runtime y MCP**: Integración profunda con un servidor MCP para seguimiento de ciclos de vida, validación de puertas y logs a prueba de manipulaciones.
+- **Skills Agénticos**: Capacidades modulares para los agentes, incluyendo habilidades de gobernanza localizadas (ej: `skill.runtime-governance`).
 - **Arquitectura local**: Copia las reglas y workflows del core dentro de `.agent/` para evitar dependencias de acceso continuado a `node_modules`.
-- **Gobernanza de Tolerancia Cero**: Penalizaciones automáticas de rendimiento por violaciones del protocolo.
 - **Independiente y Portátil**: Funciona en cualquier proyecto, siempre que el agente del IDE pueda leer archivos Markdown.
 
 ## 📦 Instalación
@@ -40,28 +41,69 @@ Inicializa el sistema agéntico en el directorio actual.
 npx agentic-workflow init
 ```
 
-### `create <role|workflow> <name>`
-Genera el andamiaje (scaffolding) para un nuevo componente personalizado.
+### `create <role|workflow|skill> <name>`
+Genera el andamiaje (scaffolding) para un nuevo componente específico del proyecto.
 - **role**: Crea un nuevo rol de agente con reglas de identificación obligatorias.
 - **workflow**: Crea una plantilla de ciclo de trabajo personalizado.
+- **skill**: Crea una nueva habilidad modular con su propia plantilla `SKILL.md`.
 ```bash
 npx agentic-workflow create role neo
 ```
 
 ### `restore`
-Recupera la configuración de `.agent/` desde una copia de seguridad previa.
-- Los backups se almacenan como `.agent.backup_<timestamp>` en la raíz del proyecto.
-- Permite seleccionar versiones antes de un cambio destructivo.
+Recuepra la configuración de `.agent/` desde una copia de seguridad previa.
 ```bash
 npx agentic-workflow restore
 ```
 
+### `clean`
+Elimina archivos de configuración temporales o heredados (ej: configuraciones MCP obsoletas).
+```bash
+npx agentic-workflow clean
+```
+
+### `mcp`
+Inicia el servidor local del Runtime MCP (modo stdio).
+```bash
+npx agentic-workflow mcp
+```
+
+### `register-mcp`
+Registra automáticamente el servidor local en la configuración de Antigravity/Gemini.
+```bash
+npx agentic-workflow register-mcp
+```
+
+## ⚙️ Configuración Avanzada
+
+### Integración de Runtime MCP
+El sistema utiliza un servidor MCP para rastrear el estado del flujo. Para conectarlo con tu asistente de IDE:
+1. Ejecuta `npx agentic-workflow register-mcp`.
+2. Asegúrate de que `mcp_config.json` apunte al binario local del CLI.
+3. Los logs de ejecución se guardan en `agentic-runtime.log` para auditoría y depuración.
+
 ## 🧠 Conceptos Core
 
 ### Ciclos de Vida
 El framework soporta dos flujos principales según la complejidad de la tarea:
-1. **Ciclo de Vida Largo (9 Fases)**: Para funcionalidades complejas que requieren Investigación, Análisis, Planificación y Revisión Arquitectónica formal.
-2. **Ciclo de Vida Corto (3 Fases)**: Para correcciones rápidas o actualizaciones simples, fusionando Aceptación, Implementación y Cierre.
+
+#### 1. Ciclo de Vida Largo (9 Fases)
+Diseñado para funcionalidades complejas, cambios arquitectónicos o tareas con alto riesgo. Garantiza el máximo razonamiento antes de escribir una sola línea de código.
+- **Fase 0: Criterios de Aceptación**: Elimina la ambigüedad definiendo exactamente qué significa el éxito.
+- **Fase 1: Investigación**: Recopilación de contexto. Necesaria para entender el código existente o APIs externas.
+- **Fase 2: Análisis**: Evaluación de impacto. Identifica riesgos y restricciones arquitectónicas.
+- **Fase 3: Planificación**: Plan de implementación detallado. Crucial para la alineación con el desarrollador.
+- **Fase 4: Implementación**: El proceso de codificación propiamente dicho.
+- **Fase 5: Verificación**: Pruebas rigurosas y validación de los cambios realizados.
+- **Fase 6: Aceptación de Resultados**: Firma final del desarrollador sobre el valor entregado.
+- **Fase 7: Evaluación**: Retrospectiva sobre el desempeño del agente y eficiencia del proceso.
+- **Fase 8: Commit & Push**: Persistencia segura de los cambios en el repositorio.
+
+#### 2. Ciclo de Vida Corto (3 Fases)
+Optimizado para correcciones rápidas, actualizaciones simples de documentación o cambios de bajo riesgo.
+- **Fase 1: Brief**: Fusiona Aceptación, Análisis y Planificación en un solo paso para mayor agilidad.
+- **Fase 2: Implementación**: Codificación y verificación combinadas.
+- **Fase 3: Cierre**: Aceptación de resultados y limpieza final.
 
 ### Protocolo AHRP
 Cada tarea de un agente sigue el **Protocolo de Traspaso y Razonamiento Agéntico**:
@@ -72,12 +114,14 @@ Cada tarea de un agente sigue el **Protocolo de Traspaso y Razonamiento Agéntic
 ### Arquitectura por Instalación
 Para garantizar la estabilidad, la lógica central del framework (reglas y workflows) se instala dentro de la carpeta `.agent` del proyecto. Esto ofrece una copia local limpia que se puede extender sin tocar el paquete publicado.
 
-## ⚖️ Gobernanza
+### Sistema de Indexación por Dominios
+El sistema utiliza una **Arquitectura de Indexación en Cascada** para una trazabilidad absoluta:
+1. **Root Index** (`.agent/index.md`): Declara los puntos de entrada para todos los dominios del sistema (reglas, workflows, templates, skills, artefactos).
+2. **Índices de Dominio**: Cada carpeta contiene su propio `index.md` donde se asignan **alias** a los archivos.
+3. **Modelo de Referencia**: Los agentes nunca utilizan rutas absolutas. Resuelven las referencias a través del sistema de alias (ej: `skill.runtime-governance` → `.agent/skills/runtime-governance/SKILL.md`), lo que garantiza que la lógica se pueda mover o actualizar sin romper los flujos de trabajo.
 
-Este framework se basa en el principio de **Máxima Disciplina**. Los agentes deben:
-1. Identificarse con un prefijo obligatorio.
-2. Enviar un plan de razonamiento antes de cualquier modificación.
-3. Obtener la aprobación explícita del desarrollador (`SI`) para cada transición.
+### Responsabilidad en Runtime
+Todas las transiciones de ciclo de vida se registran a través de un Runtime MCP dedicado. Las acciones realizadas sin una "Huella de Gobernanza" correspondiente (logs de MCP) se consideran inválidas y están sujetas a reversión.
 
 ## 📄 Licencia
 

package/README.md

@@ -11,8 +11,9 @@
 ## ✨ Key Features
 
 - **AHRP (Agentic Handover & Reasoning Protocol)**: Enforces a strict Triple-Gate flow for every task (Activation, Reasoning Approval, and Results Acceptance).
+- **Runtime Governance & MCP**: Deep integration with an MCP server for lifecycle tracking, gate validation, and tamper-proof logging.
+- **Agentic Skills**: Modular capabilities for agents, including localized and specialized governance skills (e.g., `skill.runtime-governance`).
 - **Local Core Snapshot**: Copies core rules and workflows into `.agent/` so runtime no longer depends on `node_modules` access.
-- **Zero-Tolerance Governance**: Automatic performance penalties for protocol violations.
 - **Standalone & Portable**: Works in any project provided the IDE agent can read Markdown files.
 
 ## 📦 Installation
@@ -40,28 +41,69 @@ Initializes the agentic system in the current directory.
 npx agentic-workflow init
 ```
 
-### `create <role|workflow> <name>`
-Scaffolds a new custom component.
+### `create <role|workflow|skill> <name>`
+Scaffolds a new project-specific component.
 - **role**: Creates a new agent role with mandatory identification rules.
 - **workflow**: Creates a custom work cycle template.
+- **skill**: Creates a new modular skill with its own `SKILL.md` template.
 ```bash
 npx agentic-workflow create role neo
 ```
 
 ### `restore`
 Recovers the `.agent/` configuration from a previous backup.
-- Backups are stored as `.agent.backup_<timestamp>` in the project root.
-- Allows selecting versions before a destructive change.
 ```bash
 npx agentic-workflow restore
 ```
 
+### `clean`
+Removes legacy or temporary configuration files (e.g., outdated MCP setups).
+```bash
+npx agentic-workflow clean
+```
+
+### `mcp`
+Starts the local MCP Runtime server (stdio mode).
+```bash
+npx agentic-workflow mcp
+```
+
+### `register-mcp`
+Automatically registers the local server in the Antigravity/Gemini config.
+```bash
+npx agentic-workflow register-mcp
+```
+
+## ⚙️ Advanced Configuration
+
+### MCP Runtime Integration
+The system relies on an MCP server to track the workflow state. To connect it with your IDE assistant (like Antigravity):
+1. Run `npx agentic-workflow register-mcp`.
+2. Ensure `mcp_config.json` (or equivalent) points to the local CLI binary.
+3. The Runtime logs are stored in `agentic-runtime.log` for debugging.
+
 ## 🧠 Core Concepts
 
 ### Lifecycles
 The framework supports two main workflows depending on task complexity:
-1. **Long Lifecycle (9 Phases)**: For complex features requiring Research, Analysis, Planning, and formal Architectural Review.
-2. **Short Lifecycle (3 Phases)**: For quick fixes or simple updates, merging Acceptance, Implementation, and Closure.
+
+#### 1. Long Lifecycle (9 Phases)
+Designed for complex features, architectural changes, or tasks with high risk. It ensures maximum reasoning before a single line of code is written.
+- **Phase 0: Acceptance Criteria**: Eliminates ambiguity by defining exactly what success looks like.
+- **Phase 1: Research**: Context gathering. Necessary to understand existing code or external APIs.
+- **Phase 2: Analysis**: Impact evaluation. Identifies risks and architectural constraints.
+- **Phase 3: Planning**: Detailed implementation plan. Crucial for developer alignment before execution.
+- **Phase 4: Implementation**: The actual coding process.
+- **Phase 5: Verification**: Rigorous testing and validation of the implemented changes.
+- **Phase 6: Results Acceptance**: Final developer sign-off on the delivered value.
+- **Phase 7: Evaluation**: Retrospective on the agent's performance and process efficiency.
+- **Phase 8: Commit & Push**: Safely persisting the changes to the repository.
+
+#### 2. Short Lifecycle (3 Phases)
+Optimized for quick fixes, simple documentation updates, or low-risk changes.
+- **Phase 1: Brief**: Merges Acceptance, Analysis, and Planning into a single step for speed.
+- **Phase 2: Implementation**: Combined coding and verification.
+- **Phase 3: Closure**: Results acceptance and final cleanup.
 
 ### AHRP Protocol
 Every agent task follows the **Agentic Handover & Reasoning Protocol**:
@@ -72,12 +114,14 @@ Every agent task follows the **Agentic Handover & Reasoning Protocol**:
 ### Architecture by Install
 To ensure stability, the framework's core logic (rules and workflows) is installed into your project's `.agent` folder. This provides a clean, local copy that can be extended without touching the published package.
 
-## ⚖️ Governance
+### Domain Indexing System
+The system uses a **Cascading Indexing Architecture** for absolute traceability:
+1. **Root Index** (`.agent/index.md`): Declares the entry points for all system domains (rules, workflows, templates, skills, artifacts).
+2. **Domain Indexes**: Each folder contains its own `index.md` where files are assigned **aliases**.
+3. **Reference Model**: Agents never use absolute paths. They resolve references through the alias system (e.g., `skill.runtime-governance` → `.agent/skills/runtime-governance/SKILL.md`), ensuring that logic can be moved or updated without breaking workflows.
 
-This framework is built on the principle of **Maximum Discipline**. Agents are required to:
-1. Identify themselves with a mandatory prefix.
-2. Submit a reasoning plan before any modification.
-3. Obtain explicit developer approval (`YES`) for every transition.
+### Runtime Accountability
+All lifecycle transitions are recorded through a dedicated MCP Runtime. Actions performed without a corresponding "Governance Trace" (MCP logs) are considered invalid and subject to reversal.
 
 ## 📄 License
 

package/bin/cli.js

@@ -5,41 +5,48 @@ import { createCommand } from '../dist/cli/commands/create.js';
 import { restoreCommand } from '../dist/cli/commands/restore.js';
 import { cleanCommand } from '../dist/cli/commands/clean.js';
 import { mcpCommand } from '../dist/cli/commands/mcp.js';
+import { registerMcpCommand } from '../dist/cli/commands/register-mcp.js';
 
 const program = new Command();
 
 program
-    .name('agentic-workflow')
-    .description('Portable agentic orchestration system')
-    .version('1.0.0');
+  .name('agentic-workflow')
+  .description('Portable agentic orchestration system')
+  .version('1.22.0-beta.7');
 
 program
-    .command('init')
-    .description('Initialize the agentic system in the current directory')
-    .option('--non-interactive', 'Run without prompts (assume YES)')
-    .option('--start-mcp', 'Start MCP server after initialization (foreground)')
-    .action((options) => initCommand(options));
+  .command('init')
+  .description('Initialize the agentic system in the current directory')
+  .option('--non-interactive', 'Run without prompts (assume YES)')
+  .option('--start-mcp', 'Start MCP server after initialization (foreground)')
+  .action((options) => initCommand(options));
 
 program
-    .command('create')
-    .argument('<type>', 'The type of element to create (role, workflow)')
-    .argument('<name>', 'The name for the new element')
-    .description('Scaffold a new project-specific element')
-    .action(createCommand);
+  .command('create')
+  .argument('<type>', 'The type of element to create (role, workflow, skill)')
+  .argument('<name>', 'The name for the new element')
+  .description('Scaffold a new project-specific element')
+  .action(createCommand);
 
 program
-    .command('restore')
-    .description('Restore the agentic system from a backup')
-    .action(restoreCommand);
+  .command('restore')
+  .description('Restore the agentic system from a backup')
+  .action(restoreCommand);
 
 program
-    .command('clean')
-    .description('Remove legacy configuration files (e.g. MCP)')
-    .action(cleanCommand);
+  .command('clean')
+  .description('Remove legacy configuration files (e.g. MCP)')
+  .action(cleanCommand);
 
 program
-    .command('mcp')
-    .description('Start MCP runtime server (stdio)')
-    .action(() => mcpCommand());
+  .command('mcp')
+  .description('Start MCP runtime server (stdio)')
+  .action(() => mcpCommand());
+
+program
+  .command('register-mcp')
+  .description('Register MCP server in Gemini CLI (Antigravity) and/or Codex CLI')
+  .action(() => registerMcpCommand());
 
 program.parse();
+

package/dist/agent/index.md

@@ -38,6 +38,9 @@ agent:
     rules:
       index: .agent/rules/index.md
 
+    skills:
+      index: .agent/skills/index.md
+
 ```
 
 ## Reglas

package/dist/agent/rules/constitution/index.md

@@ -18,6 +18,7 @@ por alias en lugar de rutas directas.
 constitution:
   clean_code: .agent/rules/constitution/clean-code.md
   agents_behavior: .agent/rules/constitution/agents-behavior.md
+  runtime_integration: .agent/rules/constitution/runtime-integration.md
 ```
 
 ## Reglas

package/dist/agent/rules/constitution/runtime-integration.md

@@ -0,0 +1,101 @@
+---
+id: constitution.runtime_integration
+owner: architect-agent
+version: 1.0.0
+severity: PERMANENT
+scope: global
+---
+
+# RUNTIME INTEGRATION CONSTITUTION
+
+Este documento define las reglas obligatorias para la integración del runtime MCP en la ejecución de workflows.
+
+---
+
+## 1. REGLA DE INTEGRACIÓN RUNTIME (PERMANENT - CRITICAL)
+
+Cuando cualquier agente ejecute un workflow del sistema (`init`, `tasklifecycle-short`, `tasklifecycle-long`), **DEBE** utilizar las herramientas del runtime MCP para garantizar trazabilidad y persistencia de estado.
+
+### 1.1 Herramientas Obligatorias
+
+| Evento | Herramienta MCP | Cuándo usar |
+|--------|-----------------|-------------|
+| Inicio de tarea | `runtime.run` | Al crear una nueva tarea |
+| Avance de fase | `runtime.advance_phase` | Al completar cada fase del ciclo |
+| Obtener estado | `runtime.get_state` | Para consultar el estado actual |
+| Validar gate | `runtime.validate_gate` | Antes de solicitar aprobación |
+| Evento importante | `runtime.emit_event` | Para eventos de chat, errores, etc. |
+
+### 1.2 Flujo Obligatorio
+
+```
+1. Al iniciar workflow:
+   → Llamar `runtime.run` con taskPath y agent
+
+2. Al completar cada fase:
+   → Llamar `runtime.validate_gate` para verificar precondiciones
+   → Solicitar aprobación al desarrollador (notify_user)
+   → Llamar `runtime.advance_phase` tras aprobación
+
+3. Durante la ejecución:
+   → Usar `runtime.emit_event` para eventos significativos
+   → Usar `runtime.get_state` para consultar estado si es necesario
+
+### 1.3 Regla de Nulidad (Bypass Detection)
+Cualquier acción técnica de cambio de estado (creación de artefactos, avance de fase) realizada sin una llamada correspondiente registrada en el Runtime MCP será considerada **nula e inválida**. 
+- La "Huella Digital de Gobernanza" (logs de `validate_gate` y `advance_phase`) generada mediante el **Skill de Gobernanza** es el único comprobante legal de cumplimiento de proceso.
+
+### 1.4 Skill de Gobernanza (Mejor Práctica)
+El uso del `skill.runtime-governance` es la **mejor práctica y el método obligatorio** para el `architect-agent`. 
+- **Por qué**: Centraliza la complejidad técnica de las herramientas MCP y permite auditorías reactivas consistentes sin sobrecargar los archivos de workflow.
+- **Invocación**: Los workflows deben simplemente invocar la acción de control, y el Arquitecto debe proveer el "Cómo" mediante este Skill exclusivo.
+```
+
+---
+
+## 2. REQUISITOS PREVIOS (PERMANENT)
+
+Para que esta constitución sea aplicable:
+
+1. El servidor MCP debe estar registrado en el cliente (Antigravity/Codex).
+   - Si no está registrado, ejecutar: `agentic-workflow register-mcp`
+
+2. El servidor MCP debe estar corriendo en background o ser invocable.
+
+### 2.1 Verificación de Registro
+
+Al iniciar cualquier workflow, el agente **DEBE** verificar que las herramientas del runtime están disponibles. Si no lo están:
+- Informar al desarrollador.
+- Sugerir ejecutar `agentic-workflow register-mcp`.
+- Continuar con ejecución fallback (sin runtime) si el desarrollador lo autoriza.
+
+---
+
+## 3. LOGS Y TRAZABILIDAD (PERMANENT)
+
+Todas las llamadas al runtime generan logs en stderr. Estos logs son la **fuente de verdad** para auditar la ejecución de workflows.
+
+### 3.1 Formato de Logs
+```
+[LEVEL] [SOURCE] Message {context}
+```
+
+### 3.2 Herramienta de Debug
+- `debug_read_logs`: Permite leer los logs almacenados en el buffer del runtime.
+
+---
+
+## 4. EXCEPCIONES (PERMANENT)
+
+Esta constitución **NO aplica** cuando:
+- El desarrollador solicita explícitamente ejecución sin runtime.
+- Las herramientas MCP no están disponibles y el desarrollador autoriza fallback.
+- Se trata de operaciones de solo lectura (consultas, investigación).
+
+---
+
+## Authority
+
+Esta constitución es **binding** cuando referenciada como `INJECTED` o `PERMANENT`.
+Creada por: architect-agent
+Fecha: 2026-02-02

package/dist/agent/rules/roles/architect.md

@@ -11,7 +11,7 @@ severity: PERMANENT
 scope: global
 
 capabilities:
-  skills: []
+  skills: ["skill.runtime-governance"]
   tools:
     git: supported
 ---
@@ -97,3 +97,4 @@ Eres el maximo responsable de la integridad del ciclo de vida:
 2. **Validacion fisica**: Nunca procedas a una fase si el artefacto de la fase anterior no contiene la marca fisica de aprobacion del usuario.
 3. **Cero decision propia en gates**: No tienes autoridad para decidir que un gate es innecesario.
 4. **Espejo del proceso**: Si el usuario pide saltarse un paso, tu rol es recordarle la constitucion y los riesgos.
+5. **Gobernanza por Skill**: DEBES utilizar obligatoriamente el procedimiento de `skill.runtime-governance` para cada gate y cambio de fase. No tienes autoridad para prescindir de la trazabilidad MCP.

package/dist/agent/workflows/init.md

@@ -45,6 +45,11 @@ El agente **DEBE** adherirse a estas meta-reglas de comportamiento durante TODA
     - Si el usuario pide saltarse pasos, el agente **DEBE** recordar las reglas de constitución y rechazar amablemente el atajo.
 
 ## Pasos obligatorios
+0. **Verificar Trazabilidad (OBLIGATORIO)**:
+   - Activar y seguir el procedimiento de `skill.runtime-governance` para confirmar la disponibilidad de herramientas MCP.
+   - El agente **DEBE** confirmar que la herramienta respondió correctamente antes de proceder.
+   - Si el skill o las herramientas no están disponibles → FAIL.
+
 1. Activar `architect-agent` como rol arquitecto.
    - Mostrar un mensaje único de estado (ej: "Cargando init...") y **no** listar lecturas de ficheros individuales.
    - En ese mismo mensaje, presentar al architect-agent y dar contexto al desarrollador: rol, objetivo del init y qué información se le pedirá a continuación.
@@ -114,8 +119,10 @@ Requisitos (todos obligatorios):
    - `language.value` no vacío
    - `language.confirmed == true`
    - `strategy` es "long" o "short"
+   - **`traceability.verified == true`** (Confirma cumplimiento del protocolo de `skill.runtime-governance`)
 3) El artefacto cumple el template oficial.
 4) Idioma definido y confirmado.
 5) Estrategia seleccionada.
-6) No se cargaron índices fuera del set permitido (solo `.agent/index.md`, `agent.domains.rules.index`, `rules.constitution.index`).
-7) El Root Index `.agent/index.md` fue cargado antes de cualquier otro índice.
+6) **Trazabilidad confirmada**: El agente ha verificado la disponibilidad de herramientas MCP siguiendo las instrucciones del Skill de Gobernanza.
+7) No se cargaron índices fuera del set permitido (solo `.agent/index.md`, `agent.domains.rules.index`, `rules.constitution.index`).
+8) El Root Index `.agent/index.md` fue cargado antes de cualquier otro índice.

package/dist/agent/workflows/tasklifecycle-long/phase-0-acceptance-criteria.md

@@ -22,6 +22,7 @@ blocking: true
 > **Constitución activa (OBLIGATORIO)**:
 > - Cargar `constitution.clean_code` antes de iniciar
 > - Cargar `constitution.agents_behavior` (sección 7: Gates, sección 8: Constitución)
+> - **Activar `skill.runtime-governance`** (Uso exclusivo del Architect para validación y trazabilidad)
 
 ## Output (REQUIRED)
 - Current task (definitiva) con acceptance criteria completos:
@@ -39,7 +40,11 @@ blocking: true
 - Registrar los acceptance criteria dentro del fichero de current task.
 
 ## Pasos obligatorios
-0. Activar `architect-agent` y usar prefijo obligatorio en cada mensaje.
+0. **Verificar Gobernanza (OBLIGATORIO)**:
+   - Activar `skill.runtime-governance`.
+   - Ejecutar el procedimiento de trazabilidad inicial (Paso 0 del Skill).
+   - El agente **DEBE** confirmar que el sistema de logs está activo antes de proceder.
+   - Usar prefijo obligatorio en cada mensaje.
 1. Cargar y leer el task candidate:
    - `artifacts.candidate.task`
    - Extraer:
@@ -121,6 +126,10 @@ blocking: true
 
 9. PASS
    - Informar que la Fase 0 está completada correctamente.
+   - Seguimiento del protocolo de cierre en `skill.runtime-governance`:
+     - Llamar `runtime.validate_gate` para verificar integridad.
+     - Solicitar aprobación final al usuario.
+     - Llamar `runtime.advance_phase` tras el "SI".
    - El `architect-agent` **DEBE realizar explícitamente** las siguientes acciones:
     - Marcar la Fase 0 como completada en el `task.md`.
     - Establecer `task.lifecycle.phases.phase-0-acceptance-criteria.validated_at = <ISO-8601>`.
@@ -168,6 +177,7 @@ Requisitos (todos obligatorios):
    - `task.lifecycle.phases.phase-0-acceptance-criteria.validated_at` no nulo
    - `task.phase.updated_at` no nulo
 10. Las 5 preguntas obligatorias fueron realizadas y respondidas por el desarrollador.
+11. **Gobernanza verificada**: El historial de logs muestra la secuencia de herramientas MCP definida en `skill.runtime-governance`.
 
 Si Gate FAIL:
 - Ejecutar **FAIL**.

package/dist/agent/workflows/tasklifecycle-long/phase-1-research.md

@@ -25,6 +25,7 @@ blocking: true
 > **Constitución activa (OBLIGATORIO)**:
 > - Cargar `constitution.clean_code` antes de iniciar
 > - Cargar `constitution.agents_behavior` (sección 7: Gates, sección 8: Constitución)
+> - **Activar `skill.runtime-governance`** (Para validación de gate y trazabilidad)
 
 ## Output (REQUIRED)
 - Research report (obligatorio, generado por researcher-agent):
@@ -149,6 +150,7 @@ Requisitos (todos obligatorios):
    - `task.lifecycle.phases.phase-1-research.completed == true`
    - `task.lifecycle.phases.phase-1-research.validated_at` no nulo
    - `task.phase.updated_at` no nulo
+6. **Gobernanza verificada**: El historial de logs muestra la secuencia de herramientas MCP definida en `skill.runtime-governance`.
 
 Si Gate FAIL:
 - Ejecutar **Paso 8 (FAIL)**.

package/dist/agent/workflows/tasklifecycle-short/short-phase-1-brief.md

@@ -19,6 +19,7 @@ blocking: true
 > **Constitución activa (OBLIGATORIO)**:
 > - Cargar `constitution.clean_code` antes de iniciar
 > - Cargar `constitution.agents_behavior` (sección 7: Gates, sección 8: Constitución)
+> - **Activar `skill.runtime-governance`** (Para validación de gate y trazabilidad por el Architect)
 
 ## Output (REQUIRED)
 - Artefacto: `.agent/artifacts/<taskId>-<taskTitle>/brief.md`
@@ -102,6 +103,7 @@ Requisitos (todos obligatorios):
    - `task.lifecycle.phases.short-phase-1-brief.completed == true`
    - `task.lifecycle.phases.short-phase-1-brief.validated_at` no nulo
    - `task.phase.updated_at` no nulo
+8. **Gobernanza verificada**: El historial de logs muestra la secuencia de herramientas MCP definida en `skill.runtime-governance`.
 
 Si Gate FAIL:
 - Indicar qué requisito falta.

package/dist/cli/commands/create.js

@@ -9,13 +9,19 @@ import { resolveCorePath, resolveInstalledCorePath } from '../../infrastructure/
 export async function performCreate(type, name, force = false) {
     const cwd = process.cwd();
     const agentDir = path.join(cwd, '.agent');
-    const typeFolder = type === 'role' ? 'rules/roles' : type === 'workflow' ? 'workflows' : 'tools';
+    const typeFolder = type === 'role' ? 'rules/roles' :
+        type === 'workflow' ? 'workflows' :
+            type === 'skill' ? `skills/${name}` :
+                'tools';
     const targetDir = path.join(agentDir, typeFolder);
-    const targetPath = path.join(targetDir, `${name}.md`);
+    const targetPath = type === 'skill' ? path.join(targetDir, 'SKILL.md') : path.join(targetDir, `${name}.md`);
     try {
         const corePath = (await resolveInstalledCorePath(cwd)) ?? await resolveCorePath();
-        const coreTypeFolder = type === 'role' ? 'rules/roles' : type === 'workflow' ? 'workflows' : 'templates';
-        const reservedPath = path.join(corePath, coreTypeFolder, `${name}.md`);
+        const coreTypeFolder = type === 'role' ? 'rules/roles' :
+            type === 'workflow' ? 'workflows' :
+                type === 'skill' ? 'skills' :
+                    'templates';
+        const reservedPath = type === 'skill' ? path.join(corePath, coreTypeFolder, name) : path.join(corePath, coreTypeFolder, `${name}.md`);
         // 1. Reserved Namespace Check
         try {
             await fs.access(reservedPath);
@@ -80,6 +86,25 @@ severity: RECOMMENDED
 
 ## Output (REQUIRED)
 - Expected result
+`;
+        }
+        else if (type === 'skill') {
+            content = `# SKILL: ${name}
+
+> [!NOTE]
+> Define the identity and rules for this system skill.
+
+## Objective
+Explain what this skill enables the agent to do.
+
+## 1. Capabilities
+- (List technical capabilities here)
+
+## 2. Execution Rules
+1. (Add mandatory rules for using this skill)
+
+## 3. Best Practices
+- (Add usage recommendations)
 `;
         }
         await fs.writeFile(targetPath, content);

package/dist/cli/commands/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/cli/commands/create.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/cli/commands/create.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/mcp.js

@@ -1,5 +1,11 @@
 import { startRuntimeMcpServer } from '../../runtime/mcp/server.js';
+import { checkMcpRegistration } from './register-mcp.js';
+import { Logger } from '../../runtime/engine/logger.js';
 export async function mcpCommand() {
+    const registration = await checkMcpRegistration();
+    if (!registration.antigravity && !registration.codex) {
+        Logger.warn('MCP', 'Server not registered in any MCP client. Run: agentic-workflow register-mcp');
+    }
     await startRuntimeMcpServer();
 }
 //# sourceMappingURL=mcp.js.map

package/dist/cli/commands/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/cli/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,qBAAqB,EAAE,CAAC;AAChC,CAAC"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/cli/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,YAAY,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAElD,IAAI,CAAC,YAAY,CAAC,WAAW,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,6EAA6E,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,qBAAqB,EAAE,CAAC;AAChC,CAAC"}