@trycore/spec-build-harness 0.4.0 → 0.5.0

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "trycore-spec-build-harness",
   "displayName": "Trycore — Spec & Build Harness",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Arnés de construcción de dos loops (slice por épica + release gate) para Claude Code, con gates de calidad, estado compartido y OpenSpec. Compañero de @trycore/spec-product-flow. Agnóstico al proyecto.",
   "author": {
     "name": "Trycore",

package/GOVERNANCE.md

@@ -8,8 +8,8 @@ evoluciona con el modelo y el proyecto. No es "instalar y olvidar".
 |---|---|---|
 | Contexto | sección Construcción de CLAUDE.md, `openspec/project.md` | raíz / `openspec/` |
 | Estado | `build-state.json` (+schema, README) | `.claude/state/` |
-| Agentes | 10 agentes de build | `.claude/agents/build/` |
-| Hooks | settings.json + 8 scripts | `.claude/settings.json`, `.claude/hooks/build/` |
+| Agentes | 11 agentes de build | `.claude/agents/build/` |
+| Hooks | settings.json + 9 scripts | `.claude/settings.json`, `.claude/hooks/build/` |
 | Skill | `building-a-slice` (+10 refs) · `building-a-micro-change` (carril ligero de mantenimiento) | `.claude/skills/` |
 | Config | allowlist de stack | `.claude/config/stack-allowlist.json` |
 
@@ -44,6 +44,14 @@ Editar `stack-allowlist.json` SOLO si la sección de requisitos técnicos del PR
 ## Bitácora de cambios de metodología
 Cambios a la política de construcción (unidad de trabajo, gates, DoR/DoD). Aprueba el DRI; van por PR.
 
+- **2026-06-03 · v0.5.0** — Seguro de fuente de diseño + verificación de fidelidad. Nuevo gate de
+  proyecto `design_source` (espejo de scaffold, confirmado por humano; el arnés no genera el prototipo)
+  con hook `design-source-guard.sh`; criterio DoR "fuente de diseño identificada" para slices con UI;
+  gate vivo de inner loop `fidelity` computado en `smoke` por el nuevo agente `ux-fidelity-reviewer`
+  (agnóstico, estático-primero, degrada sin MCP); 7º extension point `DESIGN_SOURCE` en el onboard.
+  Toca gates/DoR/DoD y el schema de estado → aprobado por el DRI (Agent Manager). Origen: revisión de
+  la propuesta externa de visual fidelity.
+
 - **2026-06-02 · v0.4.0** — Carril `building-a-micro-change` + DoR proporcional. El mantenimiento que
   no es producto nuevo (typo, bump de dep permitida, copy/config/docs, fix de pocas líneas) deja de
   modelarse como épica y usa un carril ligero (`fix/*`|`chore/*` → PR, sin `active_slice`), con

package/INSTALL.md

@@ -11,7 +11,7 @@ Es el **compañero** de [`@trycore/spec-product-flow`](https://www.npmjs.com/pac
 | CLI (bin) | `trycore-build` |
 | Plugin | `trycore-spec-build-harness` |
 | Marketplace | `trycore-build` |
-| Versión | `0.3.0` |
+| Versión | `0.5.0` |
 
 Hay **dos canales** de instalación: el **CLI npm** (canónico, recomendado para operar en un
 proyecto) y el **plugin nativo** de Claude Code (conveniencia a nivel usuario). Lee el
@@ -28,7 +28,7 @@ npm install -g @trycore/spec-build-harness
 Esto expone el binario `trycore-build`. Comprueba la versión:
 
 ```bash
-trycore-build --version    # → 0.3.0
+trycore-build --version    # → 0.5.0
 trycore-build --help
 ```
 
@@ -84,10 +84,10 @@ Qué hace `init`:
 
 1. **Verifica requisitos duros** (a menos que uses `--skip-doctor`).
 2. **Siembra los assets** en rutas nativas de Claude Code:
-   - `.claude/agents/build/` — 10 agentes.
+   - `.claude/agents/build/` — 11 agentes.
    - `.claude/commands/opsx/` (10 comandos `/opsx:*`) y `.claude/commands/build/` (`/build:onboard`, `/build:reflect`).
    - `.claude/skills/` — 12 skills (`building-a-slice`, `releasing-a-version`, `openspec-*`).
-   - `.claude/hooks/build/` — 8 hooks bash.
+   - `.claude/hooks/build/` — 9 hooks bash.
 3. **Siembra el estado**: `state/build-state.schema.json` y `state/README.md` se versionan;
    `state/build-state.json` se siembra **vacío y nunca se sobrescribe** (va al `.gitignore`).
 4. **Siembra `config/stack-allowlist.json`** (artefacto del consumidor; lo puebla `/build:onboard`).

package/README.md

@@ -89,12 +89,12 @@ trycore-spec-build-harness/
 ├── METODOLOGIA.md             ← fuente de verdad metodológica (gana ante cualquier skill)
 ├── GOVERNANCE.md              ← gobernanza del paquete + cadencia de auditoría
 ├── .claude-plugin/            ← manifiesto del plugin nativo (canal de conveniencia)
-├── agents/build/              ← 10 agentes revisores (segunda opinión, contexto limpio)
+├── agents/build/              ← 11 agentes revisores (segunda opinión, contexto limpio)
 ├── commands/
 │   ├── opsx/                  ← 10 comandos /opsx:* (ciclo OpenSpec)
 │   └── build/                 ← /build:onboard, /build:reflect
 ├── skills/                    ← 12 skills (building-a-slice, releasing-a-version, 10 openspec-*)
-├── hooks/build/               ← 8 hooks bash (gate-check, reflect-nudge, scaffold-guard, gitflow-guard, stack-guard, …)
+├── hooks/build/               ← 9 hooks bash (gate-check, reflect-nudge, scaffold-guard, gitflow-guard, stack-guard, …)
 ├── state/                     ← máquina de estado: build-state.json + schema + README
 ├── config/                    ← stack-allowlist.template.json (artefacto del consumidor)
 ├── src/ + dist/               ← CLI trycore-build (init/update/status/uninstall/doctor)
@@ -102,7 +102,7 @@ trycore-spec-build-harness/
 └── docs/examples/reference/   ← ejemplo de referencia (fuera del core, excluido de check-agnostic)
 ```
 
-Los **10 agentes** en `agents/build/` son: `build-orchestrator`, `dor-dod-gatekeeper`, `security-reviewer`, `simple-design-reviewer`, `ux-krug-reviewer`, `coherence-three-way` (opus), `stack-guardian`, `api-contract-tester`, `data-consistency-checker` y `change-epic-coherence`.
+Los **11 agentes** en `agents/build/` son: `build-orchestrator`, `dor-dod-gatekeeper`, `security-reviewer`, `simple-design-reviewer`, `ux-krug-reviewer`, `coherence-three-way` (opus), `stack-guardian`, `api-contract-tester`, `data-consistency-checker`, `change-epic-coherence` y `ux-fidelity-reviewer`.
 
 **Estado.** `state/build-state.json` se siembra **vacío** y nunca se sobreescribe (va al `.gitignore`); el schema y el README sí se versionan. `config/stack-allowlist.json` es artefacto del consumidor: lo siembra el CLI y lo puebla `/build:onboard`. `uninstall` preserva `state/` y `config/`.
 
@@ -126,7 +126,9 @@ El core no menciona ningún dominio de cliente. Toda parametrización entra por
 
 - ✅ **v0.1.0** — arnés de dos loops (`building-a-slice` + `releasing-a-version`), 10 agentes, comandos `/opsx:*` + `/build:onboard`, 12 skills, 6 hooks, máquina de estado `build-state.json`, allowlist de stack, CLI `trycore-build` (init/update/status/uninstall/doctor) y plugin nativo. Compañero de `@trycore/spec-product-flow`.
 - ✅ **v0.2.0** — scaffold como "Paso 1 fundamental": gate de proyecto `scaffold.confirmed` (confirmación **explícita**, no auto), Fase 0 en `building-a-slice`, criterio duro de DoR y hook `scaffold-guard.sh`. El arnés **exige** el scaffold pero **no lo genera**.
-- ✅ **v0.3.0 (actual)** — **ciclo autocorrectivo** (hook `reflect-nudge.sh` + comando `/build:reflect`: propone convenciones aprendidas al bloque `trycore-build-learnings` de `CLAUDE.md` tras tu aprobación; campos `reflected`/`reflected_at`) y **LSP opt-in** (`docs/customization/lsp-extensions.md` + sugerencia en `doctor` para stacks tipados). Total: **8 hooks**; comandos `/opsx:*` + `/build:onboard` + `/build:reflect`.
+- ✅ **v0.3.0** — **ciclo autocorrectivo** (hook `reflect-nudge.sh` + comando `/build:reflect`: propone convenciones aprendidas al bloque `trycore-build-learnings` de `CLAUDE.md` tras tu aprobación; campos `reflected`/`reflected_at`) y **LSP opt-in** (`docs/customization/lsp-extensions.md` + sugerencia en `doctor` para stacks tipados). Total: **8 hooks**; comandos `/opsx:*` + `/build:onboard` + `/build:reflect`.
+- ✅ **v0.4.0** — carril `building-a-micro-change` (mantenimiento ligero sin slice) + DoR proporcional a la complejidad.
+- ✅ **v0.5.0 (actual)** — seguro de fuente de diseño (`design_source` + `design-source-guard.sh`) + agente `ux-fidelity-reviewer` (gate `fidelity`, inner loop). Total: **11 agentes**, **9 hooks**.
 
 ## Licencia
 

package/VERSION

@@ -1 +1 @@
-0.4.0
+0.5.0

package/agents/build/build-orchestrator.md

@@ -19,7 +19,10 @@ La **unidad de construcción es la épica** (`active_slice.epica`); las HU que c
 1. dor      → delega en dor-dod-gatekeeper (abre el slice si pasa)
 2. change   → opsx:new + bloque ## Trazabilidad → delega en change-epic-coherence (gate coherence_link, barato)
 3. tdd      → conduce superpowers:test-driven-development (red→green→refactor)
-4. smoke    → recorre el journey-hasta-aquí end-to-end con la skill verify/run (+ chrome-devtools) → gate journey_smoke
+4. smoke    → recorre el journey-hasta-aquí end-to-end con la skill verify/run (+ chrome-devtools) → gate journey_smoke.
+              Slices con UI: con la app levantada, delega en ux-fidelity-reviewer (compara la(s) pantalla(s)
+              contra el DESIGN_SOURCE) y ESCRIBE gates.fidelity desde su veredicto (FIEL/DESVIACIONES
+              justificadas→true; DESVIACIONES→false; INCONCLUSO (MCP no disponible)→deja con nota; sin UI→null).
 5. api/data → api-contract-tester (si hay endpoints) · data-consistency-checker (si toca datos)
 6. dod      → dor-dod-gatekeeper (cierre por slice, DoD reducido)
 7. pr       → abre PR y archiva el change EN EL MISMO PR (opsx:archive + opsx:sync); back-ref en épica y HU
@@ -29,6 +32,8 @@ La **unidad de construcción es la épica** (`active_slice.epica`); las HU que c
 **Los agentes pesados ya NO corren aquí.** `security-reviewer`, `simple-design-reviewer`,
 `ux-krug-reviewer`, `coherence-three-way` y `stack-guardian` (arquitectura) corren **una vez por
 release** en la skill `releasing-a-version`. Las deps las vigila el hook `stack-guard.sh`.
+El `ux-fidelity-reviewer` **sí** corre aquí (en `smoke`): es barato (la app ya está levantada) y vivo
+por-slice; no es la revisión pesada de UX/Krug (esa sigue en `releasing-a-version`).
 
 ## Reglas de orquestación
 - **No saltes gates.** No avances de fase si el gate previo está en `false`. Reporta qué falta.

package/agents/build/dor-dod-gatekeeper.md

@@ -29,12 +29,15 @@ cumplen; lista cada una con ✓/✗:
 5. **Cada HU** pasa los 6 criterios **INVEST** (si dudas, invoca al agente `invest-validator`).
 6. Dependencias declaradas (otras épicas/HU) están en `history[]` del estado o marcadas done.
 7. El alcance de la épica cabe en el stack declarado del PRD (allowlist) (no exige tecnología fuera de la allowlist).
+8. **Fuente de diseño (solo slices con UI)**: si la épica toca UI, `design_source.confirmed===true`
+   (fuente visual de verdad declarada para el proyecto) y la épica apunta a la(s) pantalla(s)
+   equivalente(s) del `DESIGN_SOURCE`. Si no toca UI, este criterio es N/A.
 
 Si DoR pasa: propón abrir `active_slice` con `epica`, `hus` (lista de las HU cubiertas),
 `openspec_change` (kebab del título de la épica), `branch: feature/ep-xxx-<slug>`, `phase: dor`,
-`gates: { dor: true, tdd: false, journey_smoke: false, coherence_link: false, data: false, dod: false }`
-(`api` en `null` si la épica no toca endpoints; añade `data: null`-equivalente omitiéndolo si no toca
-datos). Si falla: reporta ✗ y NO abras el slice.
+`gates: { dor: true, tdd: false, journey_smoke: false, coherence_link: false, data: false, fidelity: false, dod: false }`
+(`api` en `null` si la épica no toca endpoints; **`fidelity` en `null` si la épica NO toca UI**; añade
+`data: null`-equivalente omitiéndolo si no toca datos). Si falla: reporta ✗ y NO abras el slice.
 
 ## Definition of Done (gate `dod`) — antes de archivar (DoD **reducido**, por slice)
 Pasa SOLO si **todos** estos gates del **inner loop** están en `true` (o `null` cuando N/A):
@@ -43,8 +46,10 @@ Pasa SOLO si **todos** estos gates del **inner loop** están en `true` (o `null`
 3. `coherence_link` — `change-epic-coherence` confirma el enlace change↔épica (`openspec validate` ok).
 4. `data` — `data-consistency-checker` verde (si el slice toca datos).
 5. `api` — `api-contract-tester` verde (o `null` si sin endpoints).
-6. Documentación: change con tasks completas; back-ref añadido en la épica y en cada HU de `hus[]`.
-7. Hooks verdes (automáticos): `lint-typecheck.sh`, `stack-guard.sh`, `gitflow-guard.sh`.
+6. `fidelity` — `true` (FIEL o DESVIACIONES justificadas) o `null` (slice sin UI). INCONCLUSO
+   (MCP no disponible) se registra en `notes`, no bloquea. Es gate **vivo** de inner loop, no la revisión Krug.
+7. Documentación: change con tasks completas; back-ref añadido en la épica y en cada HU de `hus[]`.
+8. Hooks verdes (automáticos): `lint-typecheck.sh`, `stack-guard.sh`, `gitflow-guard.sh`.
 
 **NO valides aquí** `security`, `smell`, `ux`, `coherence` (triple completa) ni `stack` (arquitectura):
 esos son del **Release Gate** (`releasing-a-version`, `release-dod.md`), cadencia por release.

package/agents/build/ux-fidelity-reviewer.md

@@ -0,0 +1,61 @@
+---
+name: ux-fidelity-reviewer
+description: Verifica la FIDELIDAD VISUAL de una pantalla de la app corriendo contra la fuente de diseño declarada (el DESIGN_SOURCE del dominio del consumidor). Complementa al ux-krug-reviewer (que mide usabilidad, no fidelidad). Úsalo en slices con UI, en la fase smoke. Emite FIEL / DESVIACIONES / INCONCLUSO / N/A con diferencias concretas y fixes.
+tools: Read, Grep, Glob, Bash
+model: sonnet
+---
+
+Eres el **revisor de fidelidad visual** del arnés de construcción. Read-only sobre el código. Compruebas
+que una pantalla construida **se parece a la fuente de diseño declarada** por el consumidor (el
+`DESIGN_SOURCE` del bloque de dominio de su CLAUDE.md / su PRD). NO juzgas usabilidad (eso es
+`ux-krug-reviewer`): juzgas si **composición, layout, paleta y tipografía** reproducen el diseño.
+
+> Existe porque un re-skin puede acertar los *tokens* (color/fuente) y aun así **ignorar la
+> composición** (p.ej. una sola columna centrada cuando el diseño declara dos paneles).
+
+## Paso 0 — ¿aplica?
+Si el slice **no tiene UI**, devuelve **N/A** y termina (para que el gate `fidelity` quede en `null`),
+igual que `ux-krug-reviewer`.
+
+## Entradas (pídelas si faltan)
+- La(s) pantalla(s) del slice (rutas de la app, p.ej. `<URL-local-del-dev-server>/<ruta>`).
+- La fuente de diseño (`DESIGN_SOURCE`): archivo/URL del prototipo o export, y cómo localizar la
+  pantalla equivalente.
+- Tokens de diseño del proyecto (los que declare el stack del PRD del consumidor: variables CSS, tema,
+  design tokens), si existen.
+
+## Cómo revisar (estático primero, como ux-krug-reviewer)
+- **Estático (primario)**: lee el código de la pantalla (con la librería de UI del stack declarado en
+  el PRD del consumidor) y contrástalo contra la descripción del `DESIGN_SOURCE` y los tokens.
+- **Dinámico (apoyo, si la app corre y hay MCP de inspección de UI habilitado)**: sugiere usar un MCP
+  de inspección de UI (p.ej. **chrome-devtools** para web): `new_page`/`take_screenshot` del prototipo
+  y de la app, y `take_snapshot` (árbol accesible/DOM) para comparar **estructura**, no solo píxeles.
+  Si el MCP **no está disponible** (headless/CI), NO inventes: veredicto **INCONCLUSO (MCP no
+  disponible)** + lo que sí se verifique en estático.
+- **Bifurca por la fuente**: si la fuente de diseño es **renderizable** (prototipo HTML / URL
+  navegable) usa screenshot + snapshot; si **no es navegable** (export de diseño / imagen / PDF),
+  compara contra el export sin `take_snapshot` (no hay DOM que comparar).
+
+## Qué comparar (estructura > píxeles) — ✅ fiel / ⚠️ parcial / ❌ desviación
+- **Layout/composición**: nº y disposición de paneles/columnas, orden de secciones, jerarquía.
+- **Componentes clave presentes**: cada bloque del diseño (barra, hero, tarjetas, footer, callouts) existe.
+- **Paleta**: colores dominantes = tokens declarados; marca usos fuera de paleta.
+- **Tipografía**: familias y escala/peso de titulares vs cuerpo.
+- **Copy estructural**: titulares y CTAs clave coinciden en intención.
+- **Estados**: los estados que el diseño muestra (error, vacío…) existen.
+No penalices desviaciones **justificadas y documentadas** (datos ilustrativos estáticos, copy
+reconciliado por una ADR); lístalas como "desviación intencional". **No pixel-diff** (frágil).
+
+## Salida + mapeo al gate
+Veredicto **FIEL / DESVIACIONES / INCONCLUSO / N/A** + tabla región×veredicto con evidencia + lista
+priorizada de diferencias con su fix (archivo/componente) + desviaciones intencionales aceptadas.
+
+Mapeo que aplicará el `build-orchestrator` al escribir `gates.fidelity`:
+- **FIEL** → `true`
+- **DESVIACIONES** todas justificadas/documentadas → `true`
+- **DESVIACIONES** sin justificar → `false`
+- **N/A** (sin UI) → `null`
+- **INCONCLUSO** (MCP no disponible) → el orquestador deja `gates.fidelity: null` con nota
+  (INCONCLUSO, MCP no disponible) — **no bloquea** el DoD.
+
+Eres read-only: **no editas código ni el estado**. Devuelve el diagnóstico al `build-orchestrator`.

package/commands/build/onboard.md

@@ -1,6 +1,6 @@
 ---
 name: "BUILD: Onboard"
-description: Parametriza el dominio del build harness — capa de servicios externos/IA, lógica determinista, PII, secretos y decisiones de alto impacto. Rellena el bloque marcado de CLAUDE.md y escribe auto-memory. Complementa al CLI trycore-build init (que ya sembró los archivos y el stack mecánico).
+description: Parametriza el dominio del build harness — capa de servicios externos/IA, lógica determinista, PII, secretos, decisiones de alto impacto y fuente de diseño (DESIGN_SOURCE). Rellena el bloque marcado de CLAUDE.md y escribe auto-memory. Complementa al CLI trycore-build init (que ya sembró los archivos y el stack mecánico).
 category: Workflow
 tags: [onboarding, parametrizacion, build-harness, trycore]
 ---
@@ -35,7 +35,7 @@ Stop aquí si no está instalado.
 
 El CLI ya instaló agentes, comandos /opsx:*, hooks y el estado. Ahora voy a parametrizar el
 DOMINIO del arnés (2-3 min) — los puntos de extensión que leen los agentes de calidad
-(security-reviewer, stack-guardian, data-consistency-checker, ux-krug-reviewer, simple-design-reviewer).
+(security-reviewer, stack-guardian, data-consistency-checker, ux-krug-reviewer, simple-design-reviewer, ux-fidelity-reviewer).
 
 Voy a leer tu PRD/openspec para proponer valores y confirmar contigo:
 1. Ruta#ancla del PRD técnico (fuente del stack)
@@ -44,6 +44,7 @@ Voy a leer tu PRD/openspec para proponer valores y confirmar contigo:
 4. Categorías de datos sensibles / PII reguladas
 5. Secretos server-side
 6. Decisiones de alto impacto que exigen explicabilidad en UX
+7. Fuente de diseño / referencia visual (prototipo/export) y pantallas — o "N/A" si no hay UI
 ```
 
 ---
@@ -61,6 +62,9 @@ Voy a leer tu PRD/openspec para proponer valores y confirmar contigo:
    - **Datos sensibles / PII** (`SENSITIVE_DATA_CATEGORIES`): categorías reguladas del dominio.
    - **Secretos server-side** (`SERVER_SIDE_SECRETS`): claves/tokens que jamás van al cliente.
    - **Decisiones de alto impacto** (`HIGH_STAKES_DECISIONS`): decisiones que exigen explicabilidad/justificación en la UI.
+   - **Fuente de diseño** (`DESIGN_SOURCE`): ¿el producto tiene UI? Si sí, ruta/URL de la fuente
+     visual de verdad (prototipo, export de diseño o mockups) y cómo localizar cada pantalla; si no,
+     "N/A". (La escritura del estado `design_source` en `build-state.json` se hace en la Fase 3c.)
 3. Si un punto no aplica al proyecto, registra explícitamente "no aplica" (no lo dejes como `{{...}}`).
 
 ---
@@ -71,7 +75,7 @@ Lee `CLAUDE.md`. Encuentra el bloque entre `<!-- BEGIN trycore-build-harness` y
 
 Reemplaza dentro del bloque los placeholders `{{PRD_TECH_PATH}}`, `{{EXTERNAL_SERVICE_LAYER}}`,
 `{{DETERMINISTIC_LAYER}}`, `{{SENSITIVE_DATA_CATEGORIES}}`, `{{SERVER_SIDE_SECRETS}}`,
-`{{HIGH_STAKES_DECISIONS}}` por los valores confirmados.
+`{{HIGH_STAKES_DECISIONS}}`, `{{DESIGN_SOURCE}}` por los valores confirmados.
 
 **NO toques nada fuera de los markers.**
 
@@ -87,6 +91,16 @@ Si el usuario lo desea y existe `package.json` en el proyecto:
 
 ---
 
+## Fase 3c: (Si hay UI) Confirmar la fuente de diseño en el estado
+
+Espejo de la confirmación de scaffold, para `design_source` en `build-state.json`:
+- Si el producto **tiene UI**: setea `design_source.applies=true`, `source` (el puntero confirmado) y
+  `confirmed=true` **solo si** el usuario confirma que la fuente de diseño existe (con `confirmed_by`,
+  `confirmed_at`). El arnés **no genera** el prototipo.
+- Si **no hay UI**: setea `design_source.applies=false` (el mecanismo de fidelidad queda N/A).
+
+---
+
 ## Fase 4: Guardar en auto-memory
 
 Crear/actualizar memorias **tipo `project`** (los valores cambian por proyecto):
@@ -97,6 +111,7 @@ Crear/actualizar memorias **tipo `project`** (los valores cambian por proyecto):
 - `build_sensitive_data.md` → categorías PII/datos regulados
 - `build_server_side_secrets.md` → secretos server-side
 - `build_high_stakes_decisions.md` → decisiones de alto impacto
+- `build_design_source.md` → fuente de diseño / referencia visual
 
 Cada memoria con frontmatter `type: project`. Agrega entradas a `MEMORY.md`.
 
@@ -113,6 +128,7 @@ Determinista:       <...>
 PII/datos:          <...>
 Secretos:           <...>
 Decisiones clave:   <...>
+Fuente diseño:      <...>
 
 CLAUDE.md actualizado. Auto-memory escrita. Los agentes de calidad ya leen tu dominio.
 
@@ -129,7 +145,7 @@ CLAUDE.md actualizado. Auto-memory escrita. Los agentes de calidad ya leen tu do
 
 ## Guardrails
 
-- No avances sin confirmar los 6 puntos. Si el usuario omite alguno, repregunta o marca "no aplica".
+- No avances sin confirmar los 7 puntos. Si el usuario omite alguno, repregunta o marca "no aplica".
 - Si CLAUDE.md no tiene el bloque marcado (caso raro post-install), pide correr `trycore-build init` (o `update`) antes de seguir.
 - No inventes valores de dominio que no estén en el PRD ni confirmados por el usuario.
 - Si un valor ya existe en memory y cambió, sobrescríbelo (los proyectos evolucionan).

package/dist/lib/settings-merge.js

@@ -18,7 +18,7 @@ function cmd(script) {
 const HOOK_SPECS = [
     { event: 'SessionStart', matcher: 'startup|clear|compact', scripts: ['load-build-state.sh'] },
     { event: 'PreToolUse', matcher: 'Bash', scripts: ['gitflow-guard.sh'] },
-    { event: 'PreToolUse', matcher: 'Write|Edit|MultiEdit', scripts: ['stack-guard.sh', 'scaffold-guard.sh'] },
+    { event: 'PreToolUse', matcher: 'Write|Edit|MultiEdit', scripts: ['stack-guard.sh', 'scaffold-guard.sh', 'design-source-guard.sh'] },
     { event: 'PostToolUse', matcher: 'Write|Edit|MultiEdit', scripts: ['lint-typecheck.sh', 'coherence-flag.sh'] },
     { event: 'Stop', matcher: '.*', scripts: ['build-gate-check.sh', 'reflect-nudge.sh'] },
 ];

package/dist/lib/state-seed.js

@@ -11,6 +11,7 @@ const EMPTY_STATE = {
     version: '1.0',
     harness_phase: 'authoring',
     scaffold: { confirmed: false, confirmed_by: null, confirmed_at: null, notes: '' },
+    design_source: { applies: false, confirmed: false, confirmed_by: null, confirmed_at: null, source: '', notes: '' },
     active_slice: null,
     history: [],
     releases: [],

package/docs/agents.md

@@ -1,6 +1,6 @@
 # Agentes de construcción (`agents/build/`)
 
-Los **10 agentes** de `@trycore/spec-build-harness` ejecutan los *gates* del arnés de
+Los **11 agentes** de `@trycore/spec-build-harness` ejecutan los *gates* del arnés de
 construcción de dos loops. Ninguno edita código de producto: son read-only sobre el
 repositorio (algunos ejecutan tests o levantan la app), diagnostican y **devuelven el
 veredicto al `build-orchestrator`**, que es quien propone la escritura del estado
@@ -27,6 +27,7 @@ veredicto al `build-orchestrator`**, que es quien propone la escritura del estad
 | 8 | `api-contract-tester` | sonnet | Contrato / datos | Gate `api` — pruebas de contrato (Newman/Postman) |
 | 9 | `data-consistency-checker` | sonnet | Contrato / datos | Gate `data` — invariantes y consistencia de datos |
 | 10 | `change-epic-coherence` | sonnet | Trazabilidad | Gate `coherence_link` — enlace change↔épica↔HU |
+| 11 | `ux-fidelity-reviewer` | sonnet | Inner loop · smoke | Gate `fidelity` — fidelidad visual a la fuente de diseño declarada |
 
 ---
 

package/docs/getting-started.md

@@ -73,12 +73,12 @@ trycore-build init
 
 `init` es **idempotente** (re-correrlo es seguro) y siembra:
 
-- **10 agentes** en `.claude/agents/build/` (build-orchestrator, dor-dod-gatekeeper,
+- **11 agentes** en `.claude/agents/build/` (build-orchestrator, dor-dod-gatekeeper,
   security-reviewer, simple-design-reviewer, ux-krug-reviewer, coherence-three-way, stack-guardian,
-  api-contract-tester, data-consistency-checker, change-epic-coherence).
+  api-contract-tester, data-consistency-checker, change-epic-coherence, ux-fidelity-reviewer).
 - **Comandos** `/opsx:*` (10) en `.claude/commands/opsx/` + `/build:onboard` y `/build:reflect` en `.claude/commands/build/`.
 - **12 skills** en `.claude/skills/` (`building-a-slice`, `releasing-a-version`, 10 `openspec-*`).
-- **8 hooks** bash en `.claude/hooks/build/` + permisos mínimos en `settings.json`.
+- **9 hooks** bash en `.claude/hooks/build/` + permisos mínimos en `settings.json`.
 - **Estado**: `.claude/state/build-state.json` (sembrado **vacío** y **nunca** sobreescrito; va al
   `.gitignore`), más el schema y el README versionados.
 - **Config**: `.claude/config/stack-allowlist.json` (artefacto del consumidor; lo siembra el CLI y
@@ -136,7 +136,7 @@ trycore-build doctor
 Comprueba:
 
 - Los **3 requisitos duros** (`git`, `python3`, `openspec`) — **falla con exit 1** si falta alguno.
-- Que los **8 hooks** tengan bit ejecutable (si no, sugiere `trycore-build init --copy` o `chmod +x`).
+- Que los **9 hooks** tengan bit ejecutable (si no, sugiere `trycore-build init --copy` o `chmod +x`).
 - **Doble canal**: si detecta hooks del arnés en `settings.json` (canal CLI) y además instalaste el
   plugin, te recuerda que la cadena de comando es idéntica en ambos canales y Claude Code
   **deduplica** → el hook dispara **una sola vez**. No requiere acción.

package/docs/hooks.md

@@ -1,12 +1,12 @@
 # Hooks del arnés de construcción
 
-Este documento describe los **8 hooks** que `@trycore/spec-build-harness` instala en el proyecto del consumidor. Todos viven en `hooks/build/` (un script bash por hook) y se cablean a los eventos de Claude Code mediante una **cadena de comando única**, idéntica en ambos canales de instalación.
+Este documento describe los **9 hooks** que `@trycore/spec-build-harness` instala en el proyecto del consumidor. Todos viven en `hooks/build/` (un script bash por hook) y se cablean a los eventos de Claude Code mediante una **cadena de comando única**, idéntica en ambos canales de instalación.
 
-Los hooks son el sistema nervioso del arnés: vigilan GitFlow, el stack declarado y el scaffold (bloqueantes), inyectan el estado del build al iniciar la sesión, delegan estilo/typecheck a herramientas, y recuerdan validar trazabilidad, gates abiertos y reflexionar al cerrar un slice. No reemplazan a los agentes ni a las skills; los **complementan** liberando capacidad de razonamiento del modelo y poniendo barandillas mecánicas donde un olvido cuesta caro.
+Los hooks son el sistema nervioso del arnés: vigilan GitFlow, el stack declarado, el scaffold y la fuente de diseño (bloqueantes), inyectan el estado del build al iniciar la sesión, delegan estilo/typecheck a herramientas, y recuerdan validar trazabilidad, gates abiertos y reflexionar al cerrar un slice. No reemplazan a los agentes ni a las skills; los **complementan** liberando capacidad de razonamiento del modelo y poniendo barandillas mecánicas donde un olvido cuesta caro.
 
 ---
 
-## Resumen de los 8 hooks
+## Resumen de los 9 hooks
 
 | Hook | Evento | Matcher | Qué hace | ¿Bloqueante? |
 |---|---|---|---|---|
@@ -14,12 +14,13 @@ Los hooks son el sistema nervioso del arnés: vigilan GitFlow, el stack declarad
 | `gitflow-guard.sh` | `PreToolUse` | `Bash` | Enforce GitHub Flow estricto sobre `git commit` / `git push`. | **Sí (exit 2)** |
 | `stack-guard.sh` | `PreToolUse` | `Write\|Edit\|MultiEdit` | Bloquea dependencias en `package.json` fuera de la allowlist del stack del PRD. | **Sí (exit 2)** |
 | `scaffold-guard.sh` | `PreToolUse` | `Write\|Edit\|MultiEdit` | Bloquea escribir código de slice (fases `red…data`) si el scaffold no está confirmado (`scaffold.confirmed`). | **Sí (exit 2)** |
+| `design-source-guard.sh` | `PreToolUse` | `Write\|Edit\|MultiEdit` | Bloquea escribir código de un slice **con UI** (`gates.fidelity===false`, fases `red…data`) si la fuente de diseño del proyecto no está confirmada (`design_source.confirmed`). | **Sí (exit 2)** |
 | `lint-typecheck.sh` | `PostToolUse` | `Write\|Edit\|MultiEdit` | Corre prettier/eslint/tsc sobre el archivo `.ts`/`.tsx` editado. | No |
 | `coherence-flag.sh` | `PostToolUse` | `Write\|Edit\|MultiEdit` | Recuerda validar la trazabilidad de un `proposal.md` de OpenSpec recién tocado. | No |
 | `build-gate-check.sh` | `Stop` | `.*` | Al cerrar el turno, avisa si el slice activo tiene gates abiertos. | No |
 | `reflect-nudge.sh` | `Stop` | `.*` | Al cerrar el turno, sugiere `/build:reflect` si hay slice(s) archivado(s) sin reflexionar (`reflected != true`). | No |
 
-> Tres bloqueantes (`gitflow-guard`, `stack-guard`, `scaffold-guard`) y cinco informativos. Los bloqueantes usan `exit 2`: Claude Code devuelve el `stderr` al modelo y aborta la herramienta; el resto siempre sale `0`.
+> Cuatro bloqueantes (`gitflow-guard`, `stack-guard`, `scaffold-guard`, `design-source-guard`) y cinco informativos. Los bloqueantes usan `exit 2`: Claude Code devuelve el `stderr` al modelo y aborta la herramienta; el resto siempre sale `0`.
 
 ---
 
@@ -84,6 +85,10 @@ Refuerza el **scaffold como "Paso 1 fundamental"**. Bloquea con `exit 2` la escr
 
 Cierra el **ciclo autocorrectivo**. Al terminar el turno, si en `history[]` hay slice(s) archivado(s) con `reflected != true`, imprime un *nudge* sugiriendo ejecutar `/build:reflect` para capturar las convenciones aprendidas (y errores recurrentes) en el bloque `trycore-build-learnings` de `CLAUDE.md`. **Nunca bloquea** el cierre de sesión: si falta `python3` o el estado, sale `0` en silencio (**fail-open**). El razonamiento —qué se aprendió— vive en el comando `/build:reflect`, no en el hook; este solo recuerda. Tras reflexionar y estampar `reflected: true`, el nudge calla.
 
+### 9. `design-source-guard.sh` — `PreToolUse` · Write/Edit/MultiEdit · **bloqueante** (desde v0.5.0)
+
+Refuerza el **seguro de fuente de diseño** (espejo de `scaffold-guard`, para slices con UI). Bloquea con `exit 2` la escritura de **código de un slice con UI** —cuando `active_slice.phase` ∈ `red`/`green`/`refactor`/`smoke`/`api`/`data` **y** `active_slice.gates.fidelity === false` (marcado UI-pendiente por la DoR)— mientras el proyecto tenga UI (`design_source.applies === true`) y `design_source.confirmed` no sea `true`. **Permite** todo lo demás: slices sin UI (`gates.fidelity === null` o ausente), proyectos sin UI (`applies !== true`), fases de planificación (`dor`/`change`), o fuente ya confirmada. El arnés **exige** la fuente de diseño pero **no genera** el prototipo; la confirmación es **explícita** (vía `building-a-slice` Fase 0-bis / `dor-dod-gatekeeper`), nunca auto-detectada. Guarda `python3` fail-closed dirigido. En la práctica, como `design_source` es gate de proyecto, solo muerde la **primera** construcción de UI sin fuente declarada.
+
 ---
 
 ## La cadena de comando única (sin doble disparo entre canales)
@@ -107,7 +112,7 @@ Como la cadena es **carácter por carácter idéntica** en ambos canales, si el
 
 Los hooks parsean el JSON del evento con `python3`. Qué pasa si **falta** `python3` depende de si el hook es bloqueante:
 
-- **Bloqueantes** (`gitflow-guard`, `stack-guard`, `scaffold-guard`) → **fail-closed dirigido**: si no pueden analizar el comando/edición, solo bloquean (`exit 2`) cuando la entrada *cruda* parece relevante (un `git commit`/`push`, una edición que menciona `package.json`, o código de slice sin scaffold confirmado); en cualquier otro caso salen `0`. Esto evita falsos negativos peligrosos sin frenar el trabajo no relacionado. El mensaje pide instalar `python3` (verificable con `trycore-build doctor`).
+- **Bloqueantes** (`gitflow-guard`, `stack-guard`, `scaffold-guard`, `design-source-guard`) → **fail-closed dirigido**: si no pueden analizar el comando/edición, solo bloquean (`exit 2`) cuando la entrada *cruda* parece relevante (un `git commit`/`push`, una edición que menciona `package.json`, o código de slice sin scaffold/fuente de diseño confirmados); en cualquier otro caso salen `0`. Esto evita falsos negativos peligrosos sin frenar el trabajo no relacionado. El mensaje pide instalar `python3` (verificable con `trycore-build doctor`).
 - **No bloqueantes** (`load-build-state`, `lint-typecheck`, `coherence-flag`, `build-gate-check`, `reflect-nudge`) → si falta `python3`, simplemente **omiten** su trabajo y salen `0` (fail-open).
 
 > `python3` es un **requisito duro**: `trycore-build init` y `trycore-build doctor` **fallan** si no está presente, justo porque toda la cadena de hooks depende de él para leer el JSON del evento.
@@ -126,6 +131,7 @@ Los hooks que tocan el código construido se **auto-arman**: permanecen **inerte
 | `lint-typecheck.sh` | Inerte (sale `0` de inmediato). |
 | `coherence-flag.sh` | Funciona siempre (depende de OpenSpec, no del código). |
 | `scaffold-guard.sh` | Permite (sin slice en fases de código no hay nada que bloquear; también permite crear el scaffold). |
+| `design-source-guard.sh` | Permite (sin slice UI en fases de código, o sin `design_source.applies=true`, no hay nada que bloquear). |
 | `build-gate-check.sh` | Inerte (sale `0` de inmediato). |
 | `reflect-nudge.sh` | Silencioso (en `authoring` no hay slices archivados que reflexionar). |
 
@@ -141,7 +147,7 @@ Una sola definición de hooks, expresada en dos archivos espejo según el canal:
 
 `trycore-build init` hace un **merge idempotente y aditivo** en el `settings.json` del consumidor (lógica en `src/lib/settings-merge.ts`; espejo documental en `templates/settings-hooks.template.json`):
 
-- Agrega las 5 agrupaciones de hooks (las 8 invocaciones: `PreToolUse·Write` agrupa `stack-guard` + `scaffold-guard`; `PostToolUse·Write` agrupa `lint-typecheck` + `coherence-flag`; `Stop` agrupa `build-gate-check` + `reflect-nudge`) sin pisar lo que ya exista.
+- Agrega las 5 agrupaciones de hooks (las 9 invocaciones: `PreToolUse·Write` agrupa `stack-guard` + `scaffold-guard` + `design-source-guard`; `PostToolUse·Write` agrupa `lint-typecheck` + `coherence-flag`; `Stop` agrupa `build-gate-check` + `reflect-nudge`) sin pisar lo que ya exista.
 - Agrega **permisos mínimos y enumerados** (sin `mcp__*` ni rutas absolutas):
 
   ```

package/hooks/build/design-source-guard.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# design-source-guard.sh — PreToolUse · Write/Edit/MultiEdit
+# Backstop determinista del "seguro de fuente de diseño": no se escribe código de un slice
+# CON UI sin que la fuente de diseño del proyecto esté confirmada. Espejo de scaffold-guard.sh.
+# Bloquea (exit 2) SOLO si: hay active_slice en fase de código (red/green/refactor/smoke/api/data),
+# el proyecto tiene UI (design_source.applies===true), el slice está marcado UI-pendiente
+# (gates.fidelity===false) y design_source.confirmed!==true.
+# AUTO-ARME: si no existe build-state.json, exit 0.
+set -uo pipefail
+
+ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo "${CLAUDE_PROJECT_DIR:-$(pwd)}")"
+STATE="$ROOT/.claude/state/build-state.json"
+[ -f "$STATE" ] || exit 0
+
+INPUT="$(cat)"  # consumir stdin (protocolo de hook); la decisión es por estado.
+
+# Guarda python3 [H4]: si falta, no podemos leer el estado de forma fiable. Fail-closed.
+if ! command -v python3 >/dev/null 2>&1; then
+  echo "⛔ design-source-guard: python3 no disponible; no puedo verificar el gate de fuente de diseño. Instala python3 (trycore-build doctor)." >&2
+  exit 2
+fi
+
+VERDICT="$(STATE="$STATE" python3 <<'PY' 2>/dev/null
+import os, sys, json
+try:
+    d = json.load(open(os.environ["STATE"]))
+except Exception:
+    sys.exit(0)  # estado ilegible -> no bloquear (auto-arme)
+slice_ = d.get("active_slice")
+if not slice_:
+    sys.exit(0)  # sin slice: permitir declarar / planificar
+code_phases = {"red", "green", "refactor", "smoke", "api", "data"}
+if slice_.get("phase") not in code_phases:
+    sys.exit(0)  # fases dor/change/pr/archived: permitido
+ds = d.get("design_source") or {}
+if ds.get("applies") is not True:
+    sys.exit(0)  # proyecto sin UI (o indeterminado): mecanismo apagado
+if (slice_.get("gates") or {}).get("fidelity") is not False:
+    sys.exit(0)  # solo UI-pendiente (false) cuenta; null/ausente -> no bloquear
+if ds.get("confirmed") is True:
+    sys.exit(0)  # fuente de diseño confirmada: permitido
+print("BLOCK")
+PY
+)"
+
+if [ "$VERDICT" = "BLOCK" ]; then
+  echo "⛔ design-source-guard: el slice con UI está en fase de código pero la fuente de diseño NO está confirmada." >&2
+  echo "   Declara y confirma primero el DESIGN_SOURCE del proyecto (ver building-a-slice Fase 0-bis / DoR)." >&2
+  echo "   El arnés NO genera el prototipo: declara la fuente (prototipo/export) y confírmala." >&2
+  exit 2
+fi
+exit 0

package/hooks/build-harness.json

@@ -31,6 +31,10 @@
           {
             "type": "command",
             "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/scaffold-guard.sh\""
+          },
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/design-source-guard.sh\""
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trycore/spec-build-harness",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Arnés agéntico de construcción de Trycore para Claude Code: pipeline de dos loops (slice por épica + release gate) con gates de calidad, estado compartido y OpenSpec. Compañero de @trycore/spec-product-flow. Agnóstico al proyecto.",
   "type": "module",
   "bin": {

package/skills/building-a-slice/SKILL.md

@@ -56,6 +56,21 @@ camina* se construye **encima** del scaffold ya existente.
 3. El gate lo valida también el `dor-dod-gatekeeper` (criterio duro de DoR) y lo respalda el hook
    determinista `scaffold-guard.sh` (bloquea escribir código de slice sin scaffold confirmado).
 
+## Fase 0-bis · Fuente de diseño (seguro para slices con UI)
+
+Espejo de la Fase 0, para proyectos **con UI**. Antes de abrir el primer slice con UI:
+1. Lee `design_source` en `build-state.json`.
+   - `applies` indeterminado (ausente) → pregunta *"¿este proyecto tiene UI?"* y fija `applies`.
+   - `applies === false` → N/A, salta esta fase.
+   - `confirmed === true` → continúa.
+2. `applies===true && confirmed===false` → **pregunta explícita** (AskUserQuestion): *"¿Existe una
+   fuente de diseño declarada (prototipo/export) para la UI de este proyecto?"*
+   - **No** → **STOP**. Indica declararla (ruta/URL del prototipo o export). El arnés **NO la genera**.
+     No abras el slice con UI.
+   - **Sí** → registra `design_source.source`, `confirmed=true`, `confirmed_by`, `confirmed_at`, `notes`.
+3. Lo respalda el hook determinista `design-source-guard.sh` (bloquea código de slice UI sin fuente
+   confirmada) y lo valida el `dor-dod-gatekeeper` (criterio duro de DoR).
+
 ## Pipeline — inner loop (carga la referencia indicada en cada paso)
 
 | Fase | Acción | Delega en | Gate | Referencia |
@@ -63,7 +78,7 @@ camina* se construye **encima** del scaffold ya existente.
 | 1 · dor | Validar Definition of Ready | `dor-dod-gatekeeper` | `dor` | `dor.md` |
 | 2 · change | `opsx:new` + bloque `## Trazabilidad`; validar enlace (barato) | `opsx:new`, `change-epic-coherence` | `coherence_link` | `link-change-epic.md` |
 | 3 · tdd | red → green → refactor | `superpowers:test-driven-development` | `tdd` | — |
-| 4 · smoke | Recorrer el journey-hasta-aquí end-to-end | skill `verify` / `run` (+ MCP chrome-devtools) | `journey_smoke` | `mcp-map.md` |
+| 4 · smoke | Recorrer el journey-hasta-aquí end-to-end; **slices con UI:** verificar fidelidad a la fuente de diseño | skill `verify` / `run` (+ MCP chrome-devtools), `ux-fidelity-reviewer` | `journey_smoke`,`fidelity` | `mcp-map.md` |
 | 5 · api/data | contratos + consistencia (si aplican al slice) | `api-contract-tester`, `data-consistency-checker` | `api`,`data` | `newman-tests.md`, `data-consistency.md` |
 | 6 · dod | Definition of Done (por slice, reducido) | `dor-dod-gatekeeper` | `dod` | `dod.md` |
 | 7 · pr | Abrir PR + archivar change en el mismo PR | `opsx:archive`, `opsx:sync` | — | `gitflow.md` |
@@ -73,6 +88,10 @@ Los gates `stack`, `security`, `smell`, `ux` y la coherencia triple completa **y
 aquí**: pertenecen al Release Gate. Las **deps** siguen vigiladas en tiempo real por el hook
 `stack-guard.sh`; lint/tsc/gitflow por sus hooks.
 
+El gate `fidelity` (fidelidad a la fuente de diseño) **sí** es de inner loop: es barato (se computa
+en `smoke`, con la app ya levantada) y vivo por-slice; complementa al `ux-krug-reviewer` (usabilidad),
+que sigue en el Release Gate.
+
 MCP/LSP por gate: ver `references/mcp-map.md`. Protocolo de estado: `references/state-protocol.md`.
 
 ## Fase 8 · ¿Release Gate ahora? (default computado, humano decide)

package/skills/building-a-slice/references/dod.md

@@ -11,6 +11,10 @@ pesadas (seguridad, diseño, UX, coherencia triple, arquitectura, integración)
 - [ ] **`coherence_link`** — `change-epic-coherence` confirma el enlace change↔épica (bloque `## Trazabilidad`, `openspec validate` ok). Es el chequeo **barato**; la trazabilidad triple completa va al Release Gate.
 - [ ] **`data`** — `data-consistency-checker` valida invariantes de datos (salida de servicios externos validada contra esquema antes de alimentar la capa de decisión determinista del dominio) (si el slice toca datos).
 - [ ] **`api`** — `api-contract-tester` (Newman) 100% verde (o `null` si el slice no tiene endpoints).
+- [ ] **`fidelity` (slices con UI)** — `ux-fidelity-reviewer` devuelve **FIEL** (o DESVIACIONES todas
+  justificadas/documentadas) → `gates.fidelity: true`; `null` si el slice no tiene UI. INCONCLUSO
+  (MCP no disponible) se registra, **no bloquea**. Es gate **vivo** de inner loop (no la revisión Krug,
+  que sigue en el Release Gate).
 - [ ] **OpenSpec**: todas las tasks `[x]`; el archive del change va **en el mismo PR** (no PR aparte).
 - [ ] **Docs/trazabilidad**: back-ref del change añadida en la épica y en cada HU de `hus[]`.
 - [ ] **Hooks verdes (automáticos, no son gates de agente)**: `lint-typecheck.sh` (lint + chequeo de tipos del stack declarado), `stack-guard.sh` (deps en allowlist según la sección de requisitos técnicos del PRD del consumidor, ruta declarada en `stack-allowlist.json#source`), `gitflow-guard.sh` (rama `feature/*`, sin commits directos a `main`).

package/skills/building-a-slice/references/dor.md

@@ -11,7 +11,10 @@ la épica; lo de abajo aplica a la épica y a **cada HU** que cubre (`hus[]`). L
 - [ ] **Dependencias resueltas**: las épicas/HU de las que depende están archivadas (`history[]`) o explícitamente no bloquean.
 - [ ] **Cabe en el stack** del PRD §7 (no requiere tecnología fuera de `stack-allowlist.json`).
 - [ ] **Datos de prueba disponibles** o identificables (p.ej. los datos de ejemplo / fixtures sintéticos del dominio del consumidor).
+- [ ] **Fuente de diseño identificada (slices con UI)**: la fuente visual de verdad del slice
+  (el `DESIGN_SOURCE` del dominio) está declarada y confirmada (`design_source.confirmed`), y este
+  slice apunta a la(s) pantalla(s) equivalente(s). No se construye UI fuera de la fuente declarada.
 
 **Si todo ✓** → `dor-dod-gatekeeper` abre `active_slice` en `build-state.json` con `epica`, `hus[]`,
-`phase: dor`, `gates.dor: true` y el resto en `false` (`ux`/`api` en `null` si la épica no toca UI/endpoints).
+`phase: dor`, `gates.dor: true` y el resto en `false` (`fidelity`/`api` en `null` si la épica no toca UI/endpoints).
 **Si algo ✗** → no se abre el slice; se reporta qué falta y se vuelve a discovery (Trycore).

package/skills/building-a-slice/references/mcp-map.md

@@ -15,6 +15,7 @@ los expone, el gate se cubre con las alternativas CLI/test indicadas.
 | Fase / agente | MCP (ejemplo, si habilitado) | Para qué |
 |---|---|---|
 | `review` · `ux-krug-reviewer` | **chrome-devtools** | `take_snapshot` (árbol accesible), `lighthouse_audit` (Accessibility/Best-Practices), `take_screenshot`, `list_console_messages` para verificar la UI **corriendo**. |
+| `smoke` · `ux-fidelity-reviewer` | **chrome-devtools** *(ejemplo opt-in)* | `new_page`/`navigate_page`, `take_screenshot`, `take_snapshot` para comparar **composición/paleta/tipografía** del diseño vs la app corriendo. Requiere la app levantada; úsalo en fase `active`. Si no hay MCP, el agente degrada a comparación estática (INCONCLUSO). |
 | `api` · `api-contract-tester` | — (Newman CLI) | Contratos de endpoints. Newman no es MCP; corre vía Bash. |
 | `data` · `data-consistency-checker` | **postgresql** *(solo si el slice usa Postgres)* | `read_query`/`describe_table` para validar consistencia en BD. Con un almacén embebido/cliente (según el stack declarado en el PRD del consumidor) se valida por tests, sin MCP. |
 | perf (opcional, fuera del DoD) | **k6** | `execute_k6_test` para carga/latencia si una HU de la épica lo exige. |

package/state/README.md

@@ -51,6 +51,17 @@ Arranca en `confirmed: false` y **solo** pasa a `true` por **confirmación expl
 restrictiva para abrir cualquier slice: el hook `scaffold-guard.sh` bloquea escribir código de
 slice (fases `red…data`) mientras `confirmed` no sea `true`. El arnés **no genera** el scaffold.
 
+### `design_source` (gate de proyecto, slices con UI)
+
+Espejo de `scaffold` para la UI: `applies` (¿el proyecto tiene UI?), `confirmed` (humano confirmó que
+existe una fuente de diseño declarada), `source` (puntero al prototipo/export). El arnés NO genera el
+prototipo. Lo respalda `design-source-guard.sh`.
+
+### gate `fidelity` (por-slice, inner loop)
+
+`true` = FIEL (o desviaciones justificadas); `false` = desviaciones sin justificar; `null` = slice sin
+UI. Lo computa `ux-fidelity-reviewer` en la fase `smoke` y lo escribe el `build-orchestrator`.
+
 ### Reflexión post-slice (ciclo autocorrectivo)
 
 Tras archivar un slice, su entrada en `history[]` puede llevar `reflected` / `reflected_at`. El

package/state/build-state.schema.json

@@ -14,6 +14,7 @@
       "description": "Señal INFORMATIVA auto-detectada: authoring = aún no hay package.json; active = scaffold de código presente. El gate de avance es `scaffold.confirmed`, NO esta señal."
     },
     "scaffold": { "$ref": "#/$defs/scaffold" },
+    "design_source": { "$ref": "#/$defs/design_source" },
     "active_slice": {
       "description": "El slice (épica) en construcción. null si no hay ninguno activo.",
       "oneOf": [
@@ -45,6 +46,20 @@
         "notes": { "type": "string", "description": "Evidencia libre (p.ej. 'build/dev arranca vacío sin error')." }
       }
     },
+    "design_source": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Gate de PROYECTO para slices con UI: existe una fuente de diseño declarada (prototipo/export). Espejo de scaffold: confirmed pasa a true SOLO por confirmación humana, nunca por auto-detección. El arnés NO genera el prototipo. applies=false apaga todo el mecanismo (proyecto sin UI).",
+      "required": ["applies", "confirmed"],
+      "properties": {
+        "applies": { "type": "boolean", "description": "¿el proyecto tiene UI / hay diseño que respetar? false → mecanismo N/A." },
+        "confirmed": { "type": "boolean", "description": "true solo tras confirmación humana de que existe una fuente de diseño declarada." },
+        "confirmed_by": { "type": ["string", "null"], "description": "Agente/skill que registró la confirmación." },
+        "confirmed_at": { "type": ["string", "null"], "format": "date-time" },
+        "source": { "type": "string", "description": "Puntero a la fuente: ruta/URL del prototipo o export (el DESIGN_SOURCE del dominio)." },
+        "notes": { "type": "string", "description": "Evidencia libre (p.ej. 'prototipo en docs/… revisado y vigente')." }
+      }
+    },
     "slice": {
       "type": "object",
       "additionalProperties": false,
@@ -75,6 +90,7 @@
             "journey_smoke": { "type": "boolean", "description": "El backbone-hasta-aquí camina end-to-end (verificado con la skill verify/run)." },
             "coherence_link": { "type": "boolean", "description": "Enlace change↔épica válido (change-epic-coherence, barato, por slice)." },
             "data": { "type": "boolean" },
+            "fidelity": { "type": ["boolean", "null"], "description": "Gate VIVO de inner loop (slices con UI): fidelidad visual a la fuente de diseño declarada, computado en fase smoke por ux-fidelity-reviewer. true = FIEL (o DESVIACIONES justificadas); false = DESVIACIONES sin justificar; null = N/A (slice sin UI). NO es legado (los legados viven en releases[])." },
             "api": { "type": ["boolean", "null"], "description": "null = N/A (slice sin endpoints)." },
             "ux": { "type": ["boolean", "null"], "description": "null = N/A (slice sin UI). Legado: hoy se audita en releases[]." },
             "stack": { "type": "boolean", "description": "Legado por-slice; deps las cubre el hook stack-guard.sh, la arquitectura se audita en releases[]." },

package/state/build-state.template.json

@@ -7,6 +7,14 @@
     "confirmed_at": null,
     "notes": ""
   },
+  "design_source": {
+    "applies": false,
+    "confirmed": false,
+    "confirmed_by": null,
+    "confirmed_at": null,
+    "source": "",
+    "notes": ""
+  },
   "active_slice": null,
   "history": [],
   "releases": []

package/templates/CLAUDE.md.template

@@ -35,7 +35,7 @@ Outer loop (por release):       Release Gate (seguridad · diseño · UX · cohe
 ### Bloque de dominio (lo resuelve `/build:onboard`)
 
 Estos puntos de extensión los leen los agentes `security-reviewer`, `stack-guardian`,
-`data-consistency-checker`, `ux-krug-reviewer` y `simple-design-reviewer`:
+`data-consistency-checker`, `ux-krug-reviewer`, `simple-design-reviewer` y `ux-fidelity-reviewer`:
 
 - **PRD técnico (fuente del stack)**: {{PRD_TECH_PATH}}
 - **Capa de servicios externos / IA (frontera)**: {{EXTERNAL_SERVICE_LAYER}}
@@ -43,6 +43,7 @@ Estos puntos de extensión los leen los agentes `security-reviewer`, `stack-guar
 - **Categorías de datos sensibles / PII reguladas**: {{SENSITIVE_DATA_CATEGORIES}}
 - **Secretos server-side**: {{SERVER_SIDE_SECRETS}}
 - **Decisiones de alto impacto que exigen explicabilidad UX**: {{HIGH_STAKES_DECISIONS}}
+- **Fuente de diseño / referencia visual**: {{DESIGN_SOURCE}}
 
 (Si aparecen como `{{...}}`, ejecuta `/build:onboard` para parametrizarlos.)
 

package/templates/settings-hooks.template.json

@@ -13,7 +13,7 @@
     ],
     "PreToolUse": [
       { "matcher": "Bash", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/gitflow-guard.sh\"" } ] },
-      { "matcher": "Write|Edit|MultiEdit", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/stack-guard.sh\"" }, { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/scaffold-guard.sh\"" } ] }
+      { "matcher": "Write|Edit|MultiEdit", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/stack-guard.sh\"" }, { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/scaffold-guard.sh\"" }, { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/design-source-guard.sh\"" } ] }
     ],
     "PostToolUse": [
       { "matcher": "Write|Edit|MultiEdit", "hooks": [ { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/lint-typecheck.sh\"" }, { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT:-$CLAUDE_PROJECT_DIR/.claude}/hooks/build/coherence-flag.sh\"" } ] }