javi-forge 1.1.0 → 1.3.0

package/dist/lib/docker.js

@@ -0,0 +1,223 @@
+import { execFile, spawn } from 'child_process';
+import { promisify } from 'util';
+import crypto from 'crypto';
+import fs from 'fs-extra';
+import path from 'path';
+const execFileAsync = promisify(execFile);
+// =============================================================================
+// Image name
+// =============================================================================
+export function getImageName(stack) {
+    return `javi-forge-ci-${stack}`;
+}
+// =============================================================================
+// Dockerfile content per stack
+// =============================================================================
+export function getDockerfileContent(stack) {
+    switch (stack) {
+        case 'java-gradle':
+        case 'java-maven':
+            return [
+                'ARG JAVA_VERSION=21',
+                'FROM eclipse-temurin:${JAVA_VERSION}-jdk-noble',
+                'RUN apt-get update && apt-get install -y git curl unzip && rm -rf /var/lib/apt/lists/*',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        case 'node':
+            return [
+                'FROM node:22-slim',
+                'RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*',
+                'RUN npm install -g pnpm',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        case 'python':
+            return [
+                'FROM python:3.12-slim',
+                'RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*',
+                'RUN pip install --no-cache-dir pytest ruff pylint poetry',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        case 'go':
+            return [
+                'FROM golang:1.23-bookworm',
+                'RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*',
+                'RUN go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.62.0 && mv /root/go/bin/golangci-lint /usr/local/bin/',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        case 'rust':
+            return [
+                'FROM rust:1.83-slim',
+                'RUN apt-get update && apt-get install -y git pkg-config libssl-dev && rm -rf /var/lib/apt/lists/*',
+                'RUN rustup component add clippy rustfmt',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        default:
+            return [
+                'FROM ubuntu:24.04',
+                'RUN apt-get update && apt-get install -y git curl && rm -rf /var/lib/apt/lists/*',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+    }
+}
+// =============================================================================
+// Docker availability
+// =============================================================================
+export async function isDockerAvailable() {
+    try {
+        await execFileAsync('docker', ['info'], { timeout: 5000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// =============================================================================
+// Image management
+// =============================================================================
+/**
+ * Ensure a CI Docker image exists and is up-to-date.
+ * Rebuilds only if the Dockerfile content has changed (hash-based staleness check).
+ * Returns the image name.
+ */
+export async function ensureImage(options) {
+    const { stack, javaVersion, dockerfilesDir } = options;
+    const imageName = getImageName(stack);
+    // Resolve Dockerfile path
+    const dockerDir = dockerfilesDir ?? path.join(path.dirname(new URL(import.meta.url).pathname), '../../ci-local/docker');
+    const dockerfilePath = path.join(dockerDir, `${stack}.Dockerfile`);
+    // Write Dockerfile if it doesn't exist yet (first run)
+    if (!await fs.pathExists(dockerfilePath)) {
+        await fs.ensureDir(dockerDir);
+        await fs.writeFile(dockerfilePath, getDockerfileContent(stack), 'utf-8');
+    }
+    // Staleness check: compare Dockerfile hash with the one embedded in the image label
+    const content = await fs.readFile(dockerfilePath, 'utf-8');
+    const currentHash = crypto.createHash('sha256').update(content).digest('hex');
+    let imageHash = '';
+    try {
+        const { stdout } = await execFileAsync('docker', [
+            'inspect', '--format', '{{index .Config.Labels "dockerfile-hash"}}', imageName,
+        ]);
+        imageHash = stdout.trim();
+    }
+    catch {
+        // Image doesn't exist yet
+    }
+    if (currentHash === imageHash) {
+        return imageName;
+    }
+    // Build image
+    const buildArgs = [
+        'build',
+        '--label', `dockerfile-hash=${currentHash}`,
+        '-f', dockerfilePath,
+        '-t', imageName,
+    ];
+    if (javaVersion && (stack === 'java-gradle' || stack === 'java-maven')) {
+        buildArgs.push('--build-arg', `JAVA_VERSION=${javaVersion}`);
+    }
+    buildArgs.push(dockerDir);
+    await new Promise((resolve, reject) => {
+        const proc = spawn('docker', buildArgs, { stdio: 'inherit' });
+        proc.on('close', code => code === 0 ? resolve() : reject(new Error(`docker build exited with code ${code}`)));
+        proc.on('error', reject);
+    });
+    return imageName;
+}
+// =============================================================================
+// Run command in container
+// =============================================================================
+/**
+ * Run a shell command inside the CI Docker container.
+ * Mounts projectDir as /home/runner/work.
+ * Streams output to process.stdout/stderr by default.
+ */
+export async function runInContainer(options) {
+    const { projectDir, command, timeout = 600, stream = true } = options;
+    const stack = await detectStackFromDir(projectDir);
+    const imageName = getImageName(stack);
+    const isInteractive = process.stdin.isTTY && stream;
+    const dockerArgs = [
+        'run', '--rm',
+        ...(isInteractive ? ['-it'] : []),
+        '--stop-timeout', '30',
+        '--entrypoint', '',
+        '-v', `${projectDir}:/home/runner/work`,
+        '-e', 'CI=true',
+        imageName,
+        'timeout', String(timeout), 'bash', '-c', command,
+    ];
+    return new Promise((resolve, reject) => {
+        const proc = spawn('docker', dockerArgs, {
+            stdio: stream ? 'inherit' : 'pipe',
+        });
+        let stdout = '';
+        let stderr = '';
+        if (!stream) {
+            proc.stdout?.on('data', (d) => { stdout += d.toString(); });
+            proc.stderr?.on('data', (d) => { stderr += d.toString(); });
+        }
+        proc.on('close', code => resolve({ exitCode: code ?? 1, stdout, stderr }));
+        proc.on('error', reject);
+    });
+}
+/**
+ * Open an interactive shell inside the CI container.
+ */
+export async function openShell(projectDir) {
+    const stack = await detectStackFromDir(projectDir);
+    const imageName = getImageName(stack);
+    await new Promise((resolve, reject) => {
+        const proc = spawn('docker', [
+            'run', '--rm', '-it',
+            '--entrypoint', '',
+            '-v', `${projectDir}:/home/runner/work`,
+            '-e', 'CI=true',
+            imageName,
+            'bash', '-c', 'cd /home/runner/work && exec bash',
+        ], { stdio: 'inherit' });
+        proc.on('close', () => resolve());
+        proc.on('error', reject);
+    });
+}
+// =============================================================================
+// Internal helpers
+// =============================================================================
+async function detectStackFromDir(projectDir) {
+    if (await fs.pathExists(path.join(projectDir, 'build.gradle.kts')))
+        return 'java-gradle';
+    if (await fs.pathExists(path.join(projectDir, 'build.gradle')))
+        return 'java-gradle';
+    if (await fs.pathExists(path.join(projectDir, 'pom.xml')))
+        return 'java-maven';
+    if (await fs.pathExists(path.join(projectDir, 'package.json')))
+        return 'node';
+    if (await fs.pathExists(path.join(projectDir, 'go.mod')))
+        return 'go';
+    if (await fs.pathExists(path.join(projectDir, 'Cargo.toml')))
+        return 'rust';
+    if (await fs.pathExists(path.join(projectDir, 'pyproject.toml')) ||
+        await fs.pathExists(path.join(projectDir, 'requirements.txt')) ||
+        await fs.pathExists(path.join(projectDir, 'setup.py')))
+        return 'python';
+    return 'node'; // fallback
+}
+//# sourceMappingURL=docker.js.map

package/dist/ui/CI.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { CIOptions } from '../commands/ci.js';
+interface CIProps extends CIOptions {
+    /** Called when CI finishes (success or failure) */
+    onDone?: (success: boolean) => void;
+}
+export default function CI(props: CIProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=CI.d.ts.map

package/dist/ui/CI.js

@@ -0,0 +1,91 @@
+import React, { useEffect, useState, useRef } from 'react';
+import { Box, Text, useApp } from 'ink';
+import Spinner from 'ink-spinner';
+import { runCI } from '../commands/ci.js';
+import Header from './Header.js';
+import { theme } from './theme.js';
+// =============================================================================
+// Icons
+// =============================================================================
+const STATUS_ICON = {
+    pending: '○',
+    running: '●',
+    done: '✓',
+    error: '✗',
+    skipped: '–',
+};
+const STATUS_COLOR = {
+    pending: theme.muted,
+    running: theme.warning,
+    done: theme.success,
+    error: theme.error,
+    skipped: theme.muted,
+};
+// =============================================================================
+// Component
+// =============================================================================
+export default function CI(props) {
+    const { exit } = useApp();
+    const [steps, setSteps] = useState([]);
+    const [done, setDone] = useState(false);
+    const [success, setSuccess] = useState(null);
+    const started = useRef(false);
+    useEffect(() => {
+        if (started.current)
+            return;
+        started.current = true;
+        const onStep = (step) => {
+            setSteps(prev => {
+                const idx = prev.findIndex(s => s.id === step.id);
+                if (idx >= 0) {
+                    const next = [...prev];
+                    next[idx] = step;
+                    return next;
+                }
+                return [...prev, step];
+            });
+        };
+        runCI(props, onStep)
+            .then(() => {
+            setSuccess(true);
+            setDone(true);
+            props.onDone?.(true);
+            setTimeout(() => exit(), 200);
+        })
+            .catch(() => {
+            setSuccess(false);
+            setDone(true);
+            props.onDone?.(false);
+            // Give user time to read the error before exiting with failure code
+            setTimeout(() => {
+                exit();
+                process.exitCode = 1;
+            }, 300);
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    const mode = props.mode ?? 'full';
+    const subtitle = mode === 'quick' ? 'ci — quick' : mode === 'shell' ? 'ci — shell' : 'ci';
+    return (React.createElement(Box, { flexDirection: "column", padding: 1 },
+        React.createElement(Header, { subtitle: subtitle }),
+        React.createElement(Box, { flexDirection: "column", marginBottom: 1 }, steps.map(step => (React.createElement(Box, { key: step.id },
+            React.createElement(Text, { color: STATUS_COLOR[step.status] },
+                step.status === 'running'
+                    ? React.createElement(Spinner, { type: "dots" })
+                    : `${STATUS_ICON[step.status]} `,
+                step.label,
+                step.detail
+                    ? React.createElement(Text, { color: theme.muted, dimColor: true },
+                        '  ',
+                        step.detail)
+                    : null))))),
+        done && success === true && (React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+            React.createElement(Text, { color: theme.success, bold: true }, "\u2713 CI passed \u2014 safe to push!"))),
+        done && success === false && (React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+            React.createElement(Text, { color: theme.error, bold: true }, "\u2717 CI failed \u2014 fix the issues above before pushing."),
+            React.createElement(Text, { color: theme.muted, dimColor: true }, "  To skip: git push --no-verify"))),
+        !done && steps.length === 0 && (React.createElement(Text, { color: theme.warning },
+            React.createElement(Spinner, { type: "dots" }),
+            ' Starting CI...'))));
+}
+//# sourceMappingURL=CI.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "javi-forge",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Project scaffolding and AI-ready CI bootstrap",
   "type": "module",
   "bin": {
@@ -23,9 +23,14 @@
     "ink-spinner": "^5.0.0",
     "meow": "^14.1.0",
     "react": "^19.2.4",
+    "update-notifier": "^7.3.1",
     "yaml": "^2.8.2"
   },
   "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.6",
     "@stryker-mutator/core": "^9.6.0",
     "@stryker-mutator/typescript-checker": "^9.6.0",
     "@stryker-mutator/vitest-runner": "^9.6.0",
@@ -33,7 +38,10 @@
     "@types/glob": "^9.0.0",
     "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
+    "@types/update-notifier": "^6.0.8",
     "@vitest/coverage-v8": "^4.1.0",
+    "conventional-changelog-conventionalcommits": "^9.3.0",
+    "semantic-release": "^25.0.3",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"

package/ai-config/.skillignore

@@ -1,15 +0,0 @@
-# .skillignore — Exclude skills from sync targets
-#
-# Format:
-#   skill-name           → exclude from ALL targets
-#   target:skill-name    → exclude only from that target
-#   category/skill-name  → use full relative path (no extension, no /SKILL.md)
-#
-# Targets: claude, opencode, cursor, aider, gemini
-#
-# Examples:
-#   cursor:data-ai/onnx-export        # skip heavy ML skill in Cursor
-#   opencode:systems-iot/mqtt-rumqttc # skip IoT skill in OpenCode
-#   references/ai-sdk-5               # skip from all targets
-
-# Add your exclusions below:

package/ai-config/AUTO_INVOKE.md

@@ -1,300 +0,0 @@
-# Auto-Invoke Rules
-
-> Reglas de invocación automática de skills y agentes.
-> **OBLIGATORIO:** Antes de realizar estas acciones, SIEMPRE carga la skill correspondiente.
-
----
-
-## Skill Auto-Invoke Table
-
-| Acción del Usuario | Skill a Cargar | Scope (Carpetas) |
-|--------------------|----------------|------------------|
-| Crear componente React/Astro | `frontend-web` | `src/`, `components/`, `pages/` |
-| Crear componente Mantine UI | `mantine-ui` | `src/`, `components/` |
-| Configurar Astro SSR | `astro-ssr` | `src/`, `astro.config.*` |
-| Data fetching con React Query | `tanstack-query` | `src/`, `hooks/`, `api/` |
-| Validar schemas/forms | `zod-validation` | `src/`, `schemas/`, `validators/` |
-| Estado global Zustand | `zustand-state` | `src/`, `store/`, `stores/` |
-| Crear endpoint Go/Chi | `chi-router` | `cmd/`, `internal/`, `api/` |
-| Queries PostgreSQL con pgx | `pgx-postgres` | `internal/`, `repository/`, `db/` |
-| Backend Go completo | `go-backend` | `cmd/`, `internal/`, `pkg/` |
-| Crear endpoint FastAPI | `fastapi` | `src/`, `app/`, `api/` |
-| Autenticación JWT | `jwt-auth` | `auth/`, `middleware/`, `security/` |
-| Async Rust con Tokio | `tokio-async` | `src/`, `Cargo.toml` |
-| IoT/MQTT messaging | `mqtt-rumqttc` | `src/`, `iot/`, `mqtt/` |
-| Protocolo Modbus | `modbus-protocol` | `src/`, `industrial/`, `modbus/` |
-| WebSockets real-time | `websockets` | `src/`, `ws/`, `realtime/` |
-| Rust systems programming | `rust-systems` | `src/`, `Cargo.toml` |
-| Time-series TimescaleDB | `timescaledb` | `db/`, `migrations/`, `sql/` |
-| Cache Redis | `redis-cache` | `cache/`, `redis/`, `internal/` |
-| SQLite embedded/mobile | `sqlite-embedded` | `db/`, `mobile/`, `offline/` |
-| Analytics DuckDB | `duckdb-analytics` | `analytics/`, `data/`, `scripts/` |
-| Deploy Kubernetes | `kubernetes` | `k8s/`, `deploy/`, `manifests/` |
-| CI/CD DevOps | `devops-infra` | `.github/`, `ci/`, `docker/` |
-| Docker containers | `docker-containers` | `Dockerfile*`, `docker-compose*` |
-| Traefik routing | `traefik-proxy` | `traefik/`, `proxy/`, `ingress/` |
-| Observability/tracing | `opentelemetry` | `observability/`, `telemetry/` |
-| LangChain/LLM apps | `langchain` | `agents/`, `chains/`, `llm/` |
-| AI/ML pipelines | `ai-ml` | `ml/`, `models/`, `training/` |
-| ONNX model inference | `onnx-inference` | `models/`, `inference/`, `onnx/` |
-| PyTorch training | `pytorch` | `training/`, `models/`, `nn/` |
-| Scikit-learn ML | `scikit-learn` | `ml/`, `models/`, `sklearn/` |
-| MLflow experiments | `mlflow` | `experiments/`, `mlruns/`, `mlflow/` |
-| Vector databases/RAG | `vector-db` | `vectorstore/`, `embeddings/`, `rag/` |
-| E2E tests Playwright | `playwright-e2e` | `tests/`, `e2e/`, `playwright/` |
-| Unit tests Vitest | `vitest-testing` | `tests/`, `__tests__/`, `*.test.*` |
-| Mobile Ionic/Capacitor | `mobile-ionic`, `ionic-capacitor` | `src/`, `mobile/`, `capacitor/` |
-| Git workflow/branches | `git-workflow` | `.git/`, root |
-| GitHub API/CLI | `git-github` | `.github/`, root |
-| Technical documentation | `technical-docs` | `docs/`, `*.md` |
-| Power BI reports | `powerbi` | `reports/`, `bi/`, `dashboards/` |
-
----
-
-## Agent Auto-Invoke Table
-
-| Contexto de Trabajo | Agente a Usar | Cuándo |
-|---------------------|---------------|--------|
-| Diseño de APIs | `api-designer` | Crear/diseñar REST, GraphQL, OpenAPI |
-| Arquitectura backend | `backend-architect` | Diseño de servicios, microservicios |
-| Frontend React | `react-pro` | Patterns avanzados React |
-| Frontend Vue | `vue-specialist` | Vue 3, Composition API |
-| Frontend Angular | `angular-expert` | Angular 17+, signals |
-| TypeScript avanzado | `typescript-pro` | Tipos complejos, generics |
-| Go development | `golang-pro` | Concurrencia, patterns Go |
-| Rust systems | `rust-pro` | Memory safety, async Rust |
-| Python development | `python-pro` | Async, type hints, FastAPI |
-| Java/Spring | `java-enterprise` | Spring Boot, JPA |
-| Code review | `code-reviewer` | Revisar PRs, quality checks |
-| Testing strategy | `test-engineer` | Test planning, coverage |
-| E2E testing | `e2e-test-specialist` | Playwright, Cypress |
-| Security audit | `security-auditor` | OWASP, vulnerabilities |
-| Performance | `performance-engineer` | Profiling, optimization |
-| DevOps/CI-CD | `devops-engineer` | Pipelines, containers |
-| Kubernetes | `kubernetes-expert` | K8s troubleshooting |
-| Cloud architecture | `cloud-architect` | AWS, GCP, Azure design |
-| Data engineering | `data-engineer` | ETL, data pipelines |
-| ML/AI | `ai-engineer` | LLMs, ML production |
-| Data science | `data-scientist` | Statistics, ML models |
-| Documentation | `technical-writer` | Docs, guides, ADRs |
-
----
-
-## Inventario Completo de Skills
-
-> Incluye **todas** las skills disponibles (auto o manual). Las reglas automáticas siguen siendo las de la tabla anterior.
-
-| Skill | Auto-Invoke | Scope/Notas |
-|-------|------------|------------|
-| `_TEMPLATE` | Manual | Plantilla |
-| `ai-ml` | Manual | General |
-| `analytics-concepts` | Manual | General |
-| `analytics-spring` | Manual | General |
-| `api-documentation` | Manual | General |
-| `api-gateway` | Manual | General |
-| `astro-ssr` | Auto | `src/`, `astro.config.*` |
-| `bff-concepts` | Manual | General |
-| `bff-spring` | Manual | General |
-| `chaos-engineering` | Manual | General |
-| `chaos-spring` | Manual | General |
-| `chi-router` | Auto | `cmd/`, `internal/`, `api/` |
-| `ci-local-guide` | Manual | General |
-| `claude-automation-recommender` | Manual | General |
-| `claude-md-improver` | Manual | General |
-| `devops-infra` | Auto | `.github/`, `ci/`, `docker/` |
-| `docker-containers` | Auto | `Dockerfile*`, `docker-compose*` |
-| `docs-spring` | Manual | General |
-| `duckdb-analytics` | Auto | `analytics/`, `data/`, `scripts/` |
-| `error-handling` | Manual | General |
-| `exceptions-spring` | Manual | General |
-| `fastapi` | Auto | `src/`, `app/`, `api/` |
-| `frontend-design` | Manual | General |
-| `frontend-web` | Auto | `src/`, `components/`, `pages/` |
-| `gateway-spring` | Manual | General |
-| `git-github` | Auto | `.github/`, root |
-| `git-workflow` | Auto | `.git/`, root |
-| `go-backend` | Auto | `cmd/`, `internal/`, `pkg/` |
-| `gradle-multimodule` | Manual | General |
-| `graph-databases` | Manual | General |
-| `graph-spring` | Manual | General |
-| `graphql-concepts` | Manual | General |
-| `graphql-spring` | Manual | General |
-| `grpc-concepts` | Manual | General |
-| `grpc-spring` | Manual | General |
-| `ide-plugins` | Manual | General |
-| `ide-plugins-intellij` | Manual | General |
-| `ionic-capacitor` | Auto | `src/`, `mobile/`, `capacitor/` |
-| `jwt-auth` | Auto | `auth/`, `middleware/`, `security/` |
-| `kubernetes` | Auto | `k8s/`, `deploy/`, `manifests/` |
-| `langchain` | Auto | `agents/`, `chains/`, `llm/` |
-| `mantine-ui` | Auto | `src/`, `components/` |
-| `mlflow` | Manual | General |
-| `mobile-ionic` | Auto | `src/`, `mobile/`, `capacitor/` |
-| `modbus-protocol` | Auto | `src/`, `industrial/`, `modbus/` |
-| `mqtt-rumqttc` | Auto | `src/`, `iot/`, `mqtt/` |
-| `mustache-templates` | Manual | General |
-| `notifications-concepts` | Manual | General |
-| `onnx-inference` | Auto | `models/`, `inference/`, `onnx/` |
-| `opentelemetry` | Auto | `observability/`, `telemetry/` |
-| `pgx-postgres` | Auto | `internal/`, `repository/`, `db/` |
-| `playwright-e2e` | Auto | `tests/`, `e2e/`, `playwright/` |
-| `powerbi` | Auto | `reports/`, `bi/`, `dashboards/` |
-| `pytorch` | Auto | `training/`, `models/`, `nn/` |
-| `recommendations-concepts` | Manual | General |
-| `redis-cache` | Auto | `cache/`, `redis/`, `internal/` |
-| `references/hooks-patterns` | Manual | Referencia |
-| `references/mcp-servers` | Manual | Referencia |
-| `references/plugins-reference` | Manual | Referencia |
-| `references/skills-reference` | Manual | Referencia |
-| `references/subagent-templates` | Manual | Referencia |
-| `rust-systems` | Auto | `src/`, `Cargo.toml` |
-| `scikit-learn` | Auto | `ml/`, `models/`, `sklearn/` |
-| `search-concepts` | Manual | General |
-| `search-spring` | Manual | General |
-| `spring-boot-4` | Manual | General |
-| `sqlite-embedded` | Auto | `db/`, `mobile/`, `offline/` |
-| `tanstack-query` | Auto | `src/`, `hooks/`, `api/` |
-| `technical-docs` | Auto | `docs/`, `*.md` |
-| `testcontainers` | Manual | General |
-| `timescaledb` | Auto | `db/`, `migrations/`, `sql/` |
-| `tokio-async` | Auto | `src/`, `Cargo.toml` |
-| `traefik-proxy` | Auto | `traefik/`, `proxy/`, `ingress/` |
-| `vector-db` | Auto | `vectorstore/`, `embeddings/`, `rag/` |
-| `vitest-testing` | Auto | `tests/`, `__tests__/`, `*.test.*` |
-| `obsidian-brain-workflow` | Manual | `.project/`, `.obsidian/` |
-| `wave-workflow` | Manual | General |
-| `websockets` | Auto | `src/`, `ws/`, `realtime/` |
-| `woodpecker-ci` | Manual | General |
-| `zod-validation` | Auto | `src/`, `schemas/`, `validators/` |
-| `zustand-state` | Auto | `src/`, `store/`, `stores/` |
-
----
-
-## Inventario Completo de Agentes
-
-> Incluye **todos** los agentes disponibles (auto o manual). Las reglas automáticas siguen siendo las de la tabla anterior.
-
-| Agente | Auto-Invoke | Notas |
-|--------|------------|-------|
-| `_TEMPLATE` | Manual | Plantilla |
-| `api-designer` | Auto | Diseño de APIs |
-| `business-analyst` | Manual | Business |
-| `product-strategist` | Manual | Business |
-| `project-manager` | Manual | Business |
-| `requirements-analyst` | Manual | Business |
-| `technical-writer` | Auto | Documentation |
-| `code-reviewer` | Auto | Code review |
-| `code-reviewer-compact` | Manual | Quick review checklist |
-| `ux-designer` | Manual | Creative |
-| `ai-engineer` | Auto | ML/AI |
-| `analytics-engineer` | Manual | Data/AI |
-| `data-engineer` | Auto | Data engineering |
-| `data-scientist` | Auto | Data science |
-| `mlops-engineer` | Manual | Data/AI |
-| `prompt-engineer` | Manual | Data/AI |
-| `angular-expert` | Auto | Frontend Angular |
-| `backend-architect` | Auto | Arquitectura backend |
-| `database-specialist` | Manual | Development |
-| `frontend-specialist` | Manual | Development |
-| `fullstack-engineer` | Manual | Development |
-| `golang-pro` | Auto | Go development |
-| `java-enterprise` | Auto | Java/Spring |
-| `javascript-pro` | Manual | Development |
-| `nextjs-pro` | Manual | Development |
-| `python-pro` | Auto | Python development |
-| `react-pro` | Auto | Frontend React |
-| `rust-pro` | Auto | Rust systems |
-| `typescript-pro` | Auto | TypeScript avanzado |
-| `vue-specialist` | Auto | Frontend Vue |
-| `cloud-architect` | Auto | Cloud architecture |
-| `deployment-manager` | Manual | Infra |
-| `devops-engineer` | Auto | DevOps/CI-CD |
-| `incident-responder` | Manual | Infra |
-| `kubernetes-expert` | Auto | Kubernetes |
-| `monitoring-specialist` | Manual | Infra |
-| `performance-engineer` | Auto | Performance |
-| `orchestrator` | Manual | Orquestación |
-| `accessibility-auditor` | Manual | Quality |
-| `dependency-manager` | Manual | Quality |
-| `e2e-test-specialist` | Auto | E2E testing |
-| `performance-tester` | Manual | Quality |
-| `security-auditor` | Auto | Security audit |
-| `test-engineer` | Auto | Testing strategy |
-| `agent-generator` | Manual | Specialized |
-| `blockchain-developer` | Manual | Specialized |
-| `code-migrator` | Manual | Specialized |
-| `context-manager` | Manual | Specialized |
-| `documentation-writer` | Manual | Specialized |
-| `ecommerce-expert` | Manual | Specialized |
-| `embedded-engineer` | Manual | Specialized |
-| `error-detective` | Manual | Specialized |
-| `fintech-specialist` | Manual | Specialized |
-| `freelance-project-planner` | Manual | Specialized |
-| `freelance-project-planner-v2` | Manual | Specialized |
-| `freelance-project-planner-v3` | Manual | Specialized |
-| `freelance-project-planner-v4` | Manual | Specialized |
-| `game-developer` | Manual | Specialized |
-| `healthcare-dev` | Manual | Specialized |
-| `mobile-developer` | Manual | Specialized |
-| `parallel-plan-executor` | Manual | Specialized |
-| `plan-executor` | Manual | Specialized |
-| `solo-dev-planner-modular/00-INDEX` | Manual | Specialized docs |
-| `solo-dev-planner-modular/01-CORE` | Manual | Specialized docs |
-| `solo-dev-planner-modular/02-SELF-CORRECTION` | Manual | Specialized docs |
-| `solo-dev-planner-modular/03-PROGRESSIVE-SETUP` | Manual | Specialized docs |
-| `solo-dev-planner-modular/04-DEPLOYMENT` | Manual | Specialized docs |
-| `solo-dev-planner-modular/05-TESTING` | Manual | Specialized docs |
-| `solo-dev-planner-modular/06-OPERATIONS` | Manual | Specialized docs |
-| `solo-dev-planner-modular/INSTALL` | Manual | Specialized docs |
-| `solo-dev-planner-modular/README` | Manual | Specialized docs |
-| `solo-dev-planner-modular/solo-dev-planner` | Manual | Specialized docs |
-| `solo-dev-planner-modular/START-HERE` | Manual | Specialized docs |
-| `solo-dev-planner-modular/WORKFLOW-DIAGRAM` | Manual | Specialized docs |
-| `vibekanban-smart-worker` | Manual | Specialized |
-| `workflow-optimizer` | Manual | Specialized |
-| `spring-boot-4-expert` | Manual | Specialized |
-| `template-writer` | Manual | Specialized |
-| `test-runner` | Manual | Specialized |
-| `wave-executor` | Manual | Specialized |
-
-## Reglas de Invocación
-
-### 1. Detección por Carpeta (Scope)
-```
-Si el archivo está en src/components/ → Cargar frontend-web, mantine-ui
-Si el archivo está en internal/api/  → Cargar chi-router, go-backend
-Si el archivo está en k8s/           → Cargar kubernetes, devops-infra
-```
-
-### 2. Detección por Extensión
-```
-*.tsx, *.jsx  → frontend-web, tanstack-query
-*.go          → go-backend, chi-router
-*.rs          → rust-systems, tokio-async
-*.py          → fastapi, ai-ml
-*.yaml (k8s)  → kubernetes
-```
-
-### 3. Detección por Contenido
-```
-import { useQuery }      → tanstack-query
-import { z } from 'zod'  → zod-validation
-from fastapi import      → fastapi
-use tokio::              → tokio-async
-```
-
----
-
-## Ejemplo de Uso
-
-**Usuario:** "Crea un componente de tabla con paginación"
-
-**Proceso del Orquestador:**
-1. Detecta: "componente" → Cargar `frontend-web`
-2. Detecta: "tabla" → Cargar `mantine-ui` (tiene DataTable pattern)
-3. Si hay data fetching → Cargar `tanstack-query`
-4. Ejecutar con contexto de los 3 skills cargados
-
----
-
-*Auto-generado. Mantener sincronizado con skills disponibles.*