@xmarts/genius-setup 1.16.1 → 1.18.0

package/bin/genius-setup.js

@@ -37,6 +37,13 @@ function log(msg) { process.stdout.write(msg + '\n'); }
 const BASE = (arg('base-url', 'https://beesmart.digital')).replace(/\/+$/, '');
 const CLIENT = arg('client', '');
 
+// W-04: single source of the running version — package.json is always present in
+// the published tarball. UA + telemetry report THIS, never a hardcoded literal
+// (the fleet ran with 'XmartsGenius-Setup/1.6.0' frozen across 11 releases).
+let PKG_VERSION = 'unknown';
+try { PKG_VERSION = require('../package.json').version || 'unknown'; } catch (_) {}
+const UA = 'XmartsGenius-Setup/' + PKG_VERSION;
+
 // -----------------------------------------------------------------------------
 // Token resolution (priority order):
 //   1. GENIUS_TOKEN env       — an already-resolved consultant Bearer (back-compat
@@ -78,7 +85,7 @@ function exchangeSetupToken(setupToken, cb) {
       'Content-Type': 'application/json',
       'Content-Length': Buffer.byteLength(payload),
       // Cloudflare in front of beesmart.digital 403s the default Node UA.
-      'User-Agent': 'XmartsGenius-Setup/1.6.0',
+      'User-Agent': UA,
     },
     timeout: 15000,
   }, (res) => {
@@ -152,6 +159,24 @@ function runSetup(token) {
   const guardDst = copyHook('plan_committee_guard.py');
   const presenceDst = copyHook('genius_presence.py');
 
+  // W-04 telemetry stamp: the inject hook reads installed_version + hooks_hash
+  // from config.json and reports them on every /inject, so the server-side
+  // fleet-skew view reflects what each device ACTUALLY runs (0/16 reported
+  // anything before this). Hash = sha256 over the exact hook bytes installed,
+  // in a fixed filename order — drift in any hook file changes it.
+  try {
+    const crypto = require('crypto');
+    const h = crypto.createHash('sha256');
+    ['genius_capture.py', 'genius_inject.py', 'plan_committee_guard.py', 'genius_presence.py']
+      .forEach((f) => {
+        try { h.update(fs.readFileSync(path.join(HOOKS_DIR, f))); } catch (_) {}
+      });
+    const c2 = readJson(cfgPath0);
+    c2.installed_version = PKG_VERSION;
+    c2.hooks_hash = h.digest('hex').slice(0, 64);
+    writeJson(cfgPath0, c2, true);
+  } catch (_) {}
+
   // 2) ~/.claude.json mcpServers (merge, no clobber)
   const claudeJsonPath = path.join(HOME, '.claude.json');
   const claudeJson = readJson(claudeJsonPath);
@@ -309,13 +334,18 @@ function runSetup(token) {
     let url;
     try { url = new URL(BASE + '/xma/genius/v1/mcp/secrets'); } catch (_) { return; }
     const mod = url.protocol === 'http:' ? require('http') : require('https');
-    const payload = JSON.stringify({ jsonrpc: '2.0', method: 'call', id: 1, params: {} });
+    let hooksHash = '';
+    try { hooksHash = readJson(path.join(GENIUS_DIR, 'config.json')).hooks_hash || ''; } catch (_) {}
+    const payload = JSON.stringify({ jsonrpc: '2.0', method: 'call', id: 1, params: {
+      running_version: JSON.stringify({ 'genius-setup': PKG_VERSION }),
+      hooks_hash: hooksHash,
+    } });
     const req = mod.request({
       hostname: url.hostname, port: url.port || (url.protocol === 'http:' ? 80 : 443),
       path: url.pathname, method: 'POST',
       headers: {
         'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(payload),
-        'Authorization': 'Bearer ' + token, 'User-Agent': 'XmartsGenius-Setup/1.6.0',
+        'Authorization': 'Bearer ' + token, 'User-Agent': UA,
       },
       timeout: 15000,
     }, (res) => {

package/hooks/genius_inject.py

@@ -9,7 +9,7 @@ prior knowledge WITHOUT asking. Editor-agnostic (terminal / VSCode / headless).
 
 Hard rules:
 - ALWAYS exit 0 (never block a turn).
-- Time-box the network call (<=2.5s) so injection adds no perceptible latency.
+- Time-box the network call (<=3.5s, TIMEOUT below) so injection stays cheap.
 - Relevance-floored: nothing relevant -> inject nothing (zero noise).
 - Reads endpoint + bearer from ~/.genius/config.json (written by the installer);
   no secret is embedded here.
@@ -61,18 +61,35 @@ def _emit(event_name, context):
     sys.exit(0)
 
 
-def _inject(cfg, prompt):
+def _inject(cfg, prompt, session_id=None):
     base = (cfg.get("base_url") or "https://beesmart.digital").rstrip("/")
     token = cfg.get("token")
     if not token or not prompt.strip():
-        return "", None, None
+        # MUST stay a 4-tuple: main() unpacks 4 values. The historical 3-tuple
+        # here made every empty-prompt turn raise ValueError inside main(),
+        # silently losing BOTH injection and the self-update check for that turn.
+        return "", None, None, None
+    params = {"prompt": prompt[:4000], "limit": 4}
+    # W-04 telemetry: real Claude Code session id (server persists it as the
+    # hint-event session_key, enabling same-session implicit correlation) plus
+    # the installed package version + hooks hash (stamped into config.json by
+    # the installer) so the fleet-skew view knows what each device ACTUALLY runs.
+    if session_id:
+        params["session_id"] = str(session_id)[:128]
+    if cfg.get("installed_version"):
+        params["running_version"] = json.dumps(
+            {"genius-setup": str(cfg["installed_version"])[:32]})
+    if cfg.get("hooks_hash"):
+        params["hooks_hash"] = str(cfg["hooks_hash"])[:64]
     body = json.dumps({"jsonrpc": "2.0", "method": "call", "id": 1,
-                       "params": {"prompt": prompt[:4000], "limit": 4}}).encode()
+                       "params": params}).encode()
     req = urllib.request.Request(base + "/xma/genius/v1/inject", data=body)
     req.add_header("Content-Type", "application/json")
     req.add_header("Authorization", "Bearer %s" % token)
     # Cloudflare in front of beesmart.digital 403s the default Python-urllib UA.
-    req.add_header("User-Agent", "XmartsGenius-Inject/1.0")
+    # Dynamic UA (W-04): report the installed version, not a hardcoded 1.0.
+    req.add_header("User-Agent", "XmartsGenius-Inject/%s"
+                   % (cfg.get("installed_version") or "unknown"))
     try:
         resp = urllib.request.urlopen(req, timeout=TIMEOUT)
         data = json.loads(resp.read())
@@ -90,7 +107,7 @@ def _inject(cfg, prompt):
 # version dictated by the server (xma_genius.hook_pin_version, returned in the
 # inject response) and otherwise fall back to this bundled known-good pin — the
 # client never resolves the mutable `@latest` tag.
-PINNED_FALLBACK = "1.16.1"
+PINNED_FALLBACK = "1.18.0"
 
 
 def _pkg_spec(pin_version):
@@ -260,7 +277,8 @@ def main():
         _maybe_self_update(cfg)   # TTL-only on priming
         _emit("SessionStart", SESSION_PRIMER)
     else:
-        context, force_epoch, pin_version, mcp_epoch = _inject(cfg, event.get("prompt") or "")
+        context, force_epoch, pin_version, mcp_epoch = _inject(
+            cfg, event.get("prompt") or "", session_id=event.get("session_id"))
         # The inject call already round-tripped the server, so honour any
         # admin-pushed force-update epoch here (bypasses the daily TTL) and install
         # the exact server-pinned version (never @latest). A newer MCP manifest

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xmarts/genius-setup",
-  "version": "1.16.1",
-  "description": "One-command, self-updating onboarding for Xmarts Genius (Brain MCP + per-turn injection + automatic session/time capture + presence heartbeat for honest time-tracking 'amarre' + plan/committee→Brain enforcement + CLAUDE.md protocol + MCP fan-out: provisions the consultant's granted MCP servers into Claude Code & Claude Desktop). Secret-free onboarding via single-use setup-token exchange. Installs once; self-updates daily so new tools/skills/features arrive with zero action.",
+  "version": "1.18.0",
+  "description": "One-command, self-updating onboarding for Xmarts Genius (Brain MCP + per-turn injection + automatic session/time capture + presence heartbeat for honest time-tracking 'amarre' + plan/committee\u2192Brain enforcement + CLAUDE.md protocol + MCP fan-out: provisions the consultant's granted MCP servers into Claude Code & Claude Desktop). Secret-free onboarding via single-use setup-token exchange. Installs once; self-updates daily so new tools/skills/features arrive with zero action.",
   "bin": {
     "genius-setup": "bin/genius-setup.js"
   },
@@ -21,4 +21,4 @@
   "license": "UNLICENSED",
   "author": "Xmarts",
   "private": false
-}
+}

package/plugin/skills/cinematic-scroll-site/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: cinematic-scroll-site
+description: Construye sitios "cinematic 3D-scroll" award-winning (efecto Apple: un video que se scrubbea con el scroll como una sola toma de cámara) con la técnica REAL (canvas frame-sequence + Lenis/GSAP), plantilla de brief de un-prompt, y 10 verticales listos (producto de lujo, restaurante, real estate, portafolio, e-commerce, SaaS, agencia, gym...). USAR cuando el usuario pida un sitio cinematic, "3D scroll", "scroll-scrub", una landing premium con video hero, o un sitio para un negocio local. Los assets se generan con higgsfield-video; el gusto lo pone design-taste-frontend; el copy pasa por content-humanizer.
+---
+
+# Cinematic Scroll Site: la técnica real, no la del lead-magnet
+
+Base verificada (Brain #6649, scouts 2026-07-07). El efecto "el video se mueve con
+el scroll como una toma continua" es la firma de estos sitios. La mayoría lo hace mal.
+
+## Regla dura #1: NO se scrubbea un `<video>`
+
+Scrubbear `video.currentTime` con el scroll tartamudea, snapea a keyframes, y FALLA
+en Safari iOS (decodifica para playback, no para seek). Apple NO scrubbea un video:
+dibuja una SECUENCIA DE FRAMES en un `<canvas>`. Caso de producción que lo documenta:
+OPTIKKA (Codrops, 2025-10-16), que migró de `<video>` a frame-sequence justo por esto.
+
+La técnica correcta: `frame = round(scrollProgress * (n-1))`, y `ctx.drawImage(frame)`
+en un solo canvas pinneado a pantalla completa.
+
+## Paso a paso (build-ready)
+
+### 1. Genera el clip y extrae frames
+El clip cinematográfico se genera con `higgsfield-video` (Kling 3.0 default por costo;
+premium solo para el hero final). Luego:
+```bash
+ffmpeg -i clip.mp4 -vf "fps=30" png/frame_%03d.png
+ffmpeg -i png/frame_%03d.png -c:v libwebp -quality 80 webp/frame_%03d.webp
+```
+Target 20 a 60 KB por frame (147 frames a 40 KB = ~6 MB, presupuesto de hero sano).
+Exporta un set REDUCIDO (menos frames, menos resolución) para móvil.
+
+### 2. Un canvas pinneado + el helper oficial de GreenSock
+Nunca cambies el `src` de un `<img>` en scroll (flicker + reflow). Siempre `drawImage`
+a un canvas. Dimensiona el canvas por `devicePixelRatio` y calcula offsets cover-fit.
+```javascript
+gsap.registerPlugin(ScrollTrigger);
+
+function imageSequence(config) {
+  let playhead = { frame: 0 },
+      canvas = gsap.utils.toArray(config.canvas)[0],
+      ctx = canvas.getContext("2d"),
+      curFrame = -1,
+      onUpdate = config.onUpdate,
+      images,
+      updateImage = function () {
+        let frame = Math.round(playhead.frame);
+        if (frame !== curFrame) {
+          config.clear && ctx.clearRect(0, 0, canvas.width, canvas.height);
+          ctx.drawImage(images[frame], 0, 0);
+          curFrame = frame;
+          onUpdate && onUpdate.call(this, frame, images[frame]);
+        }
+      };
+  images = config.urls.map((url, i) => {
+    let img = new Image();
+    img.src = url;
+    i || (img.onload = updateImage); // dibuja el primer frame al cargar
+    return img;
+  });
+  return gsap.to(playhead, {
+    frame: images.length - 1,
+    ease: "none",
+    onUpdate: updateImage,
+    duration: images.length / (config.fps || 30),
+    paused: !!config.paused,
+    scrollTrigger: config.scrollTrigger
+  });
+}
+
+imageSequence({
+  urls: Array.from({ length: 147 }, (_, i) =>
+    `frames/frame_${String(i + 1).padStart(3, "0")}.webp`),
+  canvas: "#hero-canvas",
+  clear: true, // solo si los frames tienen transparencia; omítelo si son opacos full-bleed
+  scrollTrigger: { trigger: ".hero", start: "top top", end: "+=3000", scrub: true, pin: true }
+});
+```
+`end` largo = scrub más lento y cinemático. En React existe `@bsmnt/scrollytelling`
+con un `ImageSequenceCanvas` ya hecho (misma mecánica).
+
+### 3. Preload inteligente
+Primeros ~10 frames eager, el resto por cola en background, prefetch direccional
+(unos frames adelante al bajar, atrás al subir). Dibuja el primer frame en su `onload`.
+
+### 4. Smooth scroll (glue de UNA sola RAF)
+Verbatim del README oficial de Lenis. NO corras además tu propio `requestAnimationFrame`
+para Lenis (double-drive = jitter).
+```javascript
+const lenis = new Lenis();
+lenis.on("scroll", ScrollTrigger.update);
+gsap.ticker.add((time) => { lenis.raf(time * 1000); });
+gsap.ticker.lagSmoothing(0);
+```
+Alternativa: GSAP ScrollSmoother. Nunca los dos a la vez.
+
+## Plantilla de brief de un-prompt
+
+```
+Construye un sitio award-winning cinematic 3D-scroll para <MARCA>.
+VISUALS (higgsfield-video, std 1080p, aspecto 16:9, ~8s/clip, sin audio):
+  genera UNA hero image primero y pásala como referencia a CADA clip (consistencia).
+  <3 a 5 shots, UN movimiento de cámara por shot, numerados>.
+WEBSITE: scroll-scrub del hero como canvas frame-sequence (Lenis + GSAP), secciones
+  pinneadas: <lista de secciones>.
+DESIGN: <fondo> / <acento único> / <tipografía>.
+COPY TONE: <voz>, pocas palabras.
+Launch on localhost and verify <la animación> before telling me it's done.
+```
+Esa última línea (auto-verificación forzada) es nuestra disciplina, no un adorno.
+Ver `references/verticals.md` para los 10 briefs por vertical ya armados.
+
+## Consistencia y encadenado (con honestidad)
+
+- **Hero-image primero:** genera una imagen y úsala como referencia (`input_files`) en
+  cada clip. Best practice DOCUMENTADA de Seedance 2.0 ("faces, clothing, visual style
+  stay locked across shots").
+- **Personas recurrentes:** entrena un Soul ID una vez y reusa su `reference_id`
+  (más fuerte que una imagen suelta).
+- **Encadenar clips:** Seedance 2.0 SÍ acepta start + end frame ("Start & End Frames").
+  Encadenar 5 clips (last-frame de uno como start-frame del siguiente) para "una toma
+  continua sin cortes" es un truco best-effort, NO garantizado por Higgsfield. No lo
+  prometas al cliente. El nombre exacto del param end-frame del MCP no está documentado;
+  resuélvelo en runtime (probe / `extra_params`).
+
+## Defaults de costo (los créditos expiran)
+
+std 1080p, ~8s, sin audio por default. 4K SOLO para el render final. "Compress the
+videos for web" (~-90%). Genera 2 a 3 tomas SOLO del hero (el hero-scrub es ~80% del wow).
+
+## Iterar como director, no como developer
+
+Notas por sensación: "hazlo 20% más lento", "esta sección se siente plana, agrega una
+interacción de cursor sutil", "cambia la tipografía, se ve genérica". El agente traduce
+intención a código.
+
+## Deploy "un prompt más" (Cloudflare Pages, gratis)
+
+1. `git push` de los estáticos a un repo de GitHub.
+2. Dash Cloudflare, Workers & Pages, Create application, Pages, Connect to Git, autoriza
+   el repo.
+3. Build command en BLANCO (HTML plano), Build output directory = carpeta del HTML.
+4. Save and Deploy (30 a 60s, obtienes `proyecto.pages.dev`).
+5. Custom domains, agrega el dominio (si ya está en Cloudflare crea el CNAME solo).
+
+Gotchas: (1) un proyecto Git-integration NO se puede pasar luego a Direct Upload;
+(2) completa el paso de custom-domain en el dash ANTES de agregar el CNAME o da 522;
+(3) records CAA que no permitan Cloudflare bloquean el certificado.
+
+## GTM (empaquetable)
+
+Los verticales restaurante, realtor y gym son un entregable local de $2,000 a $5,000:
+construye un sample, muéstralo a 5 negocios, cobra. Nunca han visto un sitio así.
+
+## Referencia autoritativa (opcional, para el admin)
+
+Para que el agente escriba pin/scrub/refresh/cleanup de GSAP impecables, el admin puede
+sumar a la flota el skill OFICIAL de GreenSock (MIT, auditado seguro):
+`/plugin marketplace add greensock/gsap-skills`. Este skill ya trae la receta inline,
+así que funciona sin él; es un plus, no un requisito.
+
+## Cross-refs
+
+- Assets (imagen/video): `higgsfield-video`, y NanoBanana2 para keyframes.
+- Gusto y anti-slop de diseño: `design-taste-frontend` + el theme engine OKLCH.
+- Copy sin señales de IA: `content-humanizer`.
+- Finishing determinista de clips (grain, Ken Burns, transiciones): `remotion-video`.

package/plugin/skills/cinematic-scroll-site/references/verticals.md

@@ -0,0 +1,92 @@
+# 10 verticales cinematic 3D-scroll (briefs base)
+
+Cada uno: para quién, los shots (3 a 5, UN movimiento de cámara cada uno), las secciones
+pinneadas, y la dirección de diseño. Rellena marca, ciudad y cifras; genera la hero image
+primero y pásala como referencia a cada clip.
+
+## 1. Producto de lujo (relojes, joyería, audio, sneakers)
+- Shots: (1) orbit 360 lento del producto flotando en vacío negro, rim light dramático;
+  (2) macro fly-through sobre el detalle (dial, textura, costura); (3) exploded assembly,
+  el producto se arma desde componentes flotantes.
+- Secciones: hero con el nombre en tracking, historia, macro-detalles, vista técnica con
+  spec callouts, edición limitada + CTA de waitlist.
+- Diseño: fondo off-black, un acento (oro/champagne), serif display alto contraste + sans
+  minimal. Copy: callado, caro, muy pocas palabras.
+
+## 2. Experiencia / storytelling (turismo, expediciones, museos)
+- Shots encadenados (aquí sí conviene el chaining best-effort): un descenso o recorrido
+  por zonas, cada clip termina donde arranca el siguiente. HUD fijo (profundidad, tiempo).
+- Secciones: hero con pregunta, un dato por zona, specs, CTA de reserva.
+- Diseño: color-grade que evoluciona con el scroll, un acento luminoso, sans técnica con
+  micro-detalles tipo instrumento.
+
+## 3. Portafolio personal (creadores, freelancers, consultores)
+- Sube una foto tuya bien iluminada de frente como referencia de identidad en cada clip.
+- Shots: (1) orbit 360 alrededor de ti, brazos cruzados, rim light; (2) tú entre pantallas
+  holográficas con tu trabajo, push-in lento; (3) caminas hacia cámara, pose final.
+- Secciones: nombre en display gigante letra por letra, strip de stats que cuentan al
+  scroll, 3 pilares, grid de trabajo con hover, CTA + socials.
+- Diseño: fondo tinta, un acento, display condensado bold, grano sutil.
+
+## 4. E-commerce / streetwear (drops, merch, ediciones limitadas)
+- Shots: (1) modelo camina hacia cámara entre niebla, el viento mueve la tela; (2) spins
+  1:1 de cada prenda en maniquí invisible, 360 limpio; (3) macro de costura y cierre.
+- Secciones: hero scroll-scrub del walk + countdown, grid de producto (cards que autoplay
+  su spin en hover), manifiesto de calidad, captura de email para tallas agotadas.
+- Diseño: gris concreto + negro mate, un acento ácido, condensada brutalista.
+
+## 5. Restaurante / cafe / bar (LOCAL, vendible $2k a $5k)
+- Shots: (1) macro slow-motion de la proteína sobre fuego, brasas subiendo; (2) dolly lento
+  por el salón en hora dorada; (3) cenital de un plato emplatándose, vapor subiendo.
+- Secciones: hero full-bleed scrub del fuego, historia breve, menú en dos columnas con
+  precios, reservación con formulario de fecha/party-size.
+- Diseño: fondo casi negro, crema cálida, acento ámbar, grano de película, parallax lento.
+  Móvil: menú colapsa a una columna elegante. Usa las fotos reales del negocio.
+
+## 6. Real estate (realtors, desarrollos, rentas vacacionales, hoteles)
+- Shots encadenados en un tour continuo: (1) drone que curva alrededor de la torre al
+  atardecer; (2) del elevador al living; (3) cocina y suite principal; (4) terraza de noche,
+  alberca infinita reflejando el skyline.
+- Secciones: hero, strip de facts (recámaras/baños/m2), galería, amenidades con reveals,
+  precio, "Request a Private Showing" con card del agente.
+- Diseño: fondo tinta, acento champagne-gold, serif delgado, mucho whitespace. Usa las
+  fotos reales de la propiedad como start frames.
+
+## 7. Automotriz / producto grande (autos, drones, bikes, maquinaria)
+- Shots encadenados del producto moviéndose por terreno real, no en estudio: (1) reveal en
+  desierto al amanecer; (2) low tracking shot lanzándose; (3) cañón a velocidad; (4) modo
+  noche, solo su firma de luz.
+- Secciones: hero con el nombre ultrawide, stats que cuentan al scroll, diseño con macro
+  stills, sección night-mode, teaser de configurador, CTA de reserva.
+- Diseño: negro sobre negro, acento cian eléctrico, condensada ultrawide, motion blur sutil.
+
+## 8. SaaS / app (software, herramientas AI, startups)
+- Shots: (1) partículas de datos que se ensamblan en un dashboard flotante que "late";
+  (2) macro sobre charts holográficos, una anomalía roja se enciende; (3) el dashboard en
+  una laptop en oficina minimal luminosa, todo bajo control.
+- Secciones: hero donde el dashboard se construye al scroll, logo strip de social proof,
+  3 bloques de feature, contadores de métricas, screenshot real del producto en mockup de
+  navegador, tabla de pricing (tier medio destacado), FAQ, CTA final.
+- Diseño: hero casi negro que funde a blanco para el body, un acento violeta, sans
+  geométrica, cards glassmorphism. Combo de credibilidad: hero generado + screenshots reales.
+
+## 9. Agencia / estudio creativo
+- Shots: (1) tinta negra floreciendo en agua en slow motion, con destellos de oro;
+  (2) showreel: posters y pantallas con tipografía bold deslizándose por paredes de galería;
+  (3) siluetas de un equipo pequeño trabajando de noche, bokeh de ciudad por la ventana.
+- Secciones: hero con la tinta detrás del nombre en display enorme, manifiesto kinético
+  (una palabra por paso de scroll), grid de casos con hover-video, servicios en dos columnas
+  editoriales, equipo, footer sobredimensionado con CTA.
+- Diseño: negro puro + hueso, oro usado exactamente 3 veces en todo el sitio, mezcla de un
+  display brutalista con un serif refinado. Cursor = punto de oro con estela.
+
+## 10. Gym / fitness (LOCAL, vendible $2k+)
+- Shots: (1) atleta choca manos con tiza en gym oscuro, la nube de tiza florece en un haz de
+  luz cenital; (2) macro tracking por una barra cargada, textura de knurling y tiza;
+  (3) corredor en pista al amanecer, aliento visible, cámara baja y rápida al lado.
+- Secciones: hero scrub de la nube de tiza, filosofía (una línea por paso de scroll), grid
+  de programas con hover, coaches, strip de resultados con contadores, pricing (3 tiers,
+  medio destacado), horario + mapa + formulario.
+- Diseño: fondo carbón, tipo hueso, un acento rojo sangre, display industrial condensado,
+  grano y viñeta en toda la imagen. Móvil: programas en cards swipeables. Usa fotos reales
+  del espacio y su horario y precios.

package/plugin/skills/reasoning-discipline/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: reasoning-discipline
+description: Eleva a CUALQUIER modelo (Opus/Sonnet/Haiku/Fable) a operar con la disciplina de un modelo fuerte, vía 5 compuertas (scoping, evidencia, adversarial, verificación, reporte) + ruteo por modelo/esfuerzo. USAR antes de una tarea multi-paso difícil, un build, una auditoría, una migración, o cuando el usuario pida "modo riguroso", "fable mode", "piensa/razona con disciplina", "no me falles", "verifica antes de terminar", o cuando vayas a delegar a subagentes. Es la versión de UN-solo-agente del protocolo de comité.
+---
+
+# Reasoning Discipline: el proceso es el foso, no el modelo
+
+Regla de fondo (validada, Brain #6648): no puedes quedarte con la INTELIGENCIA de
+un modelo, pero sí con su PROCESO. Lo que produce salidas confiables es el harness,
+las compuertas y los loops, no el modelo. Esta disciplina eleva a un modelo barato,
+pero NO cambia su capacidad de base: no la sobre-vendas como un upgrade de inteligencia.
+
+Cárgala cuando la tarea sea cara de equivocar. Para trabajo trivial, no estorbes.
+
+## Las 5 compuertas (no las saltes)
+
+1. **SCOPING (antes de tocar nada).** No solo listar pasos: hacer de abogado del
+   diablo sobre lo desconocido. ¿Qué podría salir mal? ¿Qué supuestos no verifiqué?
+   Escribe el plan por etapas, numeradas, cada una con su condición de "pasa".
+2. **EVIDENCIA antes de razonar.** Lee el archivo, corre el grep, mira el esquema
+   real ANTES de teorizar. No razones sobre lo que crees que dice el código; ábrelo.
+3. **RAZONAR ADVERSARIALMENTE.** Ataca tu propia solución. ¿Qué caso la rompe?
+   ¿Qué cifra inventé? ¿Qué claim no es objetivamente verificable? Ante la duda,
+   asume que está mal hasta probar lo contrario.
+4. **VERIFICAR antes de declarar hecho.** Cada etapa define una condición que un
+   ARTEFACTO EXTERNO satisface (un test que pasa, un grep que devuelve la línea, un
+   `execute_orm` que da el número, un screenshot que se ve bien). "Se ve bien" no es
+   verificación; un artefacto sí. Re-verifica cada "listo" antes de decirlo.
+5. **REPORTAR / CALIBRAR.** Di qué falló, qué quedó sin verificar, qué es supuesto
+   vs. hecho. Honestidad sobre impresión. El reporte es parte del trabajo.
+
+Esto es el `feedback_committee_operating_protocol` en formato de un-solo-agente.
+Cuando la tarea amerite paralelismo o red-team, escala al comité (Workflow).
+
+## Principios operativos (del system prompt filtrado de Fable 5)
+
+Fuente CC0 pública (`asgeirtj/system_prompts_leaks`, corroborada por
+`jujumilk3/leaked-system-prompts`). Citar como filtrado, no confirmado por Anthropic.
+Cuatro reglas listas para usar:
+
+- **Verifica antes de confiar en la memoria.** "El reconocimiento parcial del training
+  no es conocimiento actual." Si lo recuerdas pero no lo comprobaste, compruébalo.
+- **Comprueba que el archivo exista.** Que el prompt implique que un archivo está
+  presente no significa que lo esté (el usuario pudo olvidar subirlo). Revisa tú mismo.
+- **Responde primero, pregunta después.** Atiende una consulta ambigua ANTES de pedir
+  aclaración. Máximo UNA pregunta por respuesta.
+- **Escala el esfuerzo a la tarea.** 1 llamada de herramienta para un dato simple,
+  3 a 5 para una tarea media, 5 a 10 para research o comparación honda.
+
+## Calibración de esfuerzo (importante)
+
+Más esfuerzo NO es siempre mejor. El esfuerzo bajo de un modelo top suele igualar al
+esfuerzo alto del tier siguiente. Subir a `xhigh`/`max` a veces EMPEORA: el modelo se
+sobre-piensa y se contradice. Default sensato: `high`. Sube solo si la tarea lo exige
+y estás dispuesto a pagar la latencia y el riesgo de overthinking.
+
+## Ruteo de modelo (delega el trabajo mecánico al tier barato)
+
+Palanca NATIVA de Claude Code (sin código):
+- `CLAUDE_CODE_SUBAGENT_MODEL` rutea TODOS los subagentes a un tier barato.
+- Cada subagente acepta el campo `model:` (incluido `inherit`).
+
+Policy de delegación:
+| Trabajo | Tier | Por qué |
+|---|---|---|
+| Razonamiento real, diseño, review de código, síntesis | Opus / Fable | Necesita juicio |
+| Variantes creativas, transformaciones con contexto | Sonnet | Buen costo/juicio |
+| Bulk mecánico: extracción, clasificación, sweeps, scouts | Haiku | ~3× más barato/token |
+
+Empareja el tier a la DIFICULTAD de la etapa, no al hábito.
+
+**Corrección de honestidad (no propagar el mito).** La frase de la comunidad
+"orquestador Opus + scouts Haiku = misma calidad, 3× más barato" NO tiene benchmark.
+El dato publicado de Anthropic (`anthropic.com/engineering/multi-agent-research-system`)
+es Opus-líder + Sonnet-subagentes = +90.2% en su eval de research, a ~15× MÁS tokens.
+O sea: el patrón orquestador-worker COMPRA calidad a mayor costo de tokens. "Haiku
+~3× más barato por token" es cierto; el combinado "misma calidad Y 3× más barato" no.
+Cuando cites el fundamento de nuestros comités, usa el número real (Opus+Sonnet,
++90.2%, 15× tokens), nunca el mito del ahorro.
+
+## Endurecer una compuerta con un hook (opcional)
+
+Una regla enforzada por un hook real vence a la prosa. Igual que el `ai-slop-lint`
+que falla el build, se puede enforzar una compuerta (p. ej. "un test nunca nombra una
+ruta de datos productiva") con un hook `PostToolUse` que bloquee la violación. Patrón:
+un solo gate mecánico, no todo el skill. Si vas a construir uno, documenta qué cazá,
+qué salta y qué NO cubre (los blind spots) en el propio hook.
+
+## Al cerrar
+
+Si esto fue un plan o un comité, captura sus perspectivas al Brain (`capture_learning`)
+antes de terminar. El análisis de un plan es conocimiento durable; perderlo es el error.