npm - @imolko/ultra-agent - Versions diffs - 0.1.1 → 0.1.2-beta - Mend

@imolko/ultra-agent 0.1.1 → 0.1.2-beta

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/dist-node/payload.d.ts CHANGED Viewed

@@ -10,8 +10,9 @@
 export declare const GATE_RELATIVE_PATH = "scripts/verify-adr-consistency.py";
 /**
  * ¿Es un archivo del registro ADR canónico (tier A/T/P o ADR-0000 o índice raíz)?
- * Un archivo `.md` en la raíz de `docs/adr/` con prefijo propio (p. ej. `G-`) es
- * tier de proyecto y queda excluido.
+ * Cualquier otro `.md` en la raíz de `docs/adr/` es tier de proyecto y queda
+ * excluido: los ADRs nuevos usan el prefijo canónico `PJ-` (ADR-0000) y los ya
+ * aceptados conservan el prefijo con el que fueron aceptados (no se renumeran).
  */
 export declare function isCanonicalAdr(relativePath: string): boolean;
 /**

package/dist-node/payload.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,sCAAsC,CAAC;AAQtE~~;;;;GAIG~~;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAY5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAM5D"}
1	+ {"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,sCAAsC,CAAC;AAQtE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAY5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAM5D"}

package/dist-node/payload.js CHANGED Viewed

@@ -19,8 +19,9 @@ function normalize(path) {
 }
 /**
  * ¿Es un archivo del registro ADR canónico (tier A/T/P o ADR-0000 o índice raíz)?
- * Un archivo `.md` en la raíz de `docs/adr/` con prefijo propio (p. ej. `G-`) es
- * tier de proyecto y queda excluido.
+ * Cualquier otro `.md` en la raíz de `docs/adr/` es tier de proyecto y queda
+ * excluido: los ADRs nuevos usan el prefijo canónico `PJ-` (ADR-0000) y los ya
+ * aceptados conservan el prefijo con el que fueron aceptados (no se renumeran).
  */
 function isCanonicalAdr(relativePath) {
     const path = normalize(relativePath);

package/dist-node/payload.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"payload.js","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;~~AAgBH~~,wCAYC;AAMD,gDAMC;~~AAtCD~~,oFAAoF;AACvE,QAAA,kBAAkB,GAAG,mCAAmC,CAAC;AAEtE,MAAM,SAAS,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAE3D,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED~~;;;;GAIG~~;AACH,SAAgB,cAAc,CAAC,YAAoB;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,IAAI,KAAK,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,KAAe;IAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,0BAAkB,CAAC;IAC7D,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}
1	+ {"version":3,"file":"payload.js","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAiBH,wCAYC;AAMD,gDAMC;AAvCD,oFAAoF;AACvE,QAAA,kBAAkB,GAAG,mCAAmC,CAAC;AAEtE,MAAM,SAAS,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAE3D,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,YAAoB;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,IAAI,KAAK,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,KAAe;IAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,0BAAkB,CAAC;IAC7D,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/docs/adr/ADR-0000-proceso-y-formato-de-adrs.md CHANGED Viewed

@@ -10,7 +10,7 @@
 ## Contexto
-El repositorio Guarura mantiene un registro de decisiones de arquitectura (ADR) distribuido en varios tiers y decenas de archivos. Hasta ahora la información sobre *cómo* se escriben y gobiernan esos ADRs vivía dispersa en las secciones "Formato" y "Tiers" de `docs/adr/index.md`, sin respaldo de decisión: no estaba escrito por qué se usa el formato de Michael Nygard, por qué existen cuatro tiers, ni qué reglas se aplican para mantener la consistencia.
+La metodología ultra mantiene un registro de decisiones de arquitectura (ADR) distribuido en varios tiers y decenas de archivos. Hasta ahora la información sobre *cómo* se escriben y gobiernan esos ADRs vivía dispersa en las secciones "Formato" y "Tiers" de `docs/adr/index.md`, sin respaldo de decisión: no estaba escrito por qué se usa el formato de Michael Nygard, por qué la metodología se organiza en tres tiers más un tier de proyecto, ni qué reglas se aplican para mantener la consistencia.
 Sin un ADR que canonice el proceso, cada decisión nueva corre el riesgo de:
@@ -19,7 +19,7 @@ Sin un ADR que canonice el proceso, cada decisión nueva corre el riesgo de:
 - omitir campos obligatorios como `originally` o las etiquetas;
 - introducir enlaces rotos o listas duplicadas que el gate detecta.
-Este documento es el **meta-ADR**: define el proceso y el formato que el resto de ADRs debe seguir. Vive en la raíz de `docs/adr/` y usa el ID `0000` precisamente porque está **fuera** de la jerarquía A→T/P→G: define esa jerarquía y, por lo tanto, no pertenece a ninguno de sus tiers. Por su nombre no es detectado por el gate de consistencia, lo cual es correcto.
+Este documento es el **meta-ADR**: define el proceso y el formato que el resto de ADRs debe seguir. Vive en la raíz de `docs/adr/` y usa el ID `0000` precisamente porque está **fuera** de la jerarquía A→T/P→tier de proyecto: define esa jerarquía y, por lo tanto, no pertenece a ninguno de sus tiers. Por su nombre no es detectado por el gate de consistencia, lo cual es correcto.
 ## Decisión
@@ -43,7 +43,7 @@ Además del título H1 (`# <ID>: <Título descriptivo>`), cada ADR lleva un **fr
 | `**Enriquecido desde**` | No | Fuente de enriquecimiento posterior (cuando aplica). |
 | `**tags**` | Sí (tier A hoy) | De una a tres etiquetas del vocabulario en [A-043](./foundational/A-043-vocabulario-etiquetas-adrs.md). |
-El gate valida el formato H1 y la ortografía exacta de `originally` (minúsculas) y `Enriquecido desde` (capitalización exacta) para los ADRs de los tiers A/T/P/G.
+El gate valida el formato H1 y la ortografía exacta de `originally` (minúsculas) y `Enriquecido desde` (capitalización exacta) para los ADRs de los tiers A/T/P. El tier de proyecto del consumidor queda fuera del gate distribuido ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)).
 ### Jerarquía de tiers: A → T/P → tier de proyecto
@@ -54,7 +54,7 @@ Los ADRs se organizan en tres tiers de metodología más el tier de proyecto de
 | **Fundacional (A)** | [`foundational/`](./foundational/index.md) | Decisiones metodológicas agnósticas al lenguaje (Clean Architecture, TDD, comandos y consultas, DDD). Aplican a todos los proyectos de Imolko. |
 | **TypeScript (T)** | [`typescript/`](./typescript/index.md) | Decisiones específicas del ecosistema TypeScript/Zod/Node.js. |
 | **Python (P)** | [`python/`](./python/index.md) | Decisiones específicas del ecosistema Python (FastAPI, SQLAlchemy, Pydantic). |
-| **Tier de proyecto** | `docs/adr/` (raíz) u otro directorio del consumidor | Decisiones específicas del dominio del proyecto consumidor. El prefijo es propio de cada proyecto (por ejemplo `G` para Guarura) y no forma parte de la metodología distribuida ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)). |
+| **Tier de proyecto** | `docs/adr/` (raíz) u otro directorio del consumidor | Decisiones específicas del dominio del consumidor. El prefijo canónico es `PJ` (`PJ-NNN`) para todo ADR nuevo, independientemente del nombre del proyecto; los IDs ya aceptados conservan el prefijo con el que fueron aceptados. No forma parte de la metodología distribuida ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)). |
 **Reglas de referencia** (jerarquía estricta):
@@ -64,6 +64,14 @@ Los ADRs se organizan en tres tiers de metodología más el tier de proyecto de
 La numeración es **estable**: los IDs existentes no se renumeran. Los IDs omitidos intencionalmente (por ejemplo A-021) no se reutilizan.
+### Enmienda (2026-10-20): prefijo canónico del tier de proyecto
+Esta enmienda sustituye la regla anterior, que dejaba el prefijo del tier de proyecto a elección de cada proyecto, y precisa el alcance del gate sin cambiar el formato ni la jerarquía:
+- **Prefijo canónico `PJ-NNN`.** Todo ADR nuevo del tier de proyecto del consumidor usa el prefijo `PJ` (`PJ-001`, `PJ-002`, …), independientemente del nombre del proyecto. El nombre de un consumidor concreto no forma parte del formato canónico.
+- **IDs existentes sin renumerar.** Los ADRs del tier de proyecto ya aceptados por un consumidor conservan el prefijo y el número con los que fueron aceptados; la numeración estable de arriba los ampara. No se migran ni se renumeran.
+- **El gate valida solo A, T y P.** La regla `jerarquia` y el resto de reglas del gate se aplican a los tiers de metodología. El tier de proyecto pertenece al consumidor y no se distribuye ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)), así que queda fuera del gate distribuido.
 ### Fases narrativas del tier fundacional
 Los ADRs fundacionales (A-XXX) se agrupan en fases narrativas; el orden y el agrupamiento exactos viven en [`foundational/index.md`](./foundational/index.md), que es quien porta la narrativa. Las fases son una organización de lectura; no cambian la numeración ni los tiers.
@@ -80,7 +88,7 @@ El gate valida **cinco reglas** y debe salir con código `0` y cero violaciones:
 | Regla | Qué valida |
 |-------|------------|
-| `jerarquia` | Los ADRs no referencian tiers prohibidos según la jerarquía A→T/P→tier de proyecto. |
+| `jerarquia` | Los ADRs A/T/P no referencian tiers prohibidos según la jerarquía A→T/P→tier de proyecto, ni por enlace markdown ni por cita en texto plano a un ID con prefijo no permitido para el tier (A solo cita A; T cita A y T; P cita A y P). Cualquier otro prefijo —por ejemplo `G-NNN` o `PJ-NNN`— también es una violación, porque ningún ADR A/T/P referencia el tier de proyecto. |
 | `enlaces` | Todos los enlaces markdown internos (relativos, `*.md`) resuelven a un archivo existente. |
 | `frontmatter` | El título sigue `# <TIER>-<NNN>: Título` y los campos `originally` / `Enriquecido desde` usan la ortografía correcta. |
 | `indices` | Cada ADR aparece en el índice de su tier y el índice no lista ADRs inexistentes. |
@@ -98,7 +106,7 @@ Cada ADR transita por un ciclo de vida simple:
 Reglas de numeración:
-- El siguiente ADR de un tier toma el siguiente número correlativo (`A-NNN`, `T-NNN`, `P-NNN`, o el prefijo propio del tier de proyecto).
+- El siguiente ADR de un tier toma el siguiente número correlativo (`A-NNN`, `T-NNN`, `P-NNN`, `PJ-NNN`).
 - Los IDs omitidos intencionalmente (por ejemplo A-021) **no se reutilizan**: permanecen omitidos para preservar la estabilidad de los IDs existentes.
 ## Consecuencias
@@ -108,7 +116,7 @@ Reglas de numeración:
 - **Proceso canonizado**: el formato, la jerarquía y el gate dejan de vivir dispersos y pasan a tener respaldo de decisión.
 - **Onboarding más corto**: un colaborador nuevo lee un único ADR para entender cómo contribuir decisiones.
 - **Consistencia ejecutable**: el gate automatiza la verificación de las cinco reglas, con salida 0 como criterio de aceptación.
-- **Jerarquía clara**: las reglas de referencia entre tiers evitan acoplamientos incorrectos (por ejemplo, un ADR fundacional citando uno de Guarura).
+- **Jerarquía clara**: las reglas de referencia entre tiers evitan acoplamientos incorrectos (por ejemplo, un ADR fundacional citando uno del tier de proyecto).
 ### Negativas

package/docs/adr/foundational/A-034-canonical-skill-set.md CHANGED Viewed

@@ -6,7 +6,7 @@
 **originally**: mattpocock-skills
-**Enriquecido desde**: mattpocock/skills — taxonomía canónica de skills (engineering + productivity), adaptada al registro ADR de Guarura
+**Enriquecido desde**: mattpocock/skills — taxonomía canónica de skills (engineering + productivity), adaptada al registro ADR de la metodología ultra
 **tags**: agentes, tooling

package/docs/adr/foundational/A-043-vocabulario-etiquetas-adrs.md CHANGED Viewed

@@ -27,7 +27,7 @@ El vocabulario aprobado de etiquetas vive aquí, en el tier fundacional, como fu
 | `agentes` | Colaboradores LLM, bloques de prompt. |
 | `tooling` | Herramientas del flujo de trabajo (gate, scripts, generadores). |
-El campo `**tags**` en sí — su obligatoriedad y su forma — lo define [ADR-0000](../ADR-0000-proceso-y-formato-de-adrs.md); este ADR posee los valores y su semántica. Los tiers T, P y G pueden referenciar este ADR cuando adopten etiquetas.
+El campo `**tags**` en sí — su obligatoriedad y su forma — lo define [ADR-0000](../ADR-0000-proceso-y-formato-de-adrs.md); este ADR posee los valores y su semántica. Los tiers T, P y el tier de proyecto (PJ-) pueden referenciar este ADR cuando adopten etiquetas.
 ## Consecuencias

package/docs/adr/foundational/A-052-distribucion-metodologia-paquete-versionado.md CHANGED Viewed

@@ -19,7 +19,7 @@ El formato de los skills ya es el estándar Agent Skills, agnóstico al harness,
 Distribuir la metodología como un **paquete npm versionado por suscripción**: `@imolko/ultra-agent`. El consumidor instala una versión, la actualiza subiendo de versión y nunca edita el contenido canónico.
 1. **Modelo de suscripción.** El conjunto canónico es de solo lectura en el repositorio consumidor. El consumidor añade sus propios artefactos —skills de proyecto y ADRs de su tier de proyecto— en ubicaciones que el instalador nunca toca. La regla es **«extender, no editar»**: si el consumidor disiente de una decisión canónica, escribe su propio skill o ADR en su espacio, no modifica el canónico.
-2. **Límite de contenido.** Se distribuye solo la metodología: los tiers A, T y P, el meta-ADR `ADR-0000`, el gate de consistencia, los skills canónicos, las extensiones de pi y el **preset de lint** que materializa las reglas ejecutables del tier A — los guardrails aplicables ([A-045](./A-045-guardrails-aplicables-no-directrices.md)) y las reglas estructurales de costura y errores ([A-053](./A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md), [A-054](./A-054-contrato-costura-driver-port-raw-data-canal-error.md)) —. Los ADRs del tier de proyecto de un consumidor concreto (por ejemplo el tier G de Guarura) no forman parte del paquete.
+2. **Límite de contenido.** Se distribuye solo la metodología: los tiers A, T y P, el meta-ADR `ADR-0000`, el gate de consistencia, los skills canónicos, las extensiones de pi y el **preset de lint** que materializa las reglas ejecutables del tier A — los guardrails aplicables ([A-045](./A-045-guardrails-aplicables-no-directrices.md)) y las reglas estructurales de costura y errores ([A-053](./A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md), [A-054](./A-054-contrato-costura-driver-port-raw-data-canal-error.md)) —. Los ADRs del tier de proyecto de cada consumidor (prefijo `PJ-`) no forman parte del paquete.
 3. **Espejo de ADRs.** El instalador copia los tiers A, T y P en el `adr_dir` del consumidor como archivos de solo lectura. La actualización reconcilia el espejo y nunca toca el tier de proyecto ni los READMEs de dominio del consumidor.
 4. **Mecanismo.** Un CLI —`npx @imolko/ultra-agent install | update | status`— materializa el conjunto en las ubicaciones de descubrimiento de cada harness y registra un manifiesto de versión para poder reconciliar después.
 5. **Deriva.** Si el consumidor edita un archivo espejado, `update` falla en voz alta ([A-007](./A-007-data-contract-fail-fast.md)) y solo se resuelve con `--reset`, que respalda antes de sobrescribir. No existe `--keep`: conservar una edición del espejo viola el modelo de solo lectura.

package/docs/adr/foundational/A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md CHANGED Viewed

@@ -15,7 +15,7 @@ Los casos de uso de `features/` producen errores que tienden a duplicarse featur
 - **Referencias de dominio**: la ausencia de un agregado en una consulta ("no existe"). [A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md) ya las clasifica como error de dominio: el puerto de dominio nunca retorna `null`; la ausencia la traduce el adaptador y, en una consulta, se convierte en error de dominio.
 - **Fallos de infraestructura**: producidos en la costura del driver ([A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md), [A-026](./A-026-infraestructura-compartida.md)) — caída de la base de datos, fallo del generador de identificadores, fallo de publicación de eventos —, ajenos al dominio.
-[A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md) clasifica cada especie pero no fija su **hogar**. Sin un hogar canónico, el mismo error vive duplicado por feature y su identidad estable se dispersa según el nombre de la feature. La regla se formalizó primero en el tier de proyecto de Guarura (G-015); al ser independiente del dominio, se eleva aquí al tier fundacional.
+[A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md) clasifica cada especie pero no fija su **hogar**. Sin un hogar canónico, el mismo error vive duplicado por feature y su identidad estable se dispersa según el nombre de la feature. La regla se formalizó primero en el tier de proyecto de un consumidor; al ser independiente del dominio, se eleva aquí al tier fundacional.
 ## Decisión

package/docs/adr/foundational/A-054-contrato-costura-driver-port-raw-data-canal-error.md CHANGED Viewed

@@ -16,7 +16,7 @@ El driver port es la costura raw-data entre el adaptador y el driver tecnológic
 2. **Hasta dónde llega la regla de raw data**. [A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md) la enuncia en general pero la costura de escritura no event-shaped quedaba sin regla escrita: los driver ports podían recibir agregados o value objects del dominio en `save(...)`, haciendo cruzar el objeto con comportamiento por la costura.
 3. **La frontera de «raw»**. «Ningún tipo del dominio cruza la costura» se leía como una regla de dirección de imports ([A-001](./A-001-clean-architecture-4-capas.md)), cuando la frontera real es **raw vs. comportamiento**: las formas serializables sin comportamiento (mementos/snapshots, la envolvente estándar de eventos, DTOs planos) sí cruzan —se declaren donde se declaren—; los objetos con comportamiento (agregados, entidades, value objects) y el hecho de dominio sin confirmar (que porta una referencia de clase, no data) no cruzan.
-El hogar del error de infraestructura ya existe: [A-053](./A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md) decide que los fallos de infraestructura viven en el catálogo compartido de la capa de aplicación y **los produce el adaptador** al traducir el fallo del driver. Faltaba la mitad de la costura: el canal por el que el driver entrega ese fallo. La regla se formalizó primero en el tier de proyecto de Guarura (G-023); al ser independiente del dominio, se eleva aquí al tier fundacional.
+El hogar del error de infraestructura ya existe: [A-053](./A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md) decide que los fallos de infraestructura viven en el catálogo compartido de la capa de aplicación y **los produce el adaptador** al traducir el fallo del driver. Faltaba la mitad de la costura: el canal por el que el driver entrega ese fallo. La regla se formalizó primero en el tier de proyecto de un consumidor; al ser independiente del dominio, se eleva aquí al tier fundacional.
 ## Decisión

package/docs/adr/index.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # Architecture Decision Records (ADR)
-Registro de decisiones de arquitectura canónico del equipo Imolko. Cubre la metodología ultra en tres tiers — fundacional (agnóstico al lenguaje), TypeScript y Python —. Cada proyecto que adopta la metodología añade su propio tier de proyecto con sus decisiones de dominio; el tier G de Guarura fue un ejemplo de tier de proyecto y no forma parte de la metodología distribuida ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)).
+Registro de decisiones de arquitectura canónico del equipo Imolko. Cubre la metodología ultra en tres tiers — fundacional (agnóstico al lenguaje), TypeScript y Python —. Cada repositorio consumidor añade su propio tier de proyecto con sus decisiones de dominio, con el prefijo canónico `PJ-` ([ADR-0000](./ADR-0000-proceso-y-formato-de-adrs.md)), y ese tier no forma parte de la metodología distribuida ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)).
 El proceso, el formato y las reglas que gobiernan estos ADRs están documentados en [ADR-0000: Proceso y formato de los ADRs](./ADR-0000-proceso-y-formato-de-adrs.md).

package/docs/adr/typescript/T-002-test-documentation-jsdoc.md CHANGED Viewed

@@ -35,7 +35,7 @@ it('crear ProductId vacío', () => {
 | `@name` coincide con `it()` | El texto de `@name` debe ser **idéntico** al primer argumento de `it()`. Esto asegura que el título en la documentación generada coincida con el nombre del test en el runner. |
 | `@scenario` describe el qué y por qué | Explica qué entrada se usa, qué regla se ejerce, y qué resultado se espera. Debe ser comprensible para un experto del dominio sin conocimientos técnicos. |
 | Sin "falla si…" en títulos | El título del test (`it()` y `@name`) describe **el escenario**, no el resultado. Ej: `'crear ProductId vacío'` en lugar de `'crear ProductId vacío – falla si está vacío'`. El resultado lo expresa `@scenario`. |
-| Idioma del repo | Los nombres y descripciones van en el idioma del repo (`issue_language`), fijado por [A-003](../foundational/A-003-tdd.md): en Guarura, español. |
+| Idioma del repo | Los nombres y descripciones van en el idioma configurado por el repositorio (`issue_language`), fijado por [A-003](../foundational/A-003-tdd.md): por ejemplo, español. |
 | Primera línea: descripción larga | La primera línea del JSDoc (antes de `@name`) contiene una descripción extendida del comportamiento verificado. |
 > **Ámbito**: la convención aplica a tests que documentan reglas de dominio o comportamiento de casos de uso. Los tests de contrato (validación de esquemas y tipos, por ejemplo `*.contract.spec.ts`) quedan fuera: validan estructura, no reglas de dominio, y no se convierten en casos documentados para expertos del dominio.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@imolko/ultra-agent",
-  "version": "0.1.1",
+  "version": "0.1.2-beta",
   "description": "Metodología ultra como paquete versionado: skills canónicos, registro ADR A/T/P, extensiones de pi y CLI (install/update/status/ship).",
   "license": "MIT",
   "author": {

package/scripts/verify-adr-consistency.py CHANGED Viewed

@@ -2,8 +2,12 @@
 """Gate de consistencia del registro ADR (ADR-0000).
 Valida cinco reglas y sale con código 0 solo si no hay violaciones:
-  - jerarquia    los ADRs no referencian tiers prohibidos (A no referencia T/P/proyecto;
-                 T/P no se referencian entre sí ni al tier de proyecto).
+  - jerarquia    los ADRs no referencian tiers prohibidos (A solo cita A; T cita A y T;
+                 P cita A y P). Detecta tanto enlaces markdown como citas en texto plano a
+                 IDs `<PREFIJO>-NNN`: una cita con un prefijo no permitido para el tier —o
+                 con cualquier otro prefijo, incluidos G y PJ— es una violación, porque
+                 ningún ADR A/T/P referencia el tier de proyecto. Una misma referencia
+                 prohibida se reporta una sola vez aunque aparezca como enlace y como ID.
   - enlaces      todos los enlaces markdown internos (relativos, *.md) resuelven a un
                  archivo existente.
   - frontmatter  el título H1 sigue `# <TIER>-<NNN>: Título` y los campos `originally` /
@@ -102,23 +106,52 @@ ALLOWED_TARGETS = {
     "P": {"A", "P", "meta"},
 }
+# Citas en texto plano a un ID de ADR. Una a dos letras mayúsculas evita falsos
+# positivos con identificadores de tres letras (ISO-8601, RFC-2119, SHA-256).
+PLAIN_ID_RE = re.compile(r"\b([A-Z]{1,2})-\d{3}\b")
+# Destino de un enlace markdown inline `](destino)`. Se elimina antes del escaneo
+# de texto plano para que una referencia no se reporte también como cita.
+LINK_TARGET_RE = re.compile(r"\]\([^)]*\)")
+# Enlace markdown inline completo: etiqueta y destino. La etiqueta puede citar el
+# ID cuando el destino no lo contiene (p. ej. `[T-001](../typescript/index.md)`).
+LINK_RE = re.compile(r"\[([^\]]*)\]\(([^)]*)\)")
 def rule_jerarquia() -> None:
     for tier, allowed in ALLOWED_TARGETS.items():
+        allowed_prefixes = {t for t in allowed if t in TIER_DIRS}
         for adr in tier_adr_files(tier):
             text = adr.read_text(encoding="utf-8")
-            for target in link_targets(text):
+            reported_ids = set()
+            for label, target in LINK_RE.findall(text):
                 resolved = resolve_link(adr, target)
                 if resolved is None:
                     continue
                 resolved_tier = target_tier(resolved)
-                if resolved_tier is None:
+                if resolved_tier is None or resolved_tier in allowed:
                     continue
-                if resolved_tier not in allowed:
-                    report(
-                        "jerarquia",
-                        f"{adr.relative_to(ROOT)} referencia al tier {resolved_tier} ({target}), prohibido para el tier {tier}",
-                    )
+                # Los IDs citados por el enlace —en la etiqueta o en el destino—
+                # quedan cubiertos por esta violación y no se reportan otra vez.
+                for match in PLAIN_ID_RE.finditer(f"{label} {target}"):
+                    reported_ids.add(match.group(0))
+                report(
+                    "jerarquia",
+                    f"{adr.relative_to(ROOT)} referencia al tier {resolved_tier} ({target}), prohibido para el tier {tier}",
+                )
+            plain_text = LINK_TARGET_RE.sub("", text)
+            for match in PLAIN_ID_RE.finditer(plain_text):
+                prefix, ident = match.group(1), match.group(0)
+                if prefix in allowed_prefixes or ident in reported_ids:
+                    continue
+                reported_ids.add(ident)
+                report(
+                    "jerarquia",
+                    f"{adr.relative_to(ROOT)} cita en texto plano {ident} (prefijo {prefix}), prohibido para el tier {tier}",
+                )
 def rule_enlaces() -> None: