@ronaldjdevfs/forge 1.4.0 → 1.4.3

package/README.md

@@ -1,6 +1,6 @@
 <img src="favicon.svg" alt="Forge Logo" width="100" height="100">
 
-> **v1.4.0** — Forge Init, Auto-Fix Iterativo & Inspect Full Default
+> **v1.4.3** — DI: feature/di.ts como fuente única de registro
 
 ## Forge — Backend Architecture Operating System
 
@@ -85,7 +85,7 @@ Evalúa 10 categorías contra un máximo de 180 puntos (normalizado a 0-100):
 | Graph | 20 | Salud del grafo arquitectónico, risk score |
 | Custom Rules | 5 | Reglas personalizadas desde `.forge/rules.json` |
 | Naming | 10 | Convenciones de nomenclatura PascalCase/kebab |
-| Import Conventions | 20 | R10-R12: bare specifiers, extensión .ts, bootstrap.di.js |
+| Import Conventions | 20 | R10-R12: bare specifiers, extensión .ts, imports prohibidos |
 
 **Resultado**: Score 0-100 con grado A-F y severidades por cada violación.
 
@@ -122,7 +122,7 @@ Ejecuta 9 reglas arquitectónicas (R1-R9) con severidad:
 | R9 | Ciclos de dependencia | ERROR |
 | R10 | Bare specifiers en imports locales | ERROR |
 | R11 | Extensión `.ts` en imports (debe ser `.js`) | ERROR |
-| R12 | Import a `bootstrap.di.js` (no existe) | CRITICAL |
+| R12 | Import a archivo DI inexistente (ej: `bootstrap.di.js`) | CRITICAL |
 | R12b | `registerSingleton` con model() de Mongoose | CRITICAL |
 
 ### `temper` — Endurecimiento de DI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ronaldjdevfs/forge",
-  "version": "1.4.0",
+  "version": "1.4.3",
   "description": "Forge — Architecture Operating System for backend systems. Arquitectura Hexagonal, DDD pragmático y vertical slices.",
   "type": "module",
   "bin": {

package/skills/forge/SKILL.md

@@ -72,7 +72,7 @@ En esencia:
 
 ## Boot Sequence
 
-ANTES de cualquier acción, Forge DEBE ejecutar `forge-boot.mjs` con la profundidad adecuada al comando:
+ANTES de cualquier acción, Forge DEBE ejecutar `{{AGENT_PATH}}/scripts/forge-boot.mjs` con la profundidad adecuada al comando:
 
 ```bash
 boot=$(node {{AGENT_PATH}}/scripts/forge-boot.mjs --depth <depth> --json 2>/dev/null)
@@ -99,15 +99,15 @@ Si `$boot` contiene datos cacheados en `.forge/cache/` se reusan automáticament
 | Refactorizar | `reforge` | `reference/reforge.md` |
 | Verificar violaciones | `quench` | `reference/quench.md` |
 | Endurecer | `temper` | `reference/temper.md` |
-| Dependencias | `chain` | `scripts/chain.mjs` |
+| Dependencias | `chain` | `{{AGENT_PATH}}/scripts/chain.mjs` |
 | Inscribir ARCHITECTURE.md | `inscribe` | `reference/inscribe.md` |
-| Grafo arquitectónico | `graph` | `scripts/graph.mjs` |
+| Grafo arquitectónico | `graph` | `{{AGENT_PATH}}/scripts/graph.mjs` |
 | Fundir a shared | `smelt` | `reference/smelt.md` |
-| Atajo / pin | `nail` / `unnail` | `scripts/pin.mjs` |
+| Atajo / pin | `nail` / `unnail` | `{{AGENT_PATH}}/scripts/pin.mjs` |
 | Git hook | `forge hook` | `reference/hooks.md` |
-| API design | `forge api` | `scripts/forge-api.mjs` |
-| Rollback | `forge rollback` | `scripts/rollback.mjs` |
-| Estado | `forge state` | `scripts/forge-state.mjs` |
+| API design | `forge api` | `{{AGENT_PATH}}/scripts/forge-api.mjs` |
+| Rollback | `forge rollback` | `{{AGENT_PATH}}/scripts/rollback.mjs` |
+| Estado | `forge state` | `{{AGENT_PATH}}/scripts/forge-state.mjs` |
 | Ensayo cualitativo | `assay` | `reference/assay.md` |
 | Bounded context | `forge` | `reference/bounded-contexts.md` |
 | Modular monolith | `forge` | `reference/modular-monolith.md` |
@@ -126,17 +126,17 @@ Si `$boot` contiene datos cacheados en `.forge/cache/` se reusan automáticament
 
 Para cada comando, Forge sigue este flujo:
 
-1. **Boot condicional**: Ejecutar `forge-boot.mjs --depth <depth>` donde depth es:
+1. **Boot condicional**: Ejecutar `{{AGENT_PATH}}/scripts/forge-boot.mjs --depth <depth>` donde depth es:
    - `minimal` para cast, temper, smelt, relocate, reforge, inscribe
    - `standard` para chain, graph, forge hook
    - `full` para inspect, quench, o cualquier otro comando
 2. **Referencia**: Cargar `reference/<command>.md`
 3. **Ejecutar**: Aplicar el flujo definido en la referencia
-4. **Verificar**: Ejecutar `detect.mjs --summary` (resumen compacto)
-5. **Actualizar ARCHITECTURE.md**: `architecture.mjs` (solo en full)
+4. **Verificar**: Ejecutar `{{AGENT_PATH}}/scripts/detect.mjs --summary` (resumen compacto)
+5. **Actualizar ARCHITECTURE.md**: `{{AGENT_PATH}}/scripts/architecture.mjs` (solo en full)
 6. **Reportar**: Mostrar resultado al usuario con severidades
 
-El boot usa caché de `.forge/cache/`. Si los archivos `src/` no cambiaron, los datos se reusan. Usa `forge-boot.mjs --force` para regenerar todo.
+El boot usa caché de `.forge/cache/`. Si los archivos `src/` no cambiaron, los datos se reusan. Usa `{{AGENT_PATH}}/scripts/forge-boot.mjs --force` para regenerar todo.
 
 ---
 
@@ -180,9 +180,9 @@ import { crossFeature } from "../other-feature/domain/Entity"; // ← R1 y R8 ig
 
 ## ARCHITECTURE.md
 
-Forge mantiene `ARCHITECTURE.md` en la raíz con el estado persistente del proyecto (framework, DB, features, ownership, graph). Se genera y actualiza con `architecture.mjs`.
+Forge mantiene `ARCHITECTURE.md` en la raíz con el estado persistente del proyecto (framework, DB, features, ownership, graph). Se genera y actualiza con `{{AGENT_PATH}}/scripts/architecture.mjs`.
 
-El agente DEBE leer este archivo al inicio de cada interacción y actualizarlo al finalizar cada comando. Ver `scripts/architecture.mjs` para el formato completo.
+El agente DEBE leer este archivo al inicio de cada interacción y actualizarlo al finalizar cada comando. Ver `{{AGENT_PATH}}/scripts/architecture.mjs` para el formato completo.
 
 ---
 
@@ -198,16 +198,16 @@ 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 |
-| `posttool.mjs` | 1 | PostToolUse hook |
-| `assay.mjs` | 4 | Personas, generateAssay, opiniones |
+| `{{AGENT_PATH}}/scripts/profile.mjs` | 8 | Detección de perfiles |
+| `{{AGENT_PATH}}/scripts/graph.mjs` | 1 | Grafo vacío |
+| `{{AGENT_PATH}}/scripts/armorer.mjs` | 1 | Ownership vacío |
+| `{{AGENT_PATH}}/scripts/forge-config.mjs` | 2 | Load/save state |
+| `{{AGENT_PATH}}/scripts/chain.mjs` | 1 | Grafo de dependencias vacío |
+| `{{AGENT_PATH}}/scripts/formatter.mjs` | 4 | Output format, colores, JSON |
+| `{{AGENT_PATH}}/scripts/registry/rules.mjs` | 4 | R1-R9, evaluación, custom rules |
+| `{{AGENT_PATH}}/scripts/detect.mjs` (inline ignores) | 5 | parseInlineIgnores, isIgnored |
+| `{{AGENT_PATH}}/scripts/posttool.mjs` | 1 | PostToolUse hook |
+| `{{AGENT_PATH}}/scripts/assay.mjs` | 4 | Personas, generateAssay, opiniones |
 | transactional-outbox | 5 | Entry lifecycle, retry, DLQ, required fields, pending |
 | idempotency | 5 | UUID validation, cached response, different keys, TTL, method filter |
 | anti-corruption-layer | 5 | DTO mapping (2 dirs), null handling, 404, delegation order |

package/skills/forge/profiles/express-mongodb.md

@@ -91,20 +91,25 @@ import { createApp } from "./app.js";
 ```typescript
 import { container } from "tsyringe";
 
-// Interfaces se registran como singletons
-container.registerSingleton<ICreditRepository>(
-  ICreditRepository as symbol,
-  CreditRepository
-);
+// Importar los di.ts de cada feature — cada uno registra sus propias dependencias.
+// NUNCA registrar las mismas dependencias aquí directamente.
+import "@/features/credit/di.js";
+// import "@/features/users/di.js";  // más features...
+
+// Solo registrar dependencias transversales (platform/shared) aquí:
+// container.registerSingleton<ILogger>("ILogger", WinstonLogger);
 ```
 
 ## DI Rules
 
 - `@injectable()` en toda clase con dependencias (use cases, controllers, repositories)
 - `@inject(Token)` con tokens de clase, nunca strings
-- `container.resolve()` solo en bootstrap (app.ts, routes)
+- Cada feature registra sus dependencias en `feature/di.ts` (fuente única)
+- `app.ts` importa los `di.ts` de cada feature — no registra features directamente
+- `container.resolve()` solo en routes (para resolver controllers)
 - Prohibido `container.resolve()` en use cases, entities o adapters
 - Prohibido `new UseCase(dep1, dep2)` en features migrados a DI
+- Prohibido registrar la misma dependencia en `app.ts` y `feature/di.ts`
 
 ## Routes & Controllers
 

package/skills/forge/profiles/express-prisma.md

@@ -37,7 +37,7 @@ architecture: hexagonal-feature
 
 ## DI Setup
 
-Igual que `express-mongodb` (tsyringe). Las interfaces se registran como singletons.
+Igual que `express-mongodb` (tsyringe). Cada feature registra sus dependencias en `feature/di.ts`. `app.ts` importa esos archivos:
 
 ## Persistence (Prisma)
 

package/skills/forge/reference/adr.md

@@ -205,10 +205,10 @@ docs/
 El `README.md` se genera automáticamente listando los ADRs activos:
 
 ```bash
-# scripts/forge-adr.mjs (futuro)
-node scripts/forge-adr.mjs list    # lista todos los ADRs
-node scripts/forge-adr.mjs new     # crea nuevo ADR desde template
-node scripts/forge-adr.mjs status  # cambia estado de un ADR
+# {{AGENT_PATH}}/scripts/forge-adr.mjs (futuro)
+node {{AGENT_PATH}}/scripts/forge-adr.mjs list    # lista todos los ADRs
+node {{AGENT_PATH}}/scripts/forge-adr.mjs new     # crea nuevo ADR desde template
+node {{AGENT_PATH}}/scripts/forge-adr.mjs status  # cambia estado de un ADR
 ```
 
 ---

package/skills/forge/reference/architectural-depth-checklist.md

@@ -87,7 +87,7 @@ Un equipo puede evaluar su arquitectura actual contra el marco de decisión y ob
 - [ ] **Integración con `inscribe`**: anexar ADRs activos en ARCHITECTURE.md
 - [ ] **Integración con `assay`**: las decisiones como insumo para el ensayo multi-persona
 - [ ] **Cuándo escribir un ADR**: scoping, tecnología, patrón, estándar, cambio de regla, excepción
-- [ ] **ADRs como fuente de verdad**: enlazar ADRs desde reglas de detect.mjs, desde inline ignores
+- [ ] **ADRs como fuente de verdad**: enlazar ADRs desde reglas de {{AGENT_PATH}}/scripts/detect.mjs, desde inline ignores
 - [ ] **Ejemplos**: ADRs reales del modelo Forge (ej. "usar capa Shared en vez de cross-feather imports", "adoptar Prisma como ORM")
 - [ ] **Tooling**: script para crear, listar, cambiar estado de ADRs
 - [ ] **Anti-patrones**: ADRs que nunca se leen, ADRs sin contexto, ADRs sin consecuencia, ADRs de frameworks
@@ -114,7 +114,7 @@ Un `forge inscribe` genera ARCHITECTURE.md con enlaces a ADRs activos. Un nuevo
 - [ ] **Mapeo de integraciones legacy**: cómo modelar sistemas externos como bounded contexts con ACL
 - [ ] **Estrategias de traducción**: event-based (publicar/suscribir), service-based (llamadas sincrónicas), repository-based (datos compartidos)
 - [ ] **Conexión con reglas R1 y R7**: cómo ACL permite feature → infra sin violar la regla (porque el adapter traduce)
-- [ ] **Detección automática**: qué patrones en detect.mjs indican necesidad de ACL
+- [ ] **Detección automática**: qué patrones en {{AGENT_PATH}}/scripts/detect.mjs indican necesidad de ACL
 - [ ] **Ejemplo**: feature de "Orders" migrando de legacy SQL a nuevo schema con ACL + Strangler Fig
 - [ ] **Anti-patrones**: ACL que filtra sin traducir (leaky abstraction), ACL que muta el origen, ACL como pasamanos
 
@@ -136,8 +136,8 @@ Un desarrollador puede identificar cuándo necesita una ACL, modelarla dentro de
 - [ ] **Definición**: arquitectura que evoluciona incrementalmente guiada por fitness functions
 - [ ] **Fitness functions**: tests automatizados que validan características arquitectónicas (acoplamiento, modularidad, performance, seguridad)
 - [ ] **Tipos de fitness functions**: estáticas (lint-level), dinámicas (runtime), periódicas (benchmark), trigger-based (CI)
-- [ ] **Implementación en Forge**: las reglas R1-R9 como fitness functions gobernadas por detect.mjs
-- [ ] **Fitness functions custom**: cómo el usuario define sus propias funciones y se registran en registry/rules.mjs
+- [ ] **Implementación en Forge**: las reglas R1-R9 como fitness functions gobernadas por {{AGENT_PATH}}/scripts/detect.mjs
+- [ ] **Fitness functions custom**: cómo el usuario define sus propias funciones y se registran en {{AGENT_PATH}}/scripts/registry/rules.mjs
 - [ ] **Guía de cambio incremental**: smallest viable change, refactor patterns, scaffolding antes de feature completo
 - [ ] **Evolución de boundaries**: cómo partir, fusionar o mover features sin reescribir
 - [ ] **Integración con CI/CD**: fitness functions en pipeline, gate de deployment, alertas de regresión

package/skills/forge/reference/cast.md

@@ -21,7 +21,7 @@ Si alguno no existe, ejecutar `bootstrapPlatform()` automáticamente para crearl
 
 **NO escribir código hasta pasar los 3 gates de aprobación.** Cast solía crear scaffolding directamente del nombre del feature. Esto producía features genéricos que requerían refactor posterior. Ahora todo `cast` requiere descubrimiento direccional multi-ronda.
 
-Usar las **señales de `forge-signals.mjs`** para contextualizar el descubrimiento:
+Usar las **señales de `{{AGENT_PATH}}/scripts/forge-signals.mjs`** para contextualizar el descubrimiento:
 - Si hay features existentes, revisar sus entidades y casos de uso para mantener coherencia.
 - Si el perfil está detectado, usarlo para preguntas específicas (ej: "Prisma detectado → schema primero").
 - Si hay archivos modificados en git, considerarlos como contexto del nuevo feature.
@@ -157,9 +157,9 @@ Regla: si la entidad vive fuera del feature, todos los imports deben usar path a
 
 Después de crear los archivos del feature, generar `di.ts` siguiendo el template `templates/feature/di.ts.md`:
 
-1. **Feature con DI propia**: crear `src/features/<name>/di.ts` usando el template
-2. **Feature SIN DI propia**: si ya existe `src/platform/setting/dependencies/<name>.di.js`, los controllers deben importar desde allí en vez de `bootstrap.di.js`
-3. **Controllers**: asegurar que el import en el controller apunte a `@/setting/dependencies/<name>.di.js` o `./di.js`, NUNCA a `bootstrap.di.js`
+1. **Feature con DI propia (siempre)**: crear `src/features/<name>/di.ts` usando el template. Este archivo es la **fuente única** de registro para el feature.
+2. **app.ts**: importar el `di.ts` del feature (ej: `import "@/features/<name>/di.js";`). No registrar las mismas dependencias en app.ts.
+3. **Controllers**: asegurar que el import en el controller apunte a `./di.js` (del feature), NUNCA a `bootstrap.di.js`
 4. **Mongoose model()**: si el schema exporta `export default model()` (objeto, no clase), el DI debe usar `container.register(..., { useValue: ... })`, NO `registerSingleton`
 
 ## ⚠️ Post-Cast: Tests
@@ -181,7 +181,7 @@ Antes de dar por terminado el feature, verificar CADA archivo generado:
 - [ ] Todos los imports locales usan prefijo `./` o `../` — sin bare specifiers (`import X from "domain/..."` ❌)
 - [ ] Todos los imports tienen extensión `.js` — sin extensión `.ts`
 - [ ] Entidades compartidas usan `@/domain/` — sin paths relativos rotos
-- [ ] Controllers importan desde `di.ts` o `@/setting/dependencies/` — no desde `bootstrap.di.js`
+- [ ] Controllers importan desde `./di.js` — no desde `bootstrap.di.js`
 - [ ] Nombres de método del controller coinciden con los de la ruta (ej: `createHandler` en controller → `controller.createHandler` en routes)
 - [ ] DI usa `register({ useValue })` para modelos Mongoose — no `registerSingleton`
 - [ ] Tests: `.js` extension, `as const`, `!`, `as any` para _id

package/skills/forge/reference/chain.md

@@ -63,7 +63,7 @@ node {{AGENT_PATH}}/scripts/graph.mjs
 node {{AGENT_PATH}}/scripts/architecture.mjs
 ```
 
-`chain.mjs` ahora es un wrapper sobre `graph.mjs`. Produce el mismo formato de salida para compatibilidad (nodos, edges, features, orden topológico). El nuevo `graph.mjs` amplía el análisis a todos los tipos de nodo (core, feature, domain, infra, adapter) y detecta violaciones de reglas arquitectónicas (R1-R6).
+`{{AGENT_PATH}}/scripts/chain.mjs` ahora es un wrapper sobre `{{AGENT_PATH}}/scripts/graph.mjs`. Produce el mismo formato de salida para compatibilidad (nodos, edges, features, orden topológico). El nuevo `{{AGENT_PATH}}/scripts/graph.mjs` amplía el análisis a todos los tipos de nodo (core, feature, domain, infra, adapter) y detecta violaciones de reglas arquitectónicas (R1-R6).
 
 ## Buenas prácticas
 
@@ -74,6 +74,6 @@ node {{AGENT_PATH}}/scripts/architecture.mjs
 
 ## Ver también
 
-- `scripts/graph.mjs` — el grafo que chain analiza topológicamente
+- `{{AGENT_PATH}}/scripts/graph.mjs` — el grafo que chain analiza topológicamente
 - `reference/evolutionary-architecture.md` — fitness functions de dependencias
 - `reference/modular-monolith.md` — ciclo de dependencias como señal de split

package/skills/forge/reference/cohesion-checklist.md

@@ -30,7 +30,7 @@ Checklist para llevar la cohesión del corpus de referencias de ~8.5/10 a 10/10.
 ### F1.2 — `chain.md`
 
 - [ ] Añadir "Ver también" al final:
-  - `scripts/graph.mjs` — el grafo que chain analiza topológicamente
+  - `{{AGENT_PATH}}/scripts/graph.mjs` — el grafo que chain analiza topológicamente
   - `reference/evolutionary-architecture.md` — fitness functions de dependencias
   - `reference/modular-monolith.md` — ciclo de dependencias como señal de split
 
@@ -55,7 +55,7 @@ Checklist para llevar la cohesión del corpus de referencias de ~8.5/10 a 10/10.
   - `reference/quench.md` — validación que el hook ejecuta en pre-commit
   - `reference/evolutionary-architecture.md` — fitness functions como hook
   - `reference/adr.md` — ADRs como insumo para validación en hook
-  - `reference/detect.mjs` — script que el hook invoca
+  - `{{AGENT_PATH}}/scripts/detect.mjs` — script que el hook invoca
 
 ### F1.6 — `smelt.md`
 

package/skills/forge/reference/di-strategies.md

@@ -5,6 +5,7 @@
 - Constructor injection sobre service locators o decoradores mágicos.
 - El dominio nunca importa el contenedor. Solo application y adapters.
 - Interfaces en domain/; implementaciones en adapters/out/ o platform/.
+- **Cada feature es dueña de su registro DI** via `feature/di.ts`.
 
 ## Estrategias según tamaño del proyecto
 
@@ -29,23 +30,39 @@ const userController = new UserController(createUserUc);
 router.post("/users", (req, res) => userController.create(req, res));
 ```
 
-## Contenedor (tsyringe)
+## Contenedor (tsyringe) — Patrón feature/di.ts
+
+Cada feature tiene un `di.ts` que es la **fuente única** de registro para ese feature.
+`app.ts` importa esos archivos como side-effect:
+
+```ts
+// src/app.ts — Composition Root (solo imports)
+import { container } from "tsyringe";
+import "@/features/users/di.js";
+import "@/features/credits/di.js";
+// ...
+```
 
 ```ts
-// di/Container.ts
+// src/features/users/di.ts — Registro del feature (fuente única)
 import { container } from "tsyringe";
-import { IUserRepository } from "@/features/users/domain/IUser.repository.js";
-import { PostgresUserRepository } from "@/features/users/adapters/out/persistence/PostgresUser.repository.js";
+import { IUserRepository } from "./domain/IUser.repository.js";
+import { PostgresUserRepository } from "./adapters/out/persistence/PostgresUser.repository.js";
 
 container.registerSingleton<IUserRepository>("IUserRepository", PostgresUserRepository);
 ```
 
+**Regla clave**: Nunca registrar la misma dependencia en `app.ts` y `feature/di.ts`.
+`app.ts` solo registra dependencias transversales (platform/shared).
+
 ## Buenas prácticas
 
 - Composition Root único y lo más cercano al entrypoint posible
+- Cada feature registra sus dependencias en su propio `di.ts`
+- `app.ts` importa los `di.ts` — no registra features directamente
 - Solo el Composition Root conoce todas las implementaciones concretas
 - Preferir interfaces sobre clases abstractas en domain/
-- Evitar `container.resolve()` fuera del Composition Root
+- Evitar `container.resolve()` fuera del Composition Root y routes
 - Usar tokens (strings o símbolos) para identificar dependencias
 - Testear use cases con mocks manuales sin necesidad del contenedor
 

package/skills/forge/reference/evolutionary-architecture.md

@@ -25,7 +25,7 @@ Una **fitness function** es un test automatizado que valida una característica
 Las 9 reglas de Forge son fitness functions:
 
 ```ts
-// scripts/registry/rules.mjs (conceptual)
+// {{AGENT_PATH}}/scripts/registry/rules.mjs (conceptual)
 const rules = {
   R1: {
     name: "feature → infra prohibited",
@@ -44,7 +44,7 @@ const rules = {
 ```
 
 Estas fitness functions se ejecutan en:
-- `node scripts/detect.mjs` — detección local
+- `node {{AGENT_PATH}}/scripts/detect.mjs` — detección local
 - `forge quench` — validación completa
 - PostToolUse hook — después de cada escritura del agente
 
@@ -53,7 +53,7 @@ Estas fitness functions se ejecutan en:
 Los usuarios pueden registrar sus propias funciones:
 
 ```ts
-// scripts/registry/rules.mjs
+// {{AGENT_PATH}}/scripts/registry/rules.mjs
 import { registerRule } from "./registry/rules.mjs";
 
 registerRule({
@@ -70,7 +70,7 @@ registerRule({
 
 | Tipo | Ejecución | Ejemplo |
 |---|---|---|
-| **Estática** | Lint/build | `detect.mjs` analiza imports |
+| **Estática** | Lint/build | `{{AGENT_PATH}}/scripts/detect.mjs` analiza imports |
 | **Dinámica** | Runtime | Verificar que event bus no pierde eventos |
 | **Benchmark** | CI periódico | Tiempo de respuesta de queries < 200ms |
 | **Trigger-based** | Evento (PR, deploy) | No hay imports directos entre features |
@@ -100,7 +100,7 @@ El flujo de cambio guiado de Forge asegura que cada modificación arquitectónic
 ### 1. Estado actual (before)
 
 ```bash
-node scripts/inspect.mjs --json
+node {{AGENT_PATH}}/scripts/inspect.mjs --json
 # Score: 85
 # Violaciones: 2 WARNING (R9 borderline, naming)
 ```
@@ -130,7 +130,7 @@ forge reforge --apply
 ### 5. Estado actual (after)
 
 ```bash
-node scripts/inspect.mjs --json
+node {{AGENT_PATH}}/scripts/inspect.mjs --json
 # Score: 92 (+7)
 # Violaciones: 0
 ```
@@ -264,7 +264,7 @@ forge reforge --publish shared/contracts as @company/contracts
 # 1. Extrae contracts/ a packages/contracts/
 # 2. Configura build con tsc
 # 3. Actualiza imports en todas las features
-# 4. Verifica con detect.mjs que los nuevos imports son válidos
+# 4. Verifica con {{AGENT_PATH}}/scripts/detect.mjs que los nuevos imports son válidos
 ```
 
 ---

package/skills/forge/reference/forge.md

@@ -11,17 +11,17 @@ Inicializa un proyecto para trabajar con Forge como Backend Architecture Operati
 
 ## Flujo
 
-1. Ejecutar `scripts/context.mjs` — detectar stack actual (incluye platform, features, shared, infra)
-2. Ejecutar `scripts/bootstrap.mjs` — crear layers faltantes (platform, shared, infra)
+1. Ejecutar `{{AGENT_PATH}}/scripts/context.mjs` — detectar stack actual (incluye platform, features, shared, infra)
+2. Ejecutar `{{AGENT_PATH}}/scripts/bootstrap.mjs` — crear layers faltantes (platform, shared, infra)
 3. Crear `src/features/` — directorio de features si no existe
-4. Ejecutar `forge-config.mjs --init` — crear `.forge/config.json` + `.forge/state.json`
-5. Ejecutar `forge-config.mjs --update` — detectar y persistir perfil tecnológico
+4. Ejecutar `{{AGENT_PATH}}/scripts/forge-config.mjs --init` — crear `.forge/config.json` + `.forge/state.json`
+5. Ejecutar `{{AGENT_PATH}}/scripts/forge-config.mjs --update` — detectar y persistir perfil tecnológico
 6. Verificar `tsconfig.json` — agregar `experimentalDecorators` y `emitDecoratorMetadata` si falta
-7. Ejecutar `scripts/armorer.mjs` — detectar ownership y huérfanos
-8. Ejecutar `scripts/graph.mjs` — construir grafo arquitectónico global
-9. Ejecutar `scripts/chain.mjs` — analizar dependencias multi-capa
-10. Ejecutar `detect.mjs --summary` — auditoría base
-11. Ejecutar `architecture.mjs` — generar `ARCHITECTURE.md`
+7. Ejecutar `{{AGENT_PATH}}/scripts/armorer.mjs` — detectar ownership y huérfanos
+8. Ejecutar `{{AGENT_PATH}}/scripts/graph.mjs` — construir grafo arquitectónico global
+9. Ejecutar `{{AGENT_PATH}}/scripts/chain.mjs` — analizar dependencias multi-capa
+10. Ejecutar `{{AGENT_PATH}}/scripts/detect.mjs --summary` — auditoría base
+11. Ejecutar `{{AGENT_PATH}}/scripts/architecture.mjs` — generar `ARCHITECTURE.md`
 12. Si faltan dependencias clave (según perfil), listarlas
 13. Si el proyecto tiene código legacy, sugerir `forge relocate`
 14. Si el proyecto está listo, sugerir `forge cast`

package/skills/forge/reference/hooks.md

@@ -33,7 +33,7 @@ forge hook uninstall
 
 ## Comportamiento
 
-El hook ejecuta `detect.mjs` sobre los archivos staged con extensión
+El hook ejecuta `{{AGENT_PATH}}/scripts/detect.mjs` sobre los archivos staged con extensión
 `.ts`, `.js`, `.mjs`, `.tsx`, `.jsx` dentro de `src/`. Si encuentra
 violaciones de severidad CRITICAL o ERROR que afecten a archivos staged:
 

package/skills/forge/reference/inscribe.md

@@ -104,20 +104,20 @@ Genera y mantiene el archivo `ARCHITECTURE.md` del proyecto.
 
 | Campo | Fuente |
 |---|---|
-| Framework | `scripts/context.mjs` |
-| Database | `scripts/context.mjs` |
-| ORM | `scripts/context.mjs` |
-| DI Strategy | `scripts/context.mjs` |
-| Active Profile | `scripts/profile.mjs` |
-| Platform | `scripts/context.mjs` → platform |
-| Features | `scripts/context.mjs` → features |
-| Shared | `scripts/context.mjs` → shared |
-| Infra | `scripts/context.mjs` → infra |
-| Ownership | `scripts/armorer.mjs` |
-| Architecture Graph | `scripts/graph.mjs` |
-| Risk Score | `scripts/graph.mjs` → stats.riskScore |
-| Violations | `scripts/graph.mjs` → violations |
-| Last Audit | `scripts/inspect.mjs` → fecha + score |
+| Framework | `{{AGENT_PATH}}/scripts/context.mjs` |
+| Database | `{{AGENT_PATH}}/scripts/context.mjs` |
+| ORM | `{{AGENT_PATH}}/scripts/context.mjs` |
+| DI Strategy | `{{AGENT_PATH}}/scripts/context.mjs` |
+| Active Profile | `{{AGENT_PATH}}/scripts/profile.mjs` |
+| Platform | `{{AGENT_PATH}}/scripts/context.mjs` → platform |
+| Features | `{{AGENT_PATH}}/scripts/context.mjs` → features |
+| Shared | `{{AGENT_PATH}}/scripts/context.mjs` → shared |
+| Infra | `{{AGENT_PATH}}/scripts/context.mjs` → infra |
+| Ownership | `{{AGENT_PATH}}/scripts/armorer.mjs` |
+| Architecture Graph | `{{AGENT_PATH}}/scripts/graph.mjs` |
+| Risk Score | `{{AGENT_PATH}}/scripts/graph.mjs` → stats.riskScore |
+| Violations | `{{AGENT_PATH}}/scripts/graph.mjs` → violations |
+| Last Audit | `{{AGENT_PATH}}/scripts/inspect.mjs` → fecha + score |
 
 ## Reglas
 

package/skills/forge/reference/inspect.md

@@ -11,10 +11,10 @@ Inspecciona la conformidad arquitectónica del proyecto.
 
 ## Flujo
 
-1. Ejecutar `scripts/context.mjs` → detectar stack y estructura
-2. Ejecutar `scripts/profile.mjs` → determinar perfil activo
-3. Ejecutar `scripts/chain.mjs` → construir cadena de dependencias
-4. Ejecutar `scripts/detect.mjs` → detectar todas las violaciones
+1. Ejecutar `{{AGENT_PATH}}/scripts/context.mjs` → detectar stack y estructura
+2. Ejecutar `{{AGENT_PATH}}/scripts/profile.mjs` → determinar perfil activo
+3. Ejecutar `{{AGENT_PATH}}/scripts/chain.mjs` → construir cadena de dependencias
+4. Ejecutar `{{AGENT_PATH}}/scripts/detect.mjs` → detectar todas las violaciones
 5. Construir reporte con puntuación y severidades
 6. Mostrar resultado al usuario
 

package/skills/forge/reference/patterns.md

@@ -200,7 +200,7 @@ import { Task } from "../../../../domain/entities/Task.js";
 - Verificar existencia ANTES de generar el import
 
 ### 5. Controllers y DI
-- Controllers importan desde `./di.js` (feature con DI propia) o `@/setting/dependencies/<name>.di.js` (feature sin DI propia)
+- Controllers importan desde `./di.js` (feature di.ts)
 - Prohibido importar desde `bootstrap.di.js` — ese archivo no existe en la arquitectura actual
 
 ### 6. Tests

package/skills/forge/reference/quench.md

@@ -33,7 +33,7 @@ Valida que el proyecto cumpla las reglas arquitectónicas.
 | R5 | Ciclo de dependencias | ERROR | Ciclo detectado en el grafo de features |
 | R6 | infra → domain/feature | WARNING | Infraestructura no debe importar dominio interno |
 
-El grafo se construye automáticamente con `scripts/graph.mjs` y las violaciones se incluyen en `scripts/detect.mjs` (categoría `graph`).
+El grafo se construye automáticamente con `{{AGENT_PATH}}/scripts/graph.mjs` y las violaciones se incluyen en `{{AGENT_PATH}}/scripts/detect.mjs` (categoría `graph`).
 
 ## Checklist pre-migración
 

package/skills/forge/scripts/detect.mjs

@@ -1128,7 +1128,7 @@ export function checkImportConventions(features) {
           label: `[R12] Import desde bootstrap.di.js — no existe en arquitectura actual`,
           pass: false,
           detail: `${relative(ROOT, f)}:${imp.line} → "${src}"`,
-          fix: `Reemplazar por "./di.js" (feature con DI propia) o "@/setting/dependencies/<feature>.di.js" (feature sin DI propia)`,
+          fix: `Reemplazar por "./di.js" (feature di.ts — fuente única de registro)`,
         });
         score -= 3;
       }

package/skills/forge/scripts/forgeSmith.mjs

@@ -119,7 +119,7 @@ function checkProposedContentViolations(filePath, content) {
         severity: "CRITICAL",
         label: `[R12] Import a bootstrap.di.js — no existe en esta arquitectura`,
         detail: `${filePath}:${lineNum} → "${src}"`,
-        fix: 'Usar "./di.js" o "@/setting/dependencies/<feature>.di.js"',
+        fix: 'Usar "./di.js" (feature di.ts — fuente única de registro)',
       });
     }
   }

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

@@ -74,13 +74,13 @@ En esencia:
 
 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
+1. **`{{AGENT_PATH}}/scripts/context.mjs`** — Detectar stack, platform, features, shared, infra, grafo, estado
+2. **`{{AGENT_PATH}}/scripts/armorer.mjs`** — Detectar ownership, huérfanos, duplicados, mal ubicados
+3. **`{{AGENT_PATH}}/scripts/profile.mjs`** — Determinar perfil tecnológico
+4. **`{{AGENT_PATH}}/scripts/graph.mjs`** — Construir grafo arquitectónico global (4 capas + 9 reglas)
+5. **`{{AGENT_PATH}}/scripts/chain.mjs`** — Analizar dependencias multi-capa
+6. **`{{AGENT_PATH}}/scripts/inspect.mjs`** — Auditoría completa con ownership + platform
+7. **`{{AGENT_PATH}}/scripts/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
@@ -109,17 +109,17 @@ inspect=$(node {{AGENT_PATH}}/scripts/inspect.mjs --json 2>/dev/null)
 | "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` |
+| "cadena", "grafo", "acoplamiento" | `chain` | `{{AGENT_PATH}}/scripts/chain.mjs` |
 | "inscribir", "grabar", "ARCHITECTURE.md" | `inscribe` | `reference/inscribe.md` |
-| "grafo", "graph", "nodo", "violaciones", "risk score" | `graph` | `scripts/graph.mjs` |
+| "grafo", "graph", "nodo", "violaciones", "risk score" | `graph` | `{{AGENT_PATH}}/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` |
+| "fijar", "pinar", "atajo", "shortcut" | `nail` | `{{AGENT_PATH}}/scripts/pin.mjs` |
+| "desfijar", "despinar", "remover atajo" | `unnail` | `{{AGENT_PATH}}/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` |
+| "api", "contrato", "openapi", "swagger", "graphql" | `forge api` | `{{AGENT_PATH}}/scripts/forge-api.mjs` |
+| "rollback", "restaurar", "deshacer", "backup" | `forge rollback` | `{{AGENT_PATH}}/scripts/rollback.mjs` |
+| "estado", "state", "último audit" | `forge state --show` | `{{AGENT_PATH}}/scripts/forge-state.mjs` |
 | "examinar","calidad", "assay", "opinión", "personas", "critique", "evaluación cualitativa" | `assay` | `reference/assay.md` |
 
 ---
@@ -128,14 +128,14 @@ inspect=$(node {{AGENT_PATH}}/scripts/inspect.mjs --json 2>/dev/null)
 
 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`
+1. **Contexto**: Ejecutar `{{AGENT_PATH}}/scripts/context.mjs` + `{{AGENT_PATH}}/scripts/armorer.mjs` + `{{AGENT_PATH}}/scripts/profile.mjs`
+2. **Grafo**: Ejecutar `{{AGENT_PATH}}/scripts/graph.mjs` + `{{AGENT_PATH}}/scripts/chain.mjs`
+3. **Auditoría**: Ejecutar `{{AGENT_PATH}}/scripts/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`)
+6. **Verificar**: Ejecutar `{{AGENT_PATH}}/scripts/detect.mjs` para verificar que no se introdujeron violaciones
+7. **forgeSentinel**: Ejecutar `{{AGENT_PATH}}/scripts/forgeSentinel.mjs --reminder`
+8. **Actualizar ARCHITECTURE.md**: Reflejar el nuevo estado (`{{AGENT_PATH}}/scripts/architecture.mjs`)
 9. **Reportar**: Mostrar resultado al usuario con severidades
 
 ---
@@ -237,14 +237,14 @@ El agente DEBE leer este archivo al inicio de cada interacción y actualizarlo a
 | `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) |
+| `{{AGENT_PATH}}/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 |
+| `{{AGENT_PATH}}/scripts/registry/rules.mjs` | Anti-pattern rule registry (R1-R9 + custom rules desacopladas de detect.mjs) |
+| `{{AGENT_PATH}}/scripts/formatter.mjs` | Output formatter unificado (JSON, tabla, severidad coloreada, scoreBar, formatCheck, formatViolation) |
+| `{{AGENT_PATH}}/scripts/forgeSentinel.mjs` | PostToolUse hook — analiza archivos modificados tras escritura y reporta violaciones |
+| `{{AGENT_PATH}}/scripts/forgeSentinel-lib.mjs` | Lógica compartida para hooks forgeSentinel y forgeSmith |
+| `{{AGENT_PATH}}/scripts/forgeSmith.mjs` | preToolUse gate — previene escrituras con violaciones CRITICAL/ERROR (Cursor) |
+| `{{AGENT_PATH}}/scripts/forgeSmith-admin.mjs` | Gestión de hooks (on/off/status) |
+| `{{AGENT_PATH}}/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) |
@@ -261,16 +261,16 @@ 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 |
+| `{{AGENT_PATH}}/scripts/profile.mjs` | 8 | Detección de perfiles |
+| `{{AGENT_PATH}}/scripts/graph.mjs` | 1 | Grafo vacío |
+| `{{AGENT_PATH}}/scripts/armorer.mjs` | 1 | Ownership vacío |
+| `{{AGENT_PATH}}/scripts/forge-config.mjs` | 2 | Load/save state |
+| `{{AGENT_PATH}}/scripts/chain.mjs` | 1 | Grafo de dependencias vacío |
+| `{{AGENT_PATH}}/scripts/formatter.mjs` | 4 | Output format, colores, JSON |
+| `{{AGENT_PATH}}/scripts/registry/rules.mjs` | 4 | R1-R9, evaluación, custom rules |
+| `{{AGENT_PATH}}/scripts/detect.mjs` (inline ignores) | 5 | parseInlineIgnores, isIgnored |
+| `{{AGENT_PATH}}/scripts/forgeSentinel.mjs` | 1 | PostToolUse hook |
+| `{{AGENT_PATH}}/scripts/assay.mjs` | 4 | Personas, generateAssay, opiniones |
 
 ### Flags adicionales
 

package/skills/forge/templates/agents/opencode/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.
+agent: build
+---
+
+# Forge — Backend Architecture Operating System
+
+Los comandos `/forge-*` están en `{{AGENT_PATH}}/../commands/`.
+La documentación completa está en `{{AGENT_PATH}}/SKILL.md`.

package/skills/forge/templates/feature/controller.ts.md

@@ -5,8 +5,7 @@
 // 1. Nombres de métodos: usar createHandler (no "add", "store", etc.)
 // 2. Si la entidad <Domain> es compartida desde platform/domain/,
 //    importar con path alias: import type { <Domain> } from "@/domain/entities/<Domain>.js";
-// 3. Si el feature NO tiene di.ts propio, el controller se importa desde
-//    @/setting/dependencies/<domain>.di.js en vez de bootstrap.di.js
+// 3. Los use cases se resuelven via @inject() — el di.ts del feature registra las implementaciones
 
 import { injectable, inject } from "tsyringe";
 import type { Request, Response, NextFunction } from "express";

package/skills/forge/templates/feature/di.ts.md

@@ -1,11 +1,15 @@
 ```typescript
 // src/features/<domain>/di.ts
-// DI container wiring para el feature <Domain>.
+// ── FUENTE ÚNICA de registro DI para el feature <Domain> ──
 //
-// NOTA: Si el repositorio exporta un modelo Mongoose (model()) en lugar de una clase,
-// usar container.register() con useValue en vez de registerSingleton.
+// Este archivo es la ÚNICA lugar donde se registran las dependencias de este feature.
+// app.ts importa este archivo para que el contenedor conozca las implementaciones.
+// NUNCA registrar las mismas dependencias en app.ts directamente.
 //
-// Para entidades compartidas desde platform/domain/, usar path alias @/domain/ en vez de relativo.
+// Reglas:
+// - Si el repositorio exporta un modelo Mongoose (model()), usar container.register() con useValue.
+// - Para entidades compartidas desde platform/domain/, usar path alias @/domain/.
+// - No registrar dependencias de otros features aquí.
 
 import { container } from "tsyringe";
 import type { I<Domain>Repository } from "./domain/repositories/I<Domain>.repository.js";

package/src/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { copyFileSync, mkdirSync, existsSync, writeFileSync, readFileSync, cpSync, readdirSync, statSync } from "fs";
+import { copyFileSync, mkdirSync, existsSync, writeFileSync, readFileSync, cpSync, readdirSync, statSync, rmSync } from "fs";
 import { join, dirname, relative } from "path";
 import { fileURLToPath } from "url";
 import { execSync } from "child_process";
@@ -43,6 +43,17 @@ function copyRecursive(src, dest) {
   cpSync(src, dest, { recursive: true, force: true });
 }
 
+function cleanAgentTemplates(skillDest, keepAgent) {
+  const agentsDir = join(skillDest, "templates", "agents");
+  if (!existsSync(agentsDir)) return;
+  for (const entry of readdirSync(agentsDir)) {
+    const entryPath = join(agentsDir, entry);
+    if (statSync(entryPath).isDirectory() && entry !== keepAgent) {
+      rmSync(entryPath, { recursive: true, force: true });
+    }
+  }
+}
+
 function renderSkillPaths(skillDest, skillPath) {
   for (const entry of readdirSync(skillDest)) {
     const fullPath = join(skillDest, entry);
@@ -161,6 +172,7 @@ async function installOpenCode(isGlobal = false) {
 
   s.start("Copiando skill a " + rel);
   copyRecursive(SKILL_SRC, target);
+  cleanAgentTemplates(target, "opencode");
   renderSkillPaths(target, skillPath);
   s.stop("Skill copiada a " + rel);
 
@@ -193,6 +205,7 @@ async function installAgentTemplates(agentDir, agentName) {
   // Copy skill into <agentDir>/skills/forge/
   const skillDest = join(agentDir, "skills", "forge");
   cpSync(SKILL_SRC, skillDest, { recursive: true, force: true });
+  cleanAgentTemplates(skillDest, config.template);
 
   // Copy template files (hooks, CLAUDE.md, .cursorrules, etc.)
   for (const entry of readdirSync(templateDir)) {

package/src/wizard.mjs

@@ -1,6 +1,6 @@
 import pc from "picocolors";
 import { intro, outro, select, multiselect, text, spinner, isCancel, cancel, log, tasks } from "@clack/prompts";
-import { existsSync, mkdirSync, copyFileSync, readdirSync, cpSync, writeFileSync, readFileSync } from "fs";
+import { existsSync, mkdirSync, copyFileSync, readdirSync, cpSync, writeFileSync, readFileSync, statSync, rmSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { execSync } from "child_process";
@@ -93,12 +93,38 @@ function copyAgentTemplate(name, dest) {
   }
 }
 
+function renderSkillPaths(skillDest, skillPath) {
+  for (const entry of readdirSync(skillDest)) {
+    const fullPath = join(skillDest, entry);
+    if (statSync(fullPath).isDirectory()) {
+      renderSkillPaths(fullPath, skillPath);
+    } else if (entry.endsWith(".md")) {
+      const content = readFileSync(fullPath, "utf-8");
+      if (content.includes("{{AGENT_PATH}}")) {
+        writeFileSync(fullPath, content.replace(/\{\{AGENT_PATH\}\}/g, skillPath), "utf-8");
+      }
+    }
+  }
+}
+
+function cleanAgentTemplates(skillDest, keepAgent) {
+  const agentsDir = join(skillDest, "templates", "agents");
+  if (!existsSync(agentsDir)) return;
+  for (const entry of readdirSync(agentsDir)) {
+    const entryPath = join(agentsDir, entry);
+    if (statSync(entryPath).isDirectory() && entry !== keepAgent) {
+      rmSync(entryPath, { recursive: true, force: true });
+    }
+  }
+}
+
 const AGENT_SKILL_PATHS = {
   claude: ".claude/skills/forge",
   cursor: ".cursor/skills/forge",
   codex:  ".agents/skills/forge",
   gemini: ".gemini/skills/forge",
   agents: ".agents/skills/forge",
+  opencode: ".opencode/skills/forge",
 };
 
 function installAgentTemplates(agentDir, agentName) {
@@ -110,18 +136,23 @@ function installAgentTemplates(agentDir, agentName) {
   // Copy skill into <agentDir>/skills/forge/
   const skillDest = join(agentDir, "skills", "forge");
   cpSync(SKILL_SRC, skillDest, { recursive: true, force: true });
+  cleanAgentTemplates(skillDest, agentName);
   // Copy template files (hooks, CLAUDE.md, .cursorrules, etc.)
   copyAgentTemplate(agentName, agentDir);
 
+  const skillPath = AGENT_SKILL_PATHS[agentName] || agentName;
+
   // Render SKILL.md with agent-specific path
   const templatePath = join(AGENTS_TEMPLATES, "SKILL.md.template");
   if (existsSync(templatePath)) {
     const template = readFileSync(templatePath, "utf-8");
-    const skillPath = AGENT_SKILL_PATHS[agentName] || agentName;
     const rendered = template.replace(/\{\{AGENT_PATH\}\}/g, skillPath);
     writeFileSync(join(skillDest, "SKILL.md"), rendered, "utf-8");
   }
 
+  // Render {{AGENT_PATH}} in remaining .md files (command/forge.md, reference/*.md)
+  renderSkillPaths(skillDest, skillPath);
+
   // Codex special case: also copy hooks.json to .codex/
   if (agentName === "codex") {
     const codexDir = join(process.cwd(), ".codex");
@@ -351,10 +382,13 @@ function buildAgentSteps(agent, cwd) {
   if (agent.id === "opencode-global") {
     const dest = join(HOME, ".config", "opencode", "skills", "forge");
     const configDir = join(HOME, ".config", "opencode");
+    const skillPath = join(".config", "opencode", "skills", "forge");
     const steps = [];
     steps.push(s("Copiando Skill en opencode/", async () => {
       mkdirSync(dest, { recursive: true });
       cpSync(SKILL_SRC, dest, { recursive: true, force: true });
+      cleanAgentTemplates(dest, "opencode");
+      renderSkillPaths(dest, skillPath);
       return "Skill copiada";
     }));
     steps.push(s("Registrando comandos + dependencias", async () => {
@@ -372,10 +406,13 @@ function buildAgentSteps(agent, cwd) {
   if (agent.id === "opencode-project") {
     const dest = join(cwd, ".opencode", "skills", "forge");
     const configDir = join(cwd, ".opencode");
+    const skillPath = join(".opencode", "skills", "forge");
     const steps = [];
     steps.push(s("Copiando Skill en .opencode/", async () => {
       mkdirSync(dest, { recursive: true });
       cpSync(SKILL_SRC, dest, { recursive: true, force: true });
+      cleanAgentTemplates(dest, "opencode");
+      renderSkillPaths(dest, skillPath);
       return "Skill copiada";
     }));
     steps.push(s("Registrando comandos + dependencias", async () => {
@@ -440,6 +477,7 @@ async function installPhase(result, cwd) {
     steps.push(s("Instalando Forge en ruta personalizada", async () => {
       mkdirSync(dest, { recursive: true });
       cpSync(SKILL_SRC, join(dest, "forge"), { recursive: true, force: true });
+      cleanAgentTemplates(join(dest, "forge"), "claude");
       copyAgentTemplate("claude", dest);
       return "Forge instalado";
     }));