@ronaldjdevfs/forge 1.2.0 → 1.3.1

package/skills/forge/scripts/recommendation-engine.mjs

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+import { CYAN, GREEN, RED, YELLOW, BOLD, RESET, DIM, GRAY, SEVERITY_COLORS } from "./formatter.mjs";
+
+function countByRule(violations) {
+  const counts = {};
+  for (const v of violations) {
+    const rule = v.rule || "other";
+    if (!counts[rule]) counts[rule] = [];
+    counts[rule].push(v);
+  }
+  return counts;
+}
+
+export function buildPipeline(auditChecks, graph, ownership, profile, ctx) {
+  const violations = auditChecks.filter(c => !c.pass);
+  const pipeline = [];
+
+  // --- CRITICAL: R2 (platform→feature) → forge temper ---
+  const r2 = violations.filter(v => v.rule === "R2" || (v.fix && v.fix.includes("Extraer interfaz") && v.severity === "CRITICAL"));
+  if (r2.length > 0) {
+    pipeline.push({ command: "temper", args: "", priority: "CRITICAL", reason: `Corrige ${r2.length} violación(es) R2 (platform→feature)`, count: r2.length });
+  }
+
+  // --- ERROR: R3 (shared→feature) → forge reforge ---
+  const r3 = violations.filter(v => v.rule === "R3" || (v.fix && v.fix.includes("Feature no accede")));
+  // --- ERROR: R4 (shared→infra) → forge reforge ---
+  const r4 = violations.filter(v => v.rule === "R4" || (v.fix && v.fix.includes("Feature no importa otro feature")));
+  // --- ERROR: R8 (cross-feature) → forge reforge ---
+  const r8 = violations.filter(v => v.rule === "R8");
+  const sharedIssues = [...r3, ...r4, ...r8];
+  if (sharedIssues.length > 0) {
+    pipeline.push({ command: "reforge", args: "", priority: "ERROR", reason: `Corrige ${sharedIssues.length} violación(es) de capas (shared mal acoplado)`, count: sharedIssues.length });
+  }
+
+  // --- ERROR: R9 (cycles) → forge reforge ---
+  const r9 = violations.filter(v => v.rule === "R9" || (v.label && v.label.includes("Ciclo")));
+  if (r9.length > 0 || (graph && graph.hasCycles)) {
+    pipeline.push({ command: "reforge", args: "--cycles", priority: "ERROR", reason: `Elimina ${r9.length || 1} ciclo(s) de dependencia (R9)`, count: r9.length || 1 });
+  }
+
+  // --- R1 (feature→infra) → forge reforge ---
+  const r1 = violations.filter(v => v.rule === "R1");
+  if (r1.length > 0) {
+    pipeline.push({ command: "reforge", args: "", priority: "ERROR", reason: `Corrige ${r1.length} violación(es) R1 (feature→infra)`, count: r1.length });
+  }
+
+  // --- WARNING: orphan/misplaced → forge relocate ---
+  const orphans = ownership?.orphans || [];
+  const misplaced = ownership?.misplaced || [];
+  const duplicates = ownership?.duplicates || [];
+  const relocationCount = orphans.length + misplaced.length + duplicates.length;
+  if (relocationCount > 0) {
+    pipeline.push({ command: "relocate", args: "", priority: "WARNING", reason: `Migra ${relocationCount} componente(s) huérfanos/duplicados/mal ubicados`, count: relocationCount });
+  }
+
+  // --- WARNING: naming violations → forge reforge ---
+  const namingCount = violations.filter(v => v.severity === "SUGGESTION" && v.label && v.label.includes("Naming")).length;
+  if (namingCount > 0) {
+    pipeline.push({ command: "reforge", args: "<filename>", priority: "WARNING", reason: `Corrige ${namingCount} violación(es) de naming (ejecutar por feature)`, count: namingCount });
+  }
+
+  // --- Legacy features → forge relocate ---
+  const legacyCount = ctx?.features?.legacy?.length || 0;
+  if (legacyCount > 0) {
+    pipeline.push({ command: "relocate", args: "", priority: "WARNING", reason: `Migra ${legacyCount} feature(s) legacy a estructura hexagonal`, count: legacyCount });
+  }
+
+  // --- Missing platform → forge forge ---
+  if (ctx && !ctx.platform?.exists) {
+    pipeline.push({ command: "forge", args: "", priority: "INFO", reason: "Inicializa bootstrap de platform layer", count: 1 });
+  }
+
+  // --- Package dependencies → (not a forge command, just suggestion) ---
+  const profileSugs = profile?.suggestions || [];
+  if (profileSugs.length > 0) {
+    pipeline.push({ command: "profile", args: "--install", priority: "SUGGESTION", reason: `${profileSugs.length} dependencia(s) sugeridas por perfil`, count: profileSugs.length });
+  }
+
+  // --- Verify & finalize ---
+  if (pipeline.length > 0) {
+    pipeline.push({ command: "quench", args: "", priority: "INFO", reason: "Verifica que todas las correcciones pasen", count: 0 });
+    pipeline.push({ command: "inscribe", args: "", priority: "INFO", reason: "Actualiza ARCHITECTURE.md con el nuevo estado", count: 0 });
+  }
+
+  // Sort by priority
+  const order = { CRITICAL: 0, ERROR: 1, WARNING: 2, INFO: 3, SUGGESTION: 4 };
+  pipeline.sort((a, b) => (order[a.priority] ?? 99) - (order[b.priority] ?? 99));
+
+  return pipeline;
+}
+
+export function printPipeline(pipeline) {
+  if (!pipeline || pipeline.length === 0) return;
+  console.log(`\n${BOLD}${CYAN}═══ Pipeline recomendado ═══${RESET}`);
+  console.log(`${DIM}Para resolver los problemas encontrados, ejecuta en orden:${RESET}\n`);
+  let step = 1;
+  for (const item of pipeline) {
+    const color = SEVERITY_COLORS[item.priority] || GRAY;
+    const cmd = item.command === "forge" ? "forge forge" : `forge ${item.command}`;
+    const args = item.args ? ` ${item.args}` : "";
+    const countStr = item.count > 0 ? ` ${DIM}(${item.count})${RESET}` : "";
+    console.log(` ${GREEN}${step}.${RESET} ${BOLD}${CYAN}${cmd}${args}${RESET} ${DIM}→${RESET} ${color}${item.reason}${countStr}${RESET}`);
+    step++;
+  }
+  console.log();
+}
+
+export function pipelineToJson(pipeline) {
+  return JSON.stringify({ pipeline }, null, 2);
+}
+
+/* ── CLI ── */
+if (process.argv[1] && (process.argv[1].endsWith("recommendation-engine.mjs") || process.argv[1].endsWith("recommendation-engine.js"))) {
+  const { buildContext } = await import("./context.mjs");
+  const ctx = await buildContext();
+  const features = ctx.features?.migrated || [];
+  const graph = ctx.graph;
+  const checks = [];
+  for (const [, cat] of Object.entries(ctx.checks || {})) {
+    if (cat.checks) checks.push(...cat.checks);
+  }
+  const pipeline = buildPipeline(checks, graph, ctx.ownership, ctx, ctx);
+  printPipeline(pipeline);
+}

package/skills/forge/scripts/rollback.mjs

@@ -18,6 +18,7 @@
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, cpSync, rmSync, statSync } from "fs";
 import { join, relative, resolve, basename } from "path";
+import { fileURLToPath } from "url";
 import { execFileSync } from "child_process";
 
 const ROOT = process.cwd();
@@ -157,7 +158,8 @@ export function listBackups(target) {
 
 export function verifyAfterChange() {
   try {
-    const out = shell("node", [join(import.meta.url, "..", "inspect.mjs"), "--diff", "--json"]);
+    const __dirname = fileURLToPath(new URL(".", import.meta.url));
+    const out = shell("node", [join(__dirname, "inspect.mjs"), "--diff", "--json"]);
     if (!out) return { score: 0, improved: false, error: "inspect falló" };
 
     const result = JSON.parse(out);
@@ -167,7 +169,7 @@ export function verifyAfterChange() {
     let suggestedCommit = null;
     if (improved && score > 0) {
       const branch = shell("git", ["rev-parse", "--abbrev-ref", "HEAD"]);
-      suggestedCommit = `git add -A && git commit -m "forge: relocate/reforge (score: ${score}/110)"`;
+      suggestedCommit = `git add -A && git commit -m "forge: relocate/reforge (score: ${score})"`;
     }
 
     return { score, improved, suggestedCommit };
@@ -205,7 +207,7 @@ if (action === "backup" && arg) {
     console.error(`rollback: ${result.error}`);
     process.exit(1);
   }
-  console.log(`Score: ${result.score}/110 | ${result.improved ? "✓ Mejoró/igual" : "✘ Empeoró"}${result.suggestedCommit ? `\nSugerencia: ${result.suggestedCommit}` : ""}`);
+  console.log(`Score: ${result.score} | ${result.improved ? "✓ Mejoró/igual" : "✘ Empeoró"}${result.suggestedCommit ? `\nSugerencia: ${result.suggestedCommit}` : ""}`);
   process.exit(result.improved ? 0 : 1);
 } else {
   console.log("Uso: node rollback.mjs <backup|restore|list|verify> [target|id]");

package/skills/forge/templates/agents/SKILL.md.template

@@ -0,0 +1,283 @@
+---
+name: forge
+description: >
+  Architecture Operating System especializado en diseñar, construir, auditar,
+  proteger y evolucionar arquitecturas backend escalables basadas en features
+  (vertical slices), hexagonal architecture y DDD pragmático. Triggers:
+  "arquitectura", "migrar", "refactorizar", "features", "hexagonal",
+  "puertos y adaptadores", "clean architecture", "cast", "inspect",
+  "quench", "chain", "grafo", "graph", "nodo", "architecture graph",
+  "violaciones", "ownership", "platform", "infraestructura". Excluye
+  infraestructura (Docker, CI/CD), optimización de queries y cambios de
+  lógica de negocio sin reestructuración.
+---
+
+# Forge — Backend Architecture Operating System
+
+Forge es un **sistema operativo arquitectónico**. Diseña, construye, audita, protege y evoluciona arquitecturas backend completas. Opera sobre cualquier stack moderno modelando **cuatro dominios arquitectónicos**: **Platform**, **Features**, **Shared** e **Infrastructure**.
+
+No es un template ni una guía. Es un orquestador.
+
+---
+
+## Modelo Arquitectónico
+
+Todo backend se modela en cuatro dominios:
+
+| Layer | Propósito | Ejemplos |
+|-------|-----------|----------|
+| **Platform** | Backbone técnico global | config, database, http, server, logger, cache, security, events, di |
+| **Features** | Capacidades de negocio | auth, users, payments |
+| **Shared** | Componentes reutilizables puros | errors, contracts, types, utils |
+| **Infrastructure** | Implementaciones concretas | prisma, mongodb, redis, mail |
+
+### Dependency Rules
+
+Permitido:
+- `feature → platform`
+- `feature → shared`
+- `platform → infra`
+- `adapter → infra`
+- `feature → domain`
+
+Prohibido:
+- `feature → infra`
+- `platform → feature`
+- `shared → feature`
+- `shared → infra`
+- `domain → infra`
+- `domain → platform`
+- `infra → feature`
+
+---
+
+## Architecture Guidance
+
+Ver `reference/principles.md` para el manifiesto completo y los 12 principios inquebrantables.
+Ver `reference/patterns.md` para las convenciones de nomenclatura (PascalCase.artifact, kebab dirs, etc.).
+En esencia:
+
+| Principio | Regla |
+|---|---|
+| Cuatro dominios arquitectónicos | Platform, Features, Shared, Infrastructure con ownership estricto |
+| Unidades autónomas | Cada feature es dueño de su dominio, aplicación y adapters |
+| Dependencias unidireccionales | adapters → application → domain → (nada) |
+| Cero lógica en controllers | El controller parsea, delega y responde |
+| Cero BD fuera de repositorios | Los repositories son la única puerta a datos |
+| DI disciplinada | Constructor injection, sin service locators |
+| Cero acoplamiento directo entre features | Siempre vía interfaces inyectadas |
+| Ownership obligatorio | Cada componente tiene un único propietario arquitectónico |
+
+---
+
+## Boot Sequence (OBLIGATORIO — ejecutar siempre antes de responder)
+
+ANTES de cualquier acción, Forge DEBE ejecutar esta secuencia. Si no lo haces, puedes dar respuestas incorrectas:
+
+1. **context.mjs** — Detectar stack, platform, features, shared, infra, grafo, estado
+2. **armorer.mjs** — Detectar ownership, huérfanos, duplicados, mal ubicados
+3. **profile.mjs** — Determinar perfil tecnológico
+4. **graph.mjs** — Construir grafo arquitectónico global (4 capas + 9 reglas)
+5. **chain.mjs** — Analizar dependencias multi-capa
+6. **inspect.mjs** — Auditoría completa con ownership + platform
+7. **architecture.mjs** — Generar/actualizar ARCHITECTURE.md
+8. **Ejecutar comando solicitado** — cast, quench, temper, etc.
+9. **forgeSentinel** — Verificar cambios tras escritura
+10. **Actualizar ARCHITECTURE.md** — Reflejar nuevo estado
+
+```bash
+# Template de setup que debes ejecutar:
+ctx=$(node {{AGENT_PATH}}/scripts/context.mjs --json 2>/dev/null)
+armorer=$(node {{AGENT_PATH}}/scripts/armorer.mjs --json 2>/dev/null)
+profile=$(node {{AGENT_PATH}}/scripts/profile.mjs --extended 2>/dev/null)
+graph=$(node {{AGENT_PATH}}/scripts/graph.mjs --json 2>/dev/null)
+deps=$(node {{AGENT_PATH}}/scripts/chain.mjs --json 2>/dev/null)
+inspect=$(node {{AGENT_PATH}}/scripts/inspect.mjs --json 2>/dev/null)
+```
+
+---
+
+## Command Routing
+
+| Lenguaje natural | Comando | Archivo |
+|---|---|---|
+| "ayuda", "help", "comandos", "lista", "--help" | `forge --help` | `reference/help.md` |
+| "inicializar", "setup", "empezar" | `forge` | `reference/forge.md` |
+| "crear feature", "nuevo dominio" | `cast` | `reference/cast.md` |
+| "inspeccionar", "diagnóstico", "evaluar" | `inspect` | `reference/inspect.md` |
+| "trasladar", "mover", "reestructurar feature" | `relocate` | `reference/relocate.md` |
+| "refactorizar", "rediseñar", "cambiar estructura" | `reforge` | `reference/reforge.md` |
+| "verificar", "quench", "checklist" | `quench` | `reference/quench.md` |
+| "templar", "endurecer", "mejorar" | `temper` | `reference/temper.md` |
+| "cadena", "grafo", "acoplamiento" | `chain` | `scripts/chain.mjs` |
+| "inscribir", "grabar", "ARCHITECTURE.md" | `inscribe` | `reference/inscribe.md` |
+| "grafo", "graph", "nodo", "violaciones", "risk score" | `graph` | `scripts/graph.mjs` |
+| "fundir", "compartir", "mover a shared" | `smelt` | `reference/smelt.md` |
+| "ownership", "huérfanos", "armorer" | `inspect` | (incluido en auditoría) |
+| "fijar", "pinar", "atajo", "shortcut" | `nail` | `scripts/pin.mjs` |
+| "desfijar", "despinar", "remover atajo" | `unnail` | `scripts/pin.mjs` |
+| "hook", "pre-commit", "githook", "validar commit" | `forge hook` | `reference/hooks.md` |
+| "api", "contrato", "openapi", "swagger", "graphql" | `forge api` | `scripts/forge-api.mjs` |
+| "rollback", "restaurar", "deshacer", "backup" | `forge rollback` | `scripts/rollback.mjs` |
+| "estado", "state", "último audit" | `forge state --show` | `scripts/forge-state.mjs` |
+| "examinar","calidad", "assay", "opinión", "personas", "critique", "evaluación cualitativa" | `assay` | `reference/assay.md` |
+
+---
+
+## Execution Flow
+
+Para cada comando, Forge sigue este flujo:
+
+1. **Contexto**: Ejecutar `context.mjs` + `armorer.mjs` + `profile.mjs`
+2. **Grafo**: Ejecutar `graph.mjs` + `chain.mjs`
+3. **Auditoría**: Ejecutar `inspect.mjs`
+4. **Referencia**: Cargar `reference/<command>.md`
+5. **Ejecutar**: Aplicar el flujo definido en la referencia, usando los scripts según corresponda
+6. **Verificar**: Ejecutar `scripts/detect.mjs` para verificar que no se introdujeron violaciones
+7. **forgeSentinel**: Ejecutar `scripts/forgeSentinel.mjs --reminder`
+8. **Actualizar ARCHITECTURE.md**: Reflejar el nuevo estado (`architecture.mjs`)
+9. **Reportar**: Mostrar resultado al usuario con severidades
+
+---
+
+## Routing Rules
+
+- Si el lenguaje natural matchea exactamente un comando, ejecutarlo directamente.
+- Si hay ambigüedad, preguntar al usuario: "¿Quieres decir: cast, relocate o reforge?"
+- Si el comando requiere un perfil que no está detectado, preguntar antes de continuar.
+- Si el proyecto no tiene `src/features/` y el comando es `cast`, sugerir `forge` primero.
+- Si el proyecto no tiene `src/platform/`, ejecutar `bootstrapPlatform()` automáticamente.
+- Si `ARCHITECTURE.md` está desactualizado (fecha de auditoría > 7 días), sugerir `forge inscribe`.
+- Todos los resultados se muestran con severidades: `[CRITICAL]`, `[ERROR]`, `[WARNING]`, `[INFO]`, `[SUGGESTION]`.
+
+### Inline Ignores
+
+Forge soporta comentarios inline para excepcionar violaciones línea por línea:
+
+```ts
+// forge-ignore-next-line
+import { something } from "../infra/prisma";  // ← esta línea no se reporta
+
+// forge-ignore: R1
+import { PrismaClient } from "../../infra/prisma/client"; // ← solo R1 ignorada
+
+// forge-ignore: R1, R8
+import { crossFeature } from "../other-feature/domain/Entity"; // ← R1 y R8 ignoradas
+```
+
+---
+
+## ARCHITECTURE.md
+
+Forge mantiene un archivo `ARCHITECTURE.md` en la raíz del proyecto con el contexto persistente. Contiene:
+
+```md
+# Architecture State
+
+- Project Name: <name>
+- Framework: <detectado>
+- Runtime: <detectado>
+- Database: <detectado>
+- ORM: <detectado>
+- DI Strategy: <detectado>
+- Profile: <detectado>
+- Architecture: hexagonal-feature (Platform + Features + Shared + Infra)
+- Last Audit: <fecha> (score: <puntaje>)
+
+## Platform
+- platform/config/
+- platform/server/
+...
+
+## Features
+- features/users/
+...
+
+## Shared
+- shared/errors/
+...
+
+## Infrastructure
+- infra/prisma/
+...
+
+## Ownership
+- Health: healthy | degraded | critical
+- Score: 0-100
+- Orphans: 0
+- Duplicates: 0
+- Misplaced: 0
+
+## Architecture Graph
+...
+
+## Dependency Health
+...
+```
+
+El agente DEBE leer este archivo al inicio de cada interacción y actualizarlo al finalizar cada comando.
+
+---
+
+## Module Index
+
+| Módulo | Propósito |
+|---|---|
+| `reference/principles.md` | Manifiesto y 12 principios inquebrantables |
+| `reference/patterns.md` | Convenciones de nomenclatura globales (PascalCase.artifact, kebab dirs, etc.) |
+| `reference/errors.md` | Manejo de errores tipados en dominio y aplicación |
+| `reference/di-strategies.md` | Estrategias de inyección de dependencias según tamaño |
+| `reference/testing-patterns.md` | Pirámide de tests, unit mocks, integration tests |
+| `reference/api-design.md` | REST / GraphQL, paginación, validación, contratos |
+| `reference/observability.md` | Logging, tracing, métricas, health checks |
+| `reference/data-patterns.md` | Repository, Unit of Work, CQRS, Event Sourcing |
+| `reference/security-patterns.md` | AuthN, AuthZ, RBAC, rate limiting, validación |
+| `reference/events.md` | Eventos de dominio, outbox pattern, sagas |
+| `reference/hooks.md` | Git pre-commit hook para validación arquitectónica |
+| `reference/help.md` | Lista completa de comandos y flags de Forge |
+| `reference/assay.md` | Ensayo arquitectónico multi-persona — interpretación cualitativa del audit |
+| `profiles/` | Perfiles tecnológicos detallados (Express, Fastify, NestJS, etc.) |
+| `scripts/` | Scripts: context, detect, inspect, chain, profile, graph, architecture, armorer, bootstrap, forge-config, forge-signals, forge-state, forge-api, pin, update, rollback, hook, forgeSentinel, forgeSmith, forgeSentinel-lib, forgeSmith-admin, formatter, assay, registry/rules |
+| `scripts/registry/rules.mjs` | Anti-pattern rule registry (R1-R9 + custom rules desacopladas de detect.mjs) |
+| `scripts/formatter.mjs` | Output formatter unificado (JSON, tabla, severidad coloreada, scoreBar, formatCheck, formatViolation) |
+| `scripts/forgeSentinel.mjs` | PostToolUse hook — analiza archivos modificados tras escritura y reporta violaciones |
+| `scripts/forgeSentinel-lib.mjs` | Lógica compartida para hooks forgeSentinel y forgeSmith |
+| `scripts/forgeSmith.mjs` | preToolUse gate — previene escrituras con violaciones CRITICAL/ERROR (Cursor) |
+| `scripts/forgeSmith-admin.mjs` | Gestión de hooks (on/off/status) |
+| `scripts/assay.mjs` | Motor de ensayo arquitectónico multi-persona (Bezos, Fowler, Hacker, PM, Arquitecta Senior) |
+| `templates/feature/` | Templates de feature (entity, repository, uc, controller, routes, schema, mapper) |
+| `templates/platform/` | Templates de platform (config, server, database, logger, http, di) |
+| `templates/shared/` | Templates de shared (errors, contracts, types, utils) |
+| `templates/infra/` | Templates de infra (prisma, mongodb, redis, mail) |
+| `command/forge.md` | Definición del comando `/forge` para opencode |
+
+### Tests
+
+Forge incluye tests unitarios con `node:test` (sin dependencias externas).
+
+```bash
+node --test {{AGENT_PATH}}/tests/core.test.mjs
+```
+
+| Módulo | Tests | Descripción |
+|--------|-------|-------------|
+| `profile.mjs` | 8 | Detección de perfiles |
+| `graph.mjs` | 1 | Grafo vacío |
+| `armorer.mjs` | 1 | Ownership vacío |
+| `forge-config.mjs` | 2 | Load/save state |
+| `chain.mjs` | 1 | Grafo de dependencias vacío |
+| `formatter.mjs` | 4 | Output format, colores, JSON |
+| `registry/rules.mjs` | 4 | R1-R9, evaluación, custom rules |
+| `detect.mjs` (inline ignores) | 5 | parseInlineIgnores, isIgnored |
+| `forgeSentinel.mjs` | 1 | PostToolUse hook |
+| `assay.mjs` | 4 | Personas, generateAssay, opiniones |
+
+### Flags adicionales
+
+| Flag | Comando | Descripción |
+|---|---|---|
+| `--fix` | `quench` | Auto-corrige violaciones WARNING/INFO (missing @injectable(), tsconfig, naming, container.resolve) |
+| `--show-ignores` | `quench` | Muestra los inline ignores encontrados en el código |
+| `--persona=<id>` | `assay` | Filtra ensayo por una persona (bezos, fowler, hacker, pm, senior) |
+| `--save` | `assay` | Persiste ensayo en `.forge/assay/` |
+| `--json` | `assay` | Salida JSON |

package/skills/forge/templates/agents/agents/hooks.json

@@ -0,0 +1,18 @@
+{
+  "description": "Forge architecture guard: runs forgeSentinel after Edit/Write/apply_patch and surfaces architectural violations as system reminders.",
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|apply_patch",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.agents/skills/forge/scripts/forgeSentinel.mjs\" --hook",
+            "timeout": 10,
+            "statusMessage": "forgeSentinel — checking architecture"
+          }
+        ]
+      }
+    ]
+  }
+}

package/skills/forge/templates/agents/claude/CLAUDE.md

@@ -4,17 +4,18 @@ Forge es un sistema operativo arquitectónico para backend. Diseña, construye,
 
 ## Boot Sequence
 
-Ejecutar en orden antes de cualquier acción:
-
-1. `node .opencode/skills/forge/scripts/context.mjs` — stack + layers detection
-2. `node .opencode/skills/forge/scripts/armorer.mjs` — ownership, orphans, duplicates
-3. `node .opencode/skills/forge/scripts/profile.mjs --extended` — tech profile
-4. `node .opencode/skills/forge/scripts/graph.mjs --json` — 4-layer graph
-5. `node .opencode/skills/forge/scripts/chain.mjs --json` — dependency analysis
-6. `node .opencode/skills/forge/scripts/inspect.mjs --json` — full audit
-7. `node .opencode/skills/forge/scripts/architecture.mjs` — update ARCHITECTURE.md
+Ejecutar en orden antes de cualquier acción. Todos los paths son relativos a `.claude/skills/forge/`:
+
+1. `node .claude/skills/forge/scripts/context.mjs` — stack + layers detection
+2. `node .claude/skills/forge/scripts/armorer.mjs` — ownership, orphans, duplicates
+3. `node .claude/skills/forge/scripts/profile.mjs --extended` — tech profile
+4. `node .claude/skills/forge/scripts/graph.mjs --json` — 4-layer graph
+5. `node .claude/skills/forge/scripts/chain.mjs --json` — dependency analysis
+6. `node .claude/skills/forge/scripts/inspect.mjs --json` — full audit
+7. `node .claude/skills/forge/scripts/architecture.mjs` — update ARCHITECTURE.md
 8. Execute user command (cast, quench, relocate, etc.)
-9. Run architecture.mjs again
+9. Run `node .claude/skills/forge/scripts/forgeSentinel.mjs --reminder` — check changes
+10. Run `architecture.mjs` again
 
 ## Architecture Model
 
@@ -88,11 +89,11 @@ Cuatro capas obligatorias:
 
 ## Key Files
 
-- `skills/forge/SKILL.md` — orchestrator principal
-- `skills/forge/reference/principles.md` — manifiesto y 15 principios
-- `skills/forge/reference/patterns.md` — naming conventions
-- `skills/forge/scripts/` — context, detect, inspect, chain, profile, graph, architecture, armorer, bootstrap
-- `skills/forge/profiles/` — 10 tech profiles (express, fastify, nestjs × mongodb, postgres, prisma, drizzle)
-- `skills/forge/templates/` — templates para feature, platform, shared, infra
+- `.claude/skills/forge/SKILL.md` — orchestrator principal
+- `.claude/skills/forge/reference/principles.md` — manifiesto y 15 principios
+- `.claude/skills/forge/reference/patterns.md` — naming conventions
+- `.claude/skills/forge/scripts/` — context, detect, inspect, chain, profile, graph, architecture, armorer, bootstrap, forgeSentinel, forgeSmith
+- `.claude/skills/forge/profiles/` — 10 tech profiles (express, fastify, nestjs × mongodb, postgres, prisma, drizzle)
+- `.claude/skills/forge/templates/` — templates para feature, platform, shared, infra
 - `AGENTS.md` — guía para agentes de IA
 - `ARCHITECTURE.md` — estado actual de la arquitectura

package/skills/forge/templates/agents/claude/settings.local.json

@@ -0,0 +1,18 @@
+{
+  "description": "Forge architecture guard: runs forgeSentinel after Edit/Write/MultiEdit and surfaces architectural violations as system reminders.",
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/skills/forge/scripts/forgeSentinel.mjs\" --hook",
+            "timeout": 10,
+            "statusMessage": "forgeSentinel — checking architecture"
+          }
+        ]
+      }
+    ]
+  }
+}

package/skills/forge/templates/agents/codex/hooks.json

@@ -0,0 +1,18 @@
+{
+  "description": "Forge architecture guard: runs forgeSentinel after Edit/Write/apply_patch and surfaces architectural violations as system reminders.",
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|apply_patch",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$(git rev-parse --show-toplevel)/.agents/skills/forge/scripts/forgeSentinel.mjs\" --hook",
+            "timeout": 10,
+            "statusMessage": "forgeSentinel — checking architecture"
+          }
+        ]
+      }
+    ]
+  }
+}

package/skills/forge/templates/agents/cursor/.cursorrules

@@ -1,5 +1,7 @@
 You are an AI assistant for a project that uses Forge — a Backend Architecture Operating System. Tu función es ayudar a diseñar, construir, auditar y evolucionar la arquitectura usando Arquitectura Hexagonal, DDD pragmático y vertical slices.
 
+All forge scripts are in `.cursor/skills/forge/scripts/`.
+
 ## Architecture Model
 
 The project uses four mandatory layers:
@@ -27,6 +29,21 @@ src/
 - R8: cross-feature direct imports
 - R9: cycles
 
+## Boot Sequence
+
+Ejecutar en orden antes de cualquier acción:
+
+1. `node .cursor/skills/forge/scripts/context.mjs` — stack + layers detection
+2. `node .cursor/skills/forge/scripts/armorer.mjs` — ownership, orphans, duplicates
+3. `node .cursor/skills/forge/scripts/profile.mjs --extended` — tech profile
+4. `node .cursor/skills/forge/scripts/graph.mjs --json` — 4-layer graph
+5. `node .cursor/skills/forge/scripts/chain.mjs --json` — dependency analysis
+6. `node .cursor/skills/forge/scripts/inspect.mjs --json` — full audit
+7. `node .cursor/skills/forge/scripts/architecture.mjs` — update ARCHITECTURE.md
+8. Execute user command (cast, quench, relocate, etc.)
+9. Run `node .cursor/skills/forge/scripts/forgeSentinel.mjs --reminder`
+10. Run `architecture.mjs` again
+
 ## Naming Conventions
 
 | Element | Convention | Example |
@@ -71,10 +88,10 @@ src/
 
 ## Key Files Reference
 
-- `skills/forge/SKILL.md` — orchestrator
-- `skills/forge/reference/principles.md` — 15 principles
-- `skills/forge/reference/patterns.md` — naming conventions
-- `skills/forge/scripts/` — all engine scripts
-- `skills/forge/profiles/` — tech profiles
+- `.cursor/skills/forge/SKILL.md` — orchestrator
+- `.cursor/skills/forge/reference/principles.md` — 15 principles
+- `.cursor/skills/forge/reference/patterns.md` — naming conventions
+- `.cursor/skills/forge/scripts/` — all engine scripts
+- `.cursor/skills/forge/profiles/` — tech profiles
 - `AGENTS.md` — agent guide
 - `ARCHITECTURE.md` — current architecture state

package/skills/forge/templates/agents/cursor/hooks.json

@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "hooks": {
+    "preToolUse": [
+      {
+        "command": "node \".cursor/skills/forge/scripts/forgeSmith.mjs\"",
+        "timeout": 10
+      }
+    ]
+  }
+}

package/skills/forge/templates/agents/gemini/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: forge
+description: >
+  Architecture Operating System especializado en diseñar, construir, auditar,
+  proteger y evolucionar arquitecturas backend escalables basadas en features
+  (vertical slices), hexagonal architecture y DDD pragmático.
+allowed-tools:
+  - Bash(node .gemini/skills/forge/scripts/*)
+---
+
+# Forge — Backend Architecture Operating System
+
+Ver `.gemini/skills/forge/SKILL.md` para la guía completa.