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

package/dist/skills/extensio-demo/SKILL.md

@@ -1,84 +0,0 @@
----
-name: Extensio Demo
-description: Skill para crear scaffolding de demo para módulos y drivers existentes
----
-
-# Extensio Demo
-
-## 📋 Input
-
-- **Módulo o driver existente** en el proyecto
-- **Tipo**: "module" o "driver"
-- **Nombre**: Nombre del módulo/driver
-
-## 🎯 Output
-
-- **Demo creada** en `packages/{type}/{name}/demo/`:
-  - `src/engine/index.mts` (usa el módulo/driver)
-  - `src/surface/pages/` (páginas demo)
-  - `src/surface/shards/` (shards demo)
-  - `test/e2e/` (tests E2E)
-  - `manifest.json`, `package.json`
-  
-## 🛠️ Tool
-
-**MCP Tool**: `mcp_extensio-cli_extensio_demo`
-
-**Parámetros**:
-```typescript
-{
-  type: "module" | "driver",
-  name: string,                    // Nombre del módulo/driver
-  targetPath?: string              // Override base path
-}
-```
-
----
-
-## Ejecución del Tool
-
-### Caso 1: Demo para módulo
-```typescript
-await mcp_extensio-cli_extensio_demo({
-  type: "module",
-  name: "my-module"
-});
-```
-
-### Caso 2: Demo para driver
-```typescript
-await mcp_extensio-cli_extensio_demo({
-  type: "driver",
-  name: "my-driver"
-});
-```
-
----
-
-## Validación Pre-Creación
-
-```javascript
-// Verificar que el módulo/driver existe
-const basePath = type === "module" 
-  ? "packages/modules" 
-  : "packages/drivers";
-
-if (!existsSync(`${basePath}/${name}`)) {
-  throw new Error(`${type} ${name} no existe`);
-}
-
-// Verificar que no existe demo
-if (existsSync(`${basePath}/${name}/demo`)) {
-  throw new Error(`Demo para ${name} ya existe`);
-}
-```
-
----
-
-## Post-Creación
-
-Después de crear la demo:
-
-1. **Build demo**: `cd {basePath}/{name}/demo && npm run build`
-2. **Test E2E**: `npm run test:e2e`
-3. **Cargar manualmente**: Cargar `dist/chrome` en navegador

package/dist/skills/extensio-test/SKILL.md

@@ -1,96 +0,0 @@
----
-name: Extensio Test
-description: Skill para ejecutar tests unitarios, integración y E2E en proyectos Extensio
----
-
-# Extensio Test
-
-## 📋 Input
-
-- **Proyecto con tests** configurados:
-  - Vitest para unit/integration
-  - Playwright para E2E
-- **Tipo de test** a ejecutar
-- **Opciones**:
-  - `coverage`: Generar reporte de cobertura
-  - `watch`: Modo watch
-  - `browsers`: Para E2E (chromium, firefox, safari)
-  - `headless`: Modo headless para E2E
-
-## 🎯 Output
-
-- **Resultados de tests**:
-  - Pass/Fail por test
-  - Coverage report (si coverage=true)
-  - Playwright HTML report (si E2E)
-  
-## 🛠️ Tool
-
-**MCP Tool**: `mcp_extensio-cli_extensio_test`
-
-**Parámetros**:
-```typescript
-{
-  type: "unit" | "integration" | "e2e" | "all",
-  coverage?: boolean,              // Default: false
-  watch?: boolean,                 // Default: false
-  browsers?: string,               // "chromium,firefox,safari"
-  headless?: boolean               // Default: true
-}
-```
-
----
-
-## Ejecución del Tool
-
-### Caso 1: Tests unitarios
-```typescript
-await mcp_extensio-cli_extensio_test({
-  type: "unit"
-});
-```
-
-### Caso 2: Tests E2E en Chrome
-```typescript
-await mcp_extensio-cli_extensio_test({
-  type: "e2e",
-  browsers: "chromium",
-  headless: false
-});
-```
-
-### Caso 3: Todos los tests con coverage
-```typescript
-await mcp_extensio-cli_extensio_test({
-  type: "all",
-  coverage: true
-});
-```
-
----
-
-## Validación Pre-Test
-
-```javascript
-// Verificar configuración de tests
-const hasVitest = existsSync('vitest.config.mts');
-const hasPlaywright = existsSync('playwright.config.ts');
-
-if (type === "unit" && !hasVitest) {
-  throw new Error('Falta vitest.config.mts');
-}
-
-if (type === "e2e" && !hasPlaywright) {
-  throw new Error('Falta playwright.config.ts');
-}
-```
-
----
-
-## Post-Test
-
-Después de ejecutar tests:
-
-1. **Revisar coverage**: Si coverage=true, revisar `coverage/index.html`
-2. **Revisar E2E report**: Si E2E, revisar `playwright-report/index.html`
-3. **Arreglar fallos**: Iterar sobre tests fallidos

package/dist/skills/extensio-validate-code/SKILL.md

@@ -1,262 +0,0 @@
----
-name: Extensio Validate Code
-description: Skill para validar código TypeScript y ESLint, detectando errores antes de commit
----
-
-# Extensio Validate Code
-
-## 📋 Input
-
-- **Proyecto con código TypeScript**:
-  - `tsconfig.json` configurado
-  - `.eslintrc` (opcional pero recomendado)
-- **Scope de validación**:
-  - Proyecto completo
-  - Archivos específicos
-  - Solo archivos modificados
-
-## 🎯 Output
-
-- **Reporte de validación**:
-  - Errores de TypeScript (type errors)
-  - Warnings/Errores de ESLint
-  - Lista de archivos con problemas
-  - Exit code (0 = ok, 1 = errores)
-  
-## 🛠️ Tool
-
-**Comando Terminal**: No hay MCP tool específico, usar `run_command`
-
-### Validación TypeScript
-```bash
-npx tsc --noEmit
-```
-
-### Validación ESLint
-```bash
-npx eslint . --ext .ts,.mts,.tsx
-```
-
-### Validación Completa (ambos)
-```bash
-npx tsc --noEmit && npx eslint . --ext .ts,.mts,.tsx
-```
-
----
-
-## Ejecución del Skill
-
-### Caso 1: Validar TypeScript solo
-```typescript
-await run_command({
-  CommandLine: "npx tsc --noEmit",
-  Cwd: projectPath,
-  SafeToAutoRun: true,
-  WaitMsBeforeAsync: 10000
-});
-
-// Verificar exit code
-if (exitCode !== 0) {
-  // Hay errores de TypeScript
-  console.error("TypeScript validation failed");
-}
-```
-
-### Caso 2: Validar ESLint solo
-```typescript
-await run_command({
-  CommandLine: "npx eslint . --ext .ts,.mts,.tsx",
-  Cwd: projectPath,
-  SafeToAutoRun: true,
-  WaitMsBeforeAsync: 10000
-});
-```
-
-### Caso 3: Validación completa (TypeScript + ESLint)
-```typescript
-await run_command({
-  CommandLine: "npx tsc --noEmit && npx eslint . --ext .ts,.mts,.tsx",
-  Cwd: projectPath,
-  SafeToAutoRun: true,
-  WaitMsBeforeAsync: 15000
-});
-```
-
-### Caso 4: Validar solo archivos modificados (Git)
-```typescript
-// Obtener archivos modificados
-await run_command({
-  CommandLine: "git diff --name-only --diff-filter=ACMR | grep -E '\\.(ts|mts|tsx)$' | xargs npx eslint",
-  Cwd: projectPath,
-  SafeToAutoRun: true,
-  WaitMsBeforeAsync: 10000
-});
-```
-
----
-
-## Pre-Validación
-
-Antes de ejecutar, verificar:
-
-```javascript
-// Verificar que existe tsconfig.json
-const hasTsConfig = existsSync('tsconfig.json');
-if (!hasTsConfig && validateTypeScript) {
-  throw new Error('tsconfig.json not found');
-}
-
-// Verificar que existe .eslintrc (opcional)
-const hasEslint = existsSync('.eslintrc.json') || 
-                  existsSync('.eslintrc.js') ||
-                  existsSync('.eslintrc.cjs');
-```
-
----
-
-## Interpretación de Resultados
-
-### TypeScript (tsc --noEmit)
-
-**Exit code 0**: ✅ Sin errores
-```
-No output = success
-```
-
-**Exit code 1**: ❌ Hay errores
-```
-src/engine/index.mts:25:5 - error TS2322: Type 'string' is not assignable to type 'number'.
-```
-
-### ESLint
-
-**Exit code 0**: ✅ Sin errores/warnings (o solo warnings si configurado así)
-
-**Exit code 1**: ❌ Hay errores
-```
-/path/to/file.ts
-  10:5  error  'variable' is never reassigned. Use 'const' instead  prefer-const
-```
-
----
-
-## Estrategia por Contexto
-
-### Pre-Commit (antes de commit)
-```bash
-# Solo archivos staged
-git diff --cached --name-only --diff-filter=ACMR | grep -E '\.(ts|mts|tsx)$' | xargs npx tsc --noEmit --skipLibCheck
-```
-
-### Pre-Push (antes de push)
-```bash
-# Validación completa
-npx tsc --noEmit && npx eslint . --ext .ts,.mts,.tsx
-```
-
-### CI/CD (integración continua)
-```bash
-# Validación estricta con warnings como errores
-npx tsc --noEmit && npx eslint . --ext .ts,.mts,.tsx --max-warnings 0
-```
-
-### Durante desarrollo
-```bash
-# Solo archivos modificados desde main
-git diff main --name-only | grep -E '\.(ts|mts|tsx)$' | xargs npx eslint
-```
-
----
-
-## Flags Útiles
-
-### TypeScript (tsc)
-- `--noEmit`: No generar archivos, solo validar
-- `--skipLibCheck`: Saltar validación de archivos .d.ts (más rápido)
-- `--pretty`: Output con colores (mejor legibilidad)
-
-### ESLint
-- `--ext .ts,.mts,.tsx`: Extensiones a validar
-- `--max-warnings 0`: Tratar warnings como errores
-- `--fix`: Auto-fix de problemas corregibles
-- `--quiet`: Solo mostrar errores, no warnings
-
----
-
-## Troubleshooting
-
-| Problema | Causa | Solución |
-|----------|-------|----------|
-| "Cannot find module" | Falta `npm install` | Ejecutar `npm install` primero |
-| "tsc: command not found" | TypeScript no instalado | `npm install -D typescript` |
-| "eslint: command not found" | ESLint no instalado | `npm install -D eslint` |
-| Muchos errores en node_modules | No está excluido | Verificar `tsconfig.json` exclude |
-
----
-
-## Checklist de Calidad
-
-Antes de considerar el código válido:
-
-- [ ] `npx tsc --noEmit` completa con exit code 0
-- [ ] `npx eslint . --ext .ts,.mts,.tsx` completa con exit code 0
-- [ ] No hay warnings críticos sin justificar
-- [ ] Imports están organizados y correctos
-- [ ] No hay código comentado sin razón
-
----
-
-## Integración con Workflows
-
-### En Phase 4 (Implementation)
-```markdown
-Antes de crear architect/review.md:
-1. architect-agent usa skill `extensio_validate_code`
-2. Si hay errores → corregir antes de continuar
-3. Solo con validación ✅ → proceder a review
-```
-
-### En Phase 5 (Verification)
-```markdown
-Antes de ejecutar tests:
-1. qa-agent usa skill `extensio_validate_code`
-2. Validar que tests no tienen errores de TypeScript/lint
-3. Solo con validación ✅ → ejecutar tests
-```
-
----
-
-## Ejemplo de Uso Completo
-
-```typescript
-// 1. Validar TypeScript
-const tsResult = await run_command({
-  CommandLine: "npx tsc --noEmit",
-  Cwd: "/path/to/project",
-  SafeToAutoRun: true,
-  WaitMsBeforeAsync: 10000
-});
-
-if (tsResult.exitCode !== 0) {
-  console.error("TypeScript errors found:");
-  console.error(tsResult.stderr);
-  throw new Error("Fix TypeScript errors before continuing");
-}
-
-// 2. Validar ESLint
-const lintResult = await run_command({
-  CommandLine: "npx eslint . --ext .ts,.mts,.tsx",
-  Cwd: "/path/to/project",
-  SafeToAutoRun: true,
-  WaitMsBeforeAsync: 10000
-});
-
-if (lintResult.exitCode !== 0) {
-  console.error("ESLint errors found:");
-  console.error(lintResult.stdout);
-  throw new Error("Fix ESLint errors before continuing");
-}
-
-// 3. Todo OK
-console.log("✅ Code validation passed");
-```

package/dist/skills/index.md

@@ -1,79 +0,0 @@
----
-domain: skills
-type: index
-version: 1.0.0
----
-
-# INDEX — Skills
-
-## Objetivo
-Este fichero enumera todos los **skills operativos** disponibles en el proyecto Extensio.
-Los skills son capacidades accionables que los agentes pueden usar para ejecutar tareas específicas.
-
----
-
-## Aliases (YAML)
-
-```yaml
-skills:
-  extensio_build:
-    path: .agent/skills/extensio-build/SKILL.md
-    tool: mcp_extensio-cli_extensio_build
-    description: Compila proyectos Extensio para navegadores usando extensio-cli
-    
-  extensio_create_module:
-    path: .agent/skills/extensio-create-module/SKILL.md
-    tool: mcp_extensio-cli_extensio_create
-    description: Crea módulos con Engine, Surface Pages y Shards
-    
-  extensio_create_driver:
-    path: .agent/skills/extensio-create-driver/SKILL.md
-    tool: mcp_extensio-cli_extensio_create
-    description: Crea drivers con adaptadores multi-browser
-    
-  extensio_test:
-    path: .agent/skills/extensio-test/SKILL.md
-    tool: mcp_extensio-cli_extensio_test
-    description: Ejecuta tests unitarios, integración y E2E con coverage
-    
-  extensio_demo:
-    path: .agent/skills/extensio-demo/SKILL.md
-    tool: mcp_extensio-cli_extensio_demo
-    description: Genera scaffolding de demo para módulos y drivers
-    
-  extensio_validate_code:
-    path: .agent/skills/extensio-validate-code/SKILL.md
-    tool: run_command
-    description: Valida código TypeScript y ESLint, detecta errores antes de commit
-```
-
----
-
-## Reglas de Uso
-
-1. **Referenciar por alias**: Usar `skills.extensio_build` en workflows/reglas
-2. **Leer antes de usar**: Cada skill tiene Input/Output/Tool documentados
-3. **Agentes como capacidades**: Los roles listan skills disponibles
-4. **Sin dueño**: Los skills son recursos compartidos sin owner
-
----
-
-## Uso en Roles
-
-Ejemplo en `.agent/rules/roles/architect.md`:
-```yaml
-capabilities:
-  skills:
-    - extensio_build
-    - extensio_create_module
-    - extensio_create_driver
-```
-
----
-
-## Convenciones
-
-- Cada skill DEBE tener sección **Input** (qué necesita)
-- Cada skill DEBE tener sección **Output** (qué produce)
-- Cada skill DEBE tener sección **Tool** (qué MCP tool usar)
-- Prefijo `extensio_` para todos los skills del framework

package/dist/templates/driver-create.md

@@ -1,116 +0,0 @@
----
-artifact: driver_create
-owner: driver-agent
-status: draft | approved
-related_task: <taskId>-<taskTitle>
----
-
-# Driver Creation Report — <taskId>-<taskTitle>
-
-## Identificacion del agente (OBLIGATORIA)
-Primera linea del documento:
-`<icono> **<nombre-agente>**: <mensaje>`
-
-## 1. Resumen ejecutivo
-- Driver creado
-- Motivo de creacion (referencia al plan)
-- Estado actual
-
----
-
-## 2. Alcance y requisitos
-- Requisitos funcionales del driver
-- APIs objetivo (Web APIs / WebExtensions)
-- Navegadores target
-
----
-
-## 2.5 Reasoning (OBLIGATORIO)
-
-> [!IMPORTANT]
-> El agente **DEBE** completar esta sección ANTES de ejecutar.
-
-### Análisis del objetivo
-- ¿Qué se pide exactamente?
-- ¿Hay ambigüedades o dependencias?
-
-### Opciones consideradas
-- **Opción A**: (descripción)
-- **Opción B**: (descripción)
-
-### Decisión tomada
-- Opción elegida y justificación
-
----
-
-## 3. Estructura creada
-- `src/index.mts`
-- `src/__BROWSER__/index.mts`
-- `src/types.d.mts`
-- `src/constants.mts`
-- `src/common/index.mts` (si aplica)
-- `demo/` (si aplica)
-
----
-
-## 4. Types (aislamiento y namespace)
-- Tipos locales definidos
-- Sin imports de otros drivers
-- Namespace Extensio (si aplica)
-
----
-
-## 5. Constants
-- Enumeraciones creadas en `constants.mts`
-- Tipos derivados de constants
-- Sin consumo de constants de otros drivers
-
----
-
-## 6. Wrapper y browser implementations
-- Wrapper estable y documentado
-- Implementaciones por navegador
-- Diferencias manejadas en `__BROWSER__`
-
----
-
-## 7. Compatibilidad y riesgos
-- Tabla de compatibilidad
-- Riesgos detectados
-- Mitigaciones
-
----
-
-## 8. Integracion en el ecosistema
-- Exports/aliases actualizados
-- Referencias en globals/constants del proyecto (si aplica)
-- Documentacion actualizada
-
----
-
-## 9. Auditoria previa al architect-agent
-- Checklist de constitucion de drivers
-- Hallazgos
-- Estado: ☐ APROBADO ☐ RECHAZADO
-
----
-
-## 10. Evidencias
-- Archivos creados
-- Cambios clave
-- Referencias
-
----
-
-## 11. Aprobacion del desarrollador (OBLIGATORIA)
-```yaml
-approval:
-  developer:
-    decision: SI | NO
-    date: <ISO-8601>
-    comments: <opcional>
-```
-
-### Checklist gate (OBLIGATORIO)
-- [ ] Aprobacion por consola registrada en este informe
-- [ ] Fecha y comentario completados (si aplica)

package/dist/templates/driver-delete.md

@@ -1,84 +0,0 @@
----
-artifact: driver_delete
-owner: driver-agent
-status: draft | approved
-related_task: <taskId>-<taskTitle>
----
-
-# Driver Deletion Report — <taskId>-<taskTitle>
-
-## Identificacion del agente (OBLIGATORIA)
-Primera linea del documento:
-`<icono> **<nombre-agente>**: <mensaje>`
-
-## 1. Resumen ejecutivo
-- Driver eliminado
-- Motivo de eliminacion (referencia al plan)
-- Estado actual
-
----
-
-## 2. Alcance de la eliminacion
-- Componentes removidos
-- Dependencias afectadas
-- Riesgos
-
----
-
-## 2.5 Reasoning (OBLIGATORIO)
-
-> [!IMPORTANT]
-> El agente **DEBE** completar esta sección ANTES de ejecutar.
-
-### Análisis del objetivo
-- ¿Qué se pide exactamente?
-- ¿Hay ambigüedades o dependencias?
-
-### Opciones consideradas
-- **Opción A**: (descripción)
-- **Opción B**: (descripción)
-
-### Decisión tomada
-- Opción elegida y justificación
-
----
-
-## 3. Limpieza de referencias
-- Imports eliminados
-- Docs actualizadas
-- Tests actualizados/eliminados
-
----
-
-## 4. Integracion en globals y constantes
-- Cambios en `globals.d.mts`
-- Cambios en `constants.mts` (root)
-- Verificacion de duplicados
-
----
-
-## 5. Evidencias
-- Archivos eliminados
-- Cambios clave
-
----
-
-## 6. Auditoria previa al architect-agent
-- Checklist de integridad
-- Hallazgos
-- Estado: ☐ APROBADO ☐ RECHAZADO
-
----
-
-## 7. Aprobacion del desarrollador (OBLIGATORIA)
-```yaml
-approval:
-  developer:
-    decision: SI | NO
-    date: <ISO-8601>
-    comments: <opcional>
-```
-
-### Checklist gate (OBLIGATORIO)
-- [ ] Aprobacion por consola registrada en este informe
-- [ ] Fecha y comentario completados (si aplica)