@christianmaf80/agentic-workflow 1.8.0-beta.1 → 1.11.0-beta.1

package/dist/skills/extensio-create-driver/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: Extensio Create Driver
+description: Skill para crear drivers Extensio con adaptadores multi-browser usando extensio-cli
+---
+
+# Extensio Create Driver
+
+## 📋 Input
+
+- **Nombre del driver** (lowercase, alphanumeric, hyphens)
+- **Configuración**:
+  - `platforms`: Plataformas (chrome, firefox, safari, common)
+  - `includeDemo`: Incluir carpeta demo
+  - `testType`: Tipo de tests (vitest, playwright, none)
+
+## 🎯 Output
+
+- **Driver creado** en `packages/drivers/{name}/`:
+  - `src/{platform}/index.mts` para cada plataforma
+  - `src/common/index.mts` (común a todos)
+  - `demo/` (si includeDemo)
+  - `package.json`, `tsconfig.json`
+  
+## 🛠️ Tool
+
+**MCP Tool**: `mcp_extensio-cli_extensio_create`
+
+**Parámetros**:
+```typescript
+{
+  type: "driver",
+  name: string,                    // Nombre del driver
+  platforms?: string,              // "chrome,firefox,safari,common"
+  includeDemo?: boolean,           // Default: false
+  testType?: "vitest" | "playwright" | "none",
+  targetPath?: string              // Default: "packages/drivers"
+}
+```
+
+---
+
+## Ejecución del Tool
+
+### Caso 1: Driver básico (todas las plataformas)
+```typescript
+await mcp_extensio-cli_extensio_create({
+  type: "driver",
+  name: "my-driver",
+  platforms: "chrome,firefox,safari,common"
+});
+```
+
+### Caso 2: Driver con demo y tests
+```typescript
+await mcp_extensio-cli_extensio_create({
+  type: "driver",
+  name: "my-driver",
+  platforms: "chrome,common",
+  includeDemo: true,
+  testType: "vitest"
+});
+```
+
+---
+
+## Validación Pre-Creación
+
+```javascript
+// Verificar nombre válido
+const isValidName = /^[a-z0-9-]+$/.test(name);
+if (!isValidName) {
+  throw new Error('Nombre inválido: solo lowercase, números y guiones');
+}
+
+// Verificar que no existe
+if (existsSync(`packages/drivers/${name}`)) {
+  throw new Error(`El driver ${name} ya existe`);
+}
+```
+
+---
+
+## Post-Creación
+
+Después de crear el driver:
+
+1. **Build**: `cd packages/drivers/{name} && npm run build`
+2. **Test**: `npm run test` (si testType !== "none")
+3. **Demo**: Cargar `demo/` en navegador (si includeDemo)

package/dist/skills/extensio-create-module/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: Extensio Create Module
+description: Skill para crear módulos Extensio con Engine, Pages y Shards usando extensio-cli
+---
+
+# Extensio Create Module
+
+## 📋 Input
+
+- **Nombre del módulo** (lowercase, alphanumeric, hyphens)
+- **Opciones de scaffold**:
+  - `withPages`: Incluir Surface Pages
+  - `withShards`: Incluir Shards
+  - `inheritsCore`: Heredar de @extensio/core
+  - `includeDemo`: Incluir carpeta demo
+
+## 🎯 Output
+
+- **Módulo creado** en `packages/modules/{name}/`:
+  - `src/engine/index.mts`
+  - `src/surface/pages/` (si withPages)
+  - `src/surface/shards/` (si withShards)
+  - `demo/` (si includeDemo)
+  - `package.json`, `tsconfig.json`, `manifest.json`
+  
+## 🛠️ Tool
+
+**MCP Tool**: `mcp_extensio-cli_extensio_create`
+
+**Parámetros**:
+```typescript
+{
+  type: "module",
+  name: string,                    // Nombre del módulo
+  withPages?: boolean,             // Default: false
+  withShards?: boolean,            // Default: false
+  inheritsCore?: boolean,          // Default: true
+  includeDemo?: boolean,           // Default: false
+  targetPath?: string              // Default: "packages/modules"
+}
+```
+
+---
+
+## Ejecución del Tool
+
+### Caso 1: Módulo básico
+```typescript
+await mcp_extensio-cli_extensio_create({
+  type: "module",
+  name: "my-module"
+});
+```
+
+### Caso 2: Módulo completo con UI
+```typescript
+await mcp_extensio-cli_extensio_create({
+  type: "module",
+  name: "my-module",
+  withPages: true,
+  withShards: true,
+  includeDemo: true
+});
+```
+
+---
+
+## Validación Pre-Creación
+
+```javascript
+// Verificar nombre válido
+const isValidName = /^[a-z0-9-]+$/.test(name);
+if (!isValidName) {
+  throw new Error('Nombre inválido: solo lowercase, números y guiones');
+}
+
+// Verificar que no existe
+if (existsSync(`packages/modules/${name}`)) {
+  throw new Error(`El módulo ${name} ya existe`);
+}
+```
+
+---
+
+## Post-Creación
+
+Después de crear el módulo:
+
+1. **Build**: `cd packages/modules/{name} && npm run build`
+2. **Test**: `npm run test` (si tiene tests)
+3. **Demo**: `npm run demo` (si includeDemo)

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

@@ -0,0 +1,84 @@
+---
+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

@@ -0,0 +1,96 @@
+---
+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

@@ -0,0 +1,262 @@
+---
+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

@@ -0,0 +1,79 @@
+---
+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