@ronaldjdevfs/forge 1.3.3 → 1.3.6

package/README.md

@@ -1,6 +1,6 @@
 <img src="favicon.svg" alt="Forge Logo" width="100" height="100">
 
-> **v1.3.2** — Domain Subdirectory Structure & Port Support
+> **v1.3.6** — Multi-Agent Path Resolution Fix
 
 ## Forge — Backend Architecture Operating System
 
@@ -29,10 +29,10 @@ Los proyectos backend degeneran en código acoplado porque la infraestructura t
 |-----------|---------|-------------|
 | **Proyecto nuevo** | `forge` | Inicializa platform/features/shared/infra, detecta stack, crea `ARCHITECTURE.md` |
 | **Crear un nuevo dominio** | `cast` | Genera un feature completo desde cero (verifica platform/shared/infra primero) |
-| **Auditar arquitectura** | `inspect` | Evaluación completa 110pts → 0-100 con ownership, platform y grafo |
+| **Auditar arquitectura** | `inspect` | Evaluación completa 180pts → 0-100 con ownership, platform, grafo e import conventions |
 | **Migrar código legacy** | `relocate` | Traslada código a platform/, shared/, infra/ o features/ |
 | **Refactorizar** | `reforge` | Reestructura features o componentes multi-capa |
-| **Validar reglas** | `quench` | Verifica 9 reglas arquitectónicas (R1-R9) |
+| **Validar reglas** | `quench` | Verifica 12 reglas arquitectónicas (R1-R12) |
 | **Endurecer DI** | `temper` | Aplica inyección por constructor, elimina service locators |
 | **Analizar dependencias** | `chain` | Grafo multi-capa (platform, features, shared, infra), orden topológico, ciclos |
 | **Documentar** | `inscribe` | Genera/actualiza `ARCHITECTURE.md` con métricas, ownership y violaciones |
@@ -72,16 +72,20 @@ src/features/<name>/
 
 ### `inspect` — Auditoría arquitectónica
 
-Evalúa 6 categorías contra un máximo de 110 puntos (normalizado a 0-100):
+Evalúa 10 categorías contra un máximo de 180 puntos (normalizado a 0-100):
 
 | Categoría | Puntos | Qué mide |
 |-----------|--------|----------|
-| Structure | 20 | Organización de platform, features, shared, infra |
-| Layers | 20 | Aislamiento entre capas, imports prohibidos |
+| Structure | 30 | Organización de platform, features, shared, infra |
+| Layers | 25 | Aislamiento entre capas, imports prohibidos |
+| Decorators | 20 | Decoradores @injectable()/@inject() en use cases, controllers, repos |
 | Ownership | 20 | Huérfanos, duplicados, mal ubicados |
 | Platform | 15 | Completitud del backbone técnico (config, server, logger, di, etc.) |
 | Dependencies | 15 | Dirección de dependencias, ciclos, edges inválidos |
 | 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 |
 
 **Resultado**: Score 0-100 con grado A-F y severidades por cada violación.
 
@@ -116,6 +120,10 @@ Ejecuta 9 reglas arquitectónicas (R1-R9) con severidad:
 | R7 | `infra → feature` (prohibido) | WARNING |
 | R8 | Cross-feature direct imports | ERROR |
 | 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 |
+| R12b | `registerSingleton` con model() de Mongoose | CRITICAL |
 
 ### `temper` — Endurecimiento de DI
 
@@ -311,8 +319,8 @@ Ver `reference/patterns.md` para el detalle completo.
 - **4 dominios arquitectónicos**: Platform (backbone), Features (negocio), Shared (código puro), Infra (implementaciones)
 - **Architecture graph como fuente de verdad**: 6 tipos de nodo (platform, feature, shared, infra, domain, adapter), 9 reglas (R1-R9), risk score y dependency health
 - **Ownership automático**: Detección de huérfanos, duplicados, componentes mal ubicados y sugerencias de reubicación
-- **Scoring arquitectónico**: 110 puntos en 6 categorías, normalizado a 0-100 con grado A-F
-- **5 perfiles tecnológicos predefinidos**: Express + MongoDB, Express + PostgreSQL, Express + Prisma, Fastify + Prisma, NestJS + Prisma
+- **Scoring arquitectónico**: 180 puntos en 10 categorías, normalizado a 0-100 con grado A-F
+- **10 perfiles tecnológicos predefinidos**: Express + MongoDB, Express + PostgreSQL, Express + Prisma, Express + Drizzle, Fastify + MongoDB, Fastify + PostgreSQL, Fastify + Prisma, NestJS + MongoDB, NestJS + PostgreSQL, NestJS + Prisma
 - **Boot sequence obligatoria**: 9 pasos que garantizan contexto completo antes de cualquier acción
 - **Documentación automática**: `ARCHITECTURE.md` vivo que se actualiza tras cada operación
 - **Sin dependencias runtime**: Solo Node ≥ 18, todo corre con scripts ESM propios
@@ -358,7 +366,7 @@ Donde vive toda la inteligencia arquitectónica:
 | `scripts/profile.mjs` | Matchea stack contra perfiles conocidos o sintetiza uno genérico |
 | `scripts/graph.mjs` | Grafo completo: 6 tipos de nodo, 4 capas, 9 reglas (R1-R9), risk score, dependency health |
 | `scripts/chain.mjs` | Grafo multi-capa (platform, features, shared, infra) con orden topológico |
-| `scripts/detect.mjs` | Validación de reglas R1-R9 con inline ignores y `--fix` |
+| `scripts/detect.mjs` | Validación de reglas R1-R12 con inline ignores, `--fix` e import conventions |
 | `scripts/inspect.mjs` | Orquesta auditoría completa con reporte coloreado |
 | `scripts/architecture.mjs` | Genera/actualiza `ARCHITECTURE.md` vivo |
 | `scripts/bootstrap.mjs` | Inicializa platform/shared/infra según perfil (interno) |
@@ -385,7 +393,7 @@ Donde vive toda la inteligencia arquitectónica:
 | `reference/assay.md` | Documentación del comando assay |
 | `reference/hooks.md` | Documentación del sistema de hooks |
 | `profiles/` | 10 perfiles tecnológicos detallados |
-| `templates/feature/` | 17 templates TypeScript para features |
+| `templates/feature/` | 19 templates TypeScript para features |
 | `templates/platform/` | 6 templates para componentes de platform |
 | `templates/shared/` | 4 templates para shared (errors, contracts, types, utils) |
 | `templates/infra/` | 4 templates para infra (prisma, mongodb, redis, mail) |

package/package.json

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

package/skills/forge/SKILL.md

@@ -75,7 +75,7 @@ En esencia:
 ANTES de cualquier acción, Forge DEBE ejecutar `forge-boot.mjs` con la profundidad adecuada al comando:
 
 ```bash
-boot=$(node .opencode/skills/forge/scripts/forge-boot.mjs --depth <depth> --json 2>/dev/null)
+boot=$(node {{AGENT_PATH}}/scripts/forge-boot.mjs --depth <depth> --json 2>/dev/null)
 ```
 
 La profundidad (`--depth`) depende del comando (ver Execution Flow):
@@ -150,6 +150,17 @@ El boot usa caché de `.forge/cache/`. Si los archivos `src/` no cambiaron, los
 - 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]`.
 
+### ⚠️ Regla de Platform: Sin lógica de dominio
+
+Cuando `reforge` o `relocate` operen sobre `src/platform/`, verificar que los archivos movidos/creados no contengan lógica de dominio:
+
+- **No** mover entidades, value objects, casos de uso, mappers de dominio, schemas de entidades, repositorios de dominio a `platform/`
+- **No** crear archivos con sufijos `.entity.ts`, `.uc.ts`, `.mapper.ts`, `.repository.ts` (domain), `.port.ts` dentro de `platform/`
+- **No** importar desde `features/` dentro de `platform/` (viola R2)
+- Si un componente tiene imports hacia `domain/` o `features/`, pertenece a un feature, no a platform
+
+Platform solo acepta: config, database, http, server, logger, cache, security, events, scheduler, observability, di.
+
 ### Inline Ignores
 
 Forge soporta comentarios inline para excepcionar violaciones línea por línea:
@@ -182,7 +193,7 @@ El agente DEBE leer este archivo al inicio de cada interacción y actualizarlo a
 Forge incluye tests unitarios con `node:test` (sin dependencias externas).
 
 ```bash
-node --test .opencode/skills/forge/tests/core.test.mjs
+node --test {{AGENT_PATH}}/tests/core.test.mjs
 ```
 
 | Módulo | Tests | Descripción |

package/skills/forge/command/forge.md

@@ -30,13 +30,13 @@ Si el subcomando NO tiene flags en $ARGUMENTS y tiene flags disponibles (ver tab
 Inicializa el proyecto arquitectónicamente. Ejecuta context + bootstrap + profile + armorer + graph + chain + inscribe.
 
 ```
-node .opencode/skills/forge/scripts/context.mjs
-node .opencode/skills/forge/scripts/bootstrap.mjs
-node .opencode/skills/forge/scripts/profile.mjs
-node .opencode/skills/forge/scripts/armorer.mjs
-node .opencode/skills/forge/scripts/graph.mjs
-node .opencode/skills/forge/scripts/chain.mjs
-node .opencode/skills/forge/scripts/architecture.mjs
+node {{AGENT_PATH}}/scripts/context.mjs
+node {{AGENT_PATH}}/scripts/bootstrap.mjs
+node {{AGENT_PATH}}/scripts/profile.mjs
+node {{AGENT_PATH}}/scripts/armorer.mjs
+node {{AGENT_PATH}}/scripts/graph.mjs
+node {{AGENT_PATH}}/scripts/chain.mjs
+node {{AGENT_PATH}}/scripts/architecture.mjs
 ```
 
 ### cast
@@ -52,7 +52,7 @@ Migra un feature existente. Puede targetizar platform/, shared/, infra/ o featur
 Genera ARCHITECTURE.md con grafo arquitectónico, ownership y platform.
 
 ```
-node .opencode/skills/forge/scripts/architecture.mjs
+node {{AGENT_PATH}}/scripts/architecture.mjs
 ```
 
 ### graph
@@ -60,13 +60,13 @@ node .opencode/skills/forge/scripts/architecture.mjs
 Construye el grafo arquitectónico del proyecto (4 capas: platform, feature, shared, infra) con reglas R1-R9.
 
 ```
-node .opencode/skills/forge/scripts/graph.mjs
+node {{AGENT_PATH}}/scripts/graph.mjs
 ```
 
 Para salida JSON:
 
 ```
-node .opencode/skills/forge/scripts/graph.mjs --json
+node {{AGENT_PATH}}/scripts/graph.mjs --json
 ```
 
 ### smelt
@@ -78,7 +78,7 @@ Extrae código reutilizable a shared/ (solo código puro, sin dependencias infra
 Inicializa platform, shared e infra layers (uso interno, se ejecuta automáticamente).
 
 ```
-node .opencode/skills/forge/scripts/bootstrap.mjs
+node {{AGENT_PATH}}/scripts/bootstrap.mjs
 ```
 
 ## Evaluate
@@ -88,13 +88,13 @@ node .opencode/skills/forge/scripts/bootstrap.mjs
 Audita la conformidad arquitectónica completa. 6 categorías: structure(20), layers(20), ownership(20), platform(15), dependencies(15), graph(20).
 
 ```
-node .opencode/skills/forge/scripts/inspect.mjs
+node {{AGENT_PATH}}/scripts/inspect.mjs
 ```
 
 Para salida JSON:
 
 ```
-node .opencode/skills/forge/scripts/inspect.mjs --json
+node {{AGENT_PATH}}/scripts/inspect.mjs --json
 ```
 
 ### assay
@@ -102,16 +102,16 @@ node .opencode/skills/forge/scripts/inspect.mjs --json
 Ensayo arquitectónico multi-persona. Interpretación cualitativa del audit desde 5 perspectivas (Bezos, Fowler, Hacker, PM, Arquitecta Senior).
 
 ```
-node .opencode/skills/forge/scripts/assay.mjs
+node {{AGENT_PATH}}/scripts/assay.mjs
 ```
 
 Filtros:
 
 ```
-node .opencode/skills/forge/scripts/assay.mjs --persona=bezos
-node .opencode/skills/forge/scripts/assay.mjs --json
-node .opencode/skills/forge/scripts/assay.mjs --save
-node .opencode/skills/forge/scripts/assay.mjs history
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=bezos
+node {{AGENT_PATH}}/scripts/assay.mjs --json
+node {{AGENT_PATH}}/scripts/assay.mjs --save
+node {{AGENT_PATH}}/scripts/assay.mjs history
 ```
 
 ### quench
@@ -119,7 +119,7 @@ node .opencode/skills/forge/scripts/assay.mjs history
 Valida reglas arquitectónicas R1-R9.
 
 ```
-node .opencode/skills/forge/scripts/detect.mjs
+node {{AGENT_PATH}}/scripts/detect.mjs
 ```
 
 ### chain
@@ -127,13 +127,13 @@ node .opencode/skills/forge/scripts/detect.mjs
 Orden topológico de dependencias multi-capa (platform, features, shared, infra).
 
 ```
-node .opencode/skills/forge/scripts/chain.mjs
+node {{AGENT_PATH}}/scripts/chain.mjs
 ```
 
 Para salida JSON:
 
 ```
-node .opencode/skills/forge/scripts/chain.mjs --json
+node {{AGENT_PATH}}/scripts/chain.mjs --json
 ```
 
 ### armorer
@@ -141,7 +141,7 @@ node .opencode/skills/forge/scripts/chain.mjs --json
 Reporte de ownership: huérfanos, duplicados, componentes mal ubicados.
 
 ```
-node .opencode/skills/forge/scripts/armorer.mjs
+node {{AGENT_PATH}}/scripts/armorer.mjs
 ```
 
 ## Refine

package/skills/forge/reference/assay.md

@@ -23,26 +23,26 @@ Genera un **ensayo arquitectónico multi-persona** que evalúa el estado actual
 
 ```bash
 # Ensayo completo con todas las personas
-node .opencode/skills/forge/scripts/assay.mjs
+node {{AGENT_PATH}}/scripts/assay.mjs
 
 # Solo la opinión de una persona
-node .opencode/skills/forge/scripts/assay.mjs --persona=bezos
-node .opencode/skills/forge/scripts/assay.mjs --persona=fowler
-node .opencode/skills/forge/scripts/assay.mjs --persona=hacker
-node .opencode/skills/forge/scripts/assay.mjs --persona=pm
-node .opencode/skills/forge/scripts/assay.mjs --persona=senior
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=bezos
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=fowler
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=hacker
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=pm
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=senior
 
 # Salida JSON (para consumo por herramientas)
-node .opencode/skills/forge/scripts/assay.mjs --json
+node {{AGENT_PATH}}/scripts/assay.mjs --json
 
 # Persistir ensayo en .forge/assay/
-node .opencode/skills/forge/scripts/assay.mjs --save
+node {{AGENT_PATH}}/scripts/assay.mjs --save
 
 # Ver historial de ensayos
-node .opencode/skills/forge/scripts/assay.mjs history
+node {{AGENT_PATH}}/scripts/assay.mjs history
 
 # Leer un ensayo previo
-node .opencode/skills/forge/scripts/assay.mjs read assay-2026-06-25T00-00-00.md
+node {{AGENT_PATH}}/scripts/assay.mjs read assay-2026-06-25T00-00-00.md
 ```
 
 ## Formato de salida

package/skills/forge/reference/cast.md

@@ -143,6 +143,49 @@ Usar el perfil detectado para determinar:
 - Convenciones de imports (rutas relativas vs alias)
 - Componentes de platform a usar (config, logger, http, database)
 
+## ⚠️ Post-Cast: Entity Discovery
+
+Antes de crear `<Name>.entity.ts`, verificar si la entidad ya existe como entidad compartida:
+
+1. **Buscar en `src/platform/domain/entities/<Name>.ts`** — si existe, NO crear entidad local
+2. **Si es compartida**: usar `@/domain/entities/<Name>.js` en vez de path relativo en todos los templates
+3. **Verificar también** `src/shared/contracts/` por interfaces/DTOs existentes
+
+Regla: si la entidad vive fuera del feature, todos los imports deben usar path alias `@/domain/`, no `../../`.
+
+## ⚠️ Post-Cast: DI Wiring
+
+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`
+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
+
+Después del scaffold, generar tests unitarios para cada use case siguiendo `templates/feature/test.ts.md`:
+
+1. Crear `src/features/<name>/__tests__/Create<Name>.test.ts`
+2. Usar `node:test` (sin dependencias externas)
+3. Convenciones de test:
+   - Extension `.js` en imports (no `.ts`)
+   - `as const` para literales de union types: `status: "activo" as const`
+   - `result!` (non-null assertion) cuando execute() retorna `T | null`
+   - `(result as any)._id` si `_id` no existe en el tipo de dominio
+
+## ⚠️ Post-Cast: Import Validation Checklist
+
+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`
+- [ ] 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
+
 ## Post-creación
 
 - `forge quench` — verificar que no hay violaciones

package/skills/forge/reference/chain.md

@@ -54,13 +54,13 @@ container.registerSingleton<ICreditRepository>(
 
 ```bash
 # Grafo de dependencias entre features (API legacy)
-node .opencode/skills/forge/scripts/chain.mjs
+node {{AGENT_PATH}}/scripts/chain.mjs
 
 # Grafo arquitectónico completo (nodos, edges, violaciones)
-node .opencode/skills/forge/scripts/graph.mjs
+node {{AGENT_PATH}}/scripts/graph.mjs
 
 # ARCHITECTURE.md con grafo incluido
-node .opencode/skills/forge/scripts/architecture.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).

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

@@ -85,10 +85,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - run: node .opencode/skills/forge/scripts/detect.mjs
+      - run: node {{AGENT_PATH}}/scripts/detect.mjs
         env:
           FORGE_STRICT: "true"
-      - run: node .opencode/skills/forge/scripts/chain.mjs --json
+      - run: node {{AGENT_PATH}}/scripts/chain.mjs --json
 ```
 
 ---

package/skills/forge/reference/inspect.md

@@ -52,9 +52,9 @@ Inspecciona la conformidad arquitectónica del proyecto.
 ## Ejecución
 
 ```bash
-node .opencode/skills/forge/scripts/inspect.mjs
-node .opencode/skills/forge/scripts/inspect.mjs --json
-node .opencode/skills/forge/scripts/detect.mjs --severity ERROR
+node {{AGENT_PATH}}/scripts/inspect.mjs
+node {{AGENT_PATH}}/scripts/inspect.mjs --json
+node {{AGENT_PATH}}/scripts/detect.mjs --severity ERROR
 
 ## Ver también
 

package/skills/forge/reference/patterns.md

@@ -150,11 +150,70 @@ REST prefiere `/api/v1/resources`. GraphQL schema en `adapters/in/graphql/` dent
 
 ---
 
+## Import Conventions (OBLIGATORIO)
+
+Todo import generado por Forge debe cumplir estas reglas. Violaciones = ERROR en forge quench:
+
+### 1. Prefijo relativo obligatorio
+Los imports locales SIEMPRE deben usar prefijo `./` o `../`. Prohibido el bare specifier:
+```ts
+// ✅ Correcto
+import { X } from "./foo.js";
+import { Y } from "../../bar.js";
+
+// ❌ Incorrecto (bare specifier — se resuelve contra node_modules)
+import { X } from "domain/entities/Task.js";
+import { Y } from "domain/repositories/IRepo.js";
+```
+
+### 2. Extensión .js obligatoria
+Con `moduleResolution: "nodenext"`, todos los imports locales requieren extensión `.js`:
+```ts
+// ✅ Correcto
+import { X } from "./foo.js";
+
+// ❌ Incorrecto
+import { X } from "./foo.ts";
+import { X } from "./foo";
+```
+
+### 3. Path alias para cross-layer
+Usar path alias `@/` para cruzar capas, no paths relativos largos:
+| Capa | Alias | Ejemplo |
+|------|-------|---------|
+| Platform → cualquiera | `@/platform/` | `@/platform/config/App.config.js` |
+| Shared → cualquiera | `@/shared/` | `@/shared/errors/NotFoundError.js` |
+| Infra → cualquiera | `@/infra/` | `@/infra/mongodb/Mongo.config.js` |
+| **Entities compartidas** | **`@/domain/`** | **`@/domain/entities/Task.js`** |
+
+```ts
+// ✅ Correcto — path alias para entidad compartida
+import { Task } from "@/domain/entities/Task.js";
+
+// ❌ Incorrecto — path relativo largo que no resuelve
+import { Task } from "../../../../domain/entities/Task.js";
+```
+
+### 4. Entity Discovery — compartida vs local
+- Si la entidad vive en `src/features/<feature>/domain/entities/` → import relativo (`../../domain/entities/`)
+- Si la entidad vive en `src/platform/domain/entities/` → path alias (`@/domain/entities/`)
+- 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)
+- Prohibido importar desde `bootstrap.di.js` — ese archivo no existe en la arquitectura actual
+
+### 6. Tests
+- Todos los imports con extensión `.js` (nunca `.ts`)
+- Usar `as const` para literales de union types
+- Usar `result!` para valores posiblemente null
+- Usar `(result as any)._id` si `_id` no está en el tipo
+
 ## Export Conventions
 
 - Cada directorio expone un `index.ts` barrel con named exports
 - Usar `export * from "./<Name>.<artifact>.js"` en barrels
 - Preferir `export function` / `export class` sobre `export default`
 - Imports relativos dentro del mismo feature (`../../domain/`)
-- Path alias para cross-layer: `@/platform/`, `@/shared/`, `@/infra/`
+- Path alias para cross-layer: `@/platform/`, `@/shared/`, `@/infra/`, `@/domain/`
 - Extension `.js` en imports (ESM compat): `import { X } from "./foo.js"`

package/skills/forge/reference/principles.md

@@ -28,6 +28,8 @@
 
 12. **Cuatro dominios arquitectónicos con ownership estricto** — Todo backend se modela en cuatro capas: Platform (backbone técnico), Features (negocio), Shared (código puro reutilizable) e Infrastructure (implementaciones concretas). Cada componente tiene un único propietario arquitectónico. Los huérfanos, duplicados y componentes mal ubicados se detectan automáticamente. Las reglas de dependencia entre capas son obligatorias: `feature → platform → infra`, `feature → shared`, `adapter → infra`. Cualquier violación es una degradación arquitectónica.
 
+    **⚠️ Platform es exclusivamente backbone técnico.** Nunca debe contener entidades de dominio, casos de uso, mappers, repositorios de dominio, schemas de entidades, DTOs de negocio ni ninguna lógica con reglas de negocio. Si un archivo en `platform/` tiene sufijos `.entity.ts`, `.uc.ts`, `.mapper.ts`, `.port.ts` o importa desde `features/`, está mal ubicado. Esa lógica pertenece a `src/features/<name>/`. Violar esto introduce acoplamiento `platform → feature` (R2) y contamina el backbone técnico con lógica de dominio (R13).
+
 13. **Errores tipados en el dominio** — Los errores de dominio son clases explícitas, no `throw Error()` genéricos. Viven en `shared/errors/` si son transversales o en `domain/` del feature si son específicos. Los adapters HTTP traducen errores de dominio a códigos HTTP. La capa de aplicación nunca sabe qué códigos HTTP existen. Ver `reference/errors.md`.
 
 14. **Tests como ciudadanos de primera clase** — El dominio y los casos de uso se testean con unit tests sin infraestructura (mocks en las interfaces). Los adapters se testean con integration tests contra infraestructura real. La pirámide de tests es 70% unit / 20% integration / 10% e2e. Sin coverage de use cases no hay aprobación arquitectónica. Ver `reference/testing-patterns.md`.

package/skills/forge/reference/quench.md

@@ -64,13 +64,13 @@ El grafo se construye automáticamente con `scripts/graph.mjs` y las violaciones
 
 ```bash
 # Validación completa
-node .opencode/skills/forge/scripts/detect.mjs
+node {{AGENT_PATH}}/scripts/detect.mjs
 
 # Solo errores y críticos
-node .opencode/skills/forge/scripts/detect.mjs --severity ERROR
+node {{AGENT_PATH}}/scripts/detect.mjs --severity ERROR
 
 # Solo un tipo específico
-node .opencode/skills/forge/scripts/detect.mjs --type layers
+node {{AGENT_PATH}}/scripts/detect.mjs --type layers
 
 ## Ver también
 

package/skills/forge/reference/reforge.md

@@ -23,10 +23,10 @@ Renombra un único archivo según las convenciones de `reference/patterns.md` y
 ### Flujo
 
 1. Identificar la ruta del archivo (relativa a la raíz del proyecto)
-2. Ejecutar `node .opencode/skills/forge/scripts/rename.mjs --detect --file <path>` para detectar violación
+2. Ejecutar `node {{AGENT_PATH}}/scripts/rename.mjs --detect --file <path>` para detectar violación
 3. Si el archivo ya cumple naming, informar y terminar
 4. Mostrar preview del cambio al usuario
-5. Ejecutar `node .opencode/skills/forge/scripts/rename.mjs --file <path>` que:
+5. Ejecutar `node {{AGENT_PATH}}/scripts/rename.mjs --file <path>` que:
    - Renombra físicamente el archivo
    - Escanea todos los `.ts`/`.js` del proyecto
    - Actualiza imports que referencian el path antiguo (relativos y absolutos)
@@ -57,9 +57,9 @@ $ forge reforge src/features/users/domain/userEntity.ts
 1. Ejecutar `forge inspect` para obtener estado actual
 2. Identificar violaciones en el grafo arquitectónico
 3. Identificar ownership problemático (huérfanos, duplicados, mal ubicados)
-4. **Detectar naming violations**: Ejecutar `node .opencode/skills/forge/scripts/rename.mjs --detect --json`
+4. **Detectar naming violations**: Ejecutar `node {{AGENT_PATH}}/scripts/rename.mjs --detect --json`
 5. Si hay naming violations, preguntar al usuario: "¿Corregir naming conventions automáticamente?"
-   - Si acepta, ejecutar `node .opencode/skills/forge/scripts/rename.mjs --all`
+   - Si acepta, ejecutar `node {{AGENT_PATH}}/scripts/rename.mjs --all`
 6. Decidir las acciones correctivas en orden:
    - Violaciones CRITICAL primero (R1, R2, R5, R6)
    - Violaciones ERROR después (R3, R4, R8, R9)
@@ -67,9 +67,15 @@ $ forge reforge src/features/users/domain/userEntity.ts
    - Naming violations (si no se corrigieron en paso 5)
    - Warnings
 7. Ejecutar cambios en el feature o componente
-8. Verificar con `forge rollback verify` — si el score empeora, restaurar
-9. Ejecutar `forge quench` para verificar
-10. Actualizar `ARCHITECTURE.md`
+8. **Eliminar estructura legacy** — después de migrar/refactorizar, limpiar todo el código fuente legacy que ya no tenga referencias activas:
+   - Archivos originales en ubicaciones legacy (`src/domain/`, `src/application/`, `src/adapters/`, etc.)
+   - Barrel files (`index.ts`) que exportaban exclusivamente código legacy
+   - Directorios vacíos que quedaron huérfanos tras la migración
+   - No dejar imports rotos ni archivos sin dueño
+9. Verificar con `forge rollback verify` — si el score empeora, restaurar
+10. Ejecutar `forge quench` para verificar 0 violaciones
+11. Ejecutar `forge armorer` — confirmar ownership saludable (0 huérfanos, 0 duplicados)
+12. Actualizar `ARCHITECTURE.md`
 
 ### Flags
 
@@ -88,11 +94,27 @@ forge rollback list
 forge rollback restore <id>
 ```
 
+## ⚠️ Regla crítica: Platform solo acepta backbone técnico
+
+**Platform NO debe contener lógica de dominio.** Al refactorizar hacia `src/platform/`, verificar que el componente sea exclusivamente técnico:
+
+| ✅ Permitido en Platform | ❌ Prohibido en Platform |
+|---|---|
+| config, server, logger, DI | Entidades de dominio |
+| http, middleware, router | Casos de uso |
+| cache, security, events | Repositorios (domain) |
+| database, scheduler, observability | Mappers de dominio |
+| Conexiones, clientes de infra | Schemas de entidades |
+| Tokens de DI, contenedores | DTOs de negocio |
+| Health checks, métricas | Lógica de reglas de negocio |
+
+Si durante la refactorización un componente tiene lógica de dominio (entidades, `if/switch` con reglas de negocio, casos de uso), **debe ir a `src/features/<name>/`**, no a `platform/`. Violar esto introduce acoplamiento `platform → feature` (R2).
+
 ## Refactorización multi-capa
 
 Reforge ahora considera las cuatro capas arquitectónicas:
 
-- **Platform**: Mover componentes técnicos sueltos a `src/platform/`
+- **Platform**: Mover componentes técnicos sueltos a `src/platform/` (nunca lógica de dominio)
 - **Features**: Reestructurar features con violaciones
 - **Shared**: Extraer código duplicado a `src/shared/`
 - **Infra**: Organizar implementaciones concretas en `src/infra/`

package/skills/forge/reference/relocate.md

@@ -25,10 +25,16 @@ También puede migrar componentes legacy a los layers Platform, Shared o Infrast
 3. Crear la estructura target según el layer
 4. Migrar archivos manteniendo la lógica intacta
 5. Actualizar imports
-6. Eliminar estructura legacy
+6. **Eliminar estructura legacy por completo** — no dejar archivos huérfanos, barrel files (index.ts) vacíos, ni directorios legacy sin contenido. Verificar:
+   - `src/application/use-cases/<name>/` queda vacío y se elimina
+   - `src/adapters/in/http/controllers/` sin archivos del feature migrado
+   - `src/domain/entities/`, `src/domain/repositories/` sin duplicados
+   - `src/setting/dependencies/` sin `.di.ts` del feature migrado
+   - Barrel files (`index.ts`) que solo exportaban código legacy se eliminan
 7. Verificar con `forge rollback verify` — si el score empeora, restaurar con `forge rollback restore <backup-id>`
-8. Ejecutar `forge quench` para verificar
-9. Actualizar `ARCHITECTURE.md`
+8. Ejecutar `forge quench` para verificar 0 violaciones
+9. Ejecutar `forge armorer` — confirmar que no hay huérfanos ni duplicados del código legacy
+10. Actualizar `ARCHITECTURE.md`
 
 ## Rollback
 
@@ -41,6 +47,22 @@ forge rollback restore <id>  # restaurar
 
 El backup se almacena en `.forge/backups/<target>--<timestamp>/` y preserva la estructura original completa.
 
+## ⚠️ Regla crítica: No insertar lógica de dominio en Platform
+
+Al migrar componentes legacy, **nunca colocar lógica de dominio en `src/platform/`**. Platform es exclusivamente backbone técnico.
+
+| Tipo de componente | Layer correcto |
+|---|---|
+| Configuración de framework, servidor, logger, DI | `src/platform/` |
+| Middleware HTTP, routers, guards, interceptors | `src/platform/http/` |
+| Conexiones a BD, clientes Redis, mail | `src/infra/` |
+| Código utilitario puro (sin lógica de negocio) | `src/shared/` |
+| **Entidades, value objects, reglas de dominio** | **`src/features/<name>/domain/`** |
+| **Casos de uso, servicios de aplicación** | **`src/features/<name>/application/`** |
+| **Controladores, repositorios, schemas** | **`src/features/<name>/adapters/`** |
+
+Si un archivo contiene `class`, `interface` con reglas de negocio, `if/switch` con lógica de dominio, o importa desde `features/`, pertenece a un feature, no a platform.
+
 ## Estrategias por layer
 
 | Layer | Desde | Hacia |

package/skills/forge/scripts/armorer.mjs

@@ -246,6 +246,27 @@ export function detectMisplaced(projectRoot = ROOT) {
         suggestion: "Envolver en un adapter dentro de features/<name>/adapters/out/",
       });
     }
+
+    // R13: Platform con lógica de dominio
+    if (isPlatformFile) {
+      const basenamePath = basename(file);
+      const DOMAIN_PATTERNS = /\.(entity|uc|mapper|port|repository)\.(ts|js)$/i;
+      if (DOMAIN_PATTERNS.test(basenamePath)) {
+        misplaced.push({
+          file: relPath,
+          reason: "Platform contiene artefacto de dominio — violación R13",
+          suggestion: "Mover a src/features/<name>/domain/ o application/ según corresponda",
+        });
+      }
+      const featureImportMatch = content.match(featurePattern);
+      if (featureImportMatch) {
+        misplaced.push({
+          file: relPath,
+          reason: "Platform importa de features — violación R2",
+          suggestion: "Platform no debe conocer lógica de negocio. Extraer interfaz a shared/contracts/ o refactorizar.",
+        });
+      }
+    }
   }
 
   return misplaced;