BUREAU / Documentación / Comandos

Comandos

Todos los comandos, flags, scripts y códigos de salida.

Los comandos se invocan como /bureau <comando> cuando el host expone slash commands, o por lenguaje natural. El enrutador de SKILL.md también acepta pedidos sin comando.

Tabla

/bureau

Sin argumento, inspecciona el proyecto:

• BUREAU.md ausente → propone init;
• comps ausentes → propone concept;
• URL sin QA → propone qa;
• QA antiguo → propone review;
• todo listo → propone ship.

Lidera con dos acciones de mayor valor y una línea de evidencia cada una. Nunca ejecuta un paso destructivo por sí solo.

/bureau auto

Ejecuta el pipeline completo con tres checkpoints humanos:

1. Elección de dirección — tres comps + recomendación.
2. Fijación de dirección de arte — world sheet, espécimen, hoja de color.
3. Ship — scorecard + launch checklist.

Entre checkpoints, actúa: escribe artefactos, ejecuta scripts, corrige P0/P1, vuelve a ejecutar la evidencia. No pidas permiso para decisiones reversibles. Detente solo cuando el checkpoint necesite gusto, verdad o un compromiso irreversible.

Si el usuario no puede participar, elige la opción más defendible, registra la suposición y continúa. El Tribunal sigue aplicando.

/bureau init

1. Hace como máximo tres preguntas bloqueantes por ronda.
2. Propone defaults para el resto.
3. Escribe BUREAU.md y .bureau/config.json.
4. Declara el modo por superficie.
5. Arma el inventario de evidencia.

Criterio de terminado: oferta, público, prueba con fuente, non-goals y métrica.

/bureau concept

1. Genera tres direcciones con lentes diferentes.
2. Crea tres comps en el mismo viewport, con contenido real.
3. Puntúa con la matriz de 6 criterios.
4. Elige y registra la decisión + los rechazados.
5. Escribe la mezcla elegida en .bureau/comps/blend.md: tres linajes, tres ejes, una tensión.

Nunca entregar tres variaciones de la misma idea.

/bureau direction

1. World sheet: ground, voz, luz, material, motion, imagen, prohibiciones.
2. Tokens OKLCH + hex, escala, espaciado, radios.
3. Espécimen tipográfico + hoja de color en contexto.
4. Primer viewport como tesis.
5. Valida contraste.

node skill/scripts/tokens.mjs --in design/tokens.json --out-dir src/styles --check

/bureau build

1. HTML semántico.
2. CSS en capas.
3. JS mínimo.
4. Estados completos.
5. Contenido real.
6. i18n.

El build no empieza sin DESIGN.md y un comp elegido.

/bureau motion

1. Escribe MOTION.md.
2. Elige un carácter.
3. Implementa una entrada, una narrativa, una firma.
4. Diseña reduced motion.
5. Mide 60 fps.

node skill/scripts/visual-audit.mjs http://localhost:3000 --out .bureau/qa --motion

/bureau figma

1. Descubre las herramientas MCP disponibles.
2. Lee variables y screenshot del frame.
3. Sincroniza tokens.
4. Compara código vs Figma en el mismo viewport.
5. Registra desviaciones intencionales.

node skill/scripts/figma-sync.mjs --in design/figma-variables.json --out design/tokens.json
node skill/scripts/tokens.mjs --in design/tokens.json --out-dir src/styles --check

Sin MCP: exportar JSON + PNG y registrar la limitación.

/bureau qa

node skill/scripts/visual-audit.mjs http://localhost:3000 \
  --out .bureau/qa \
  --viewports 390x844,768x1024,1440x900,1920x1080 \
  --full --motion

Opciones:

El informe incluye overflow, contraste, objetivos táctiles, imágenes, fuentes, videos, consola, requests, LCP, CLS, long tasks y reduced motion.

/bureau review

node skill/scripts/review.mjs --status
node skill/scripts/review.mjs --gate g1-concept --scores .bureau/review/g1.json
node skill/scripts/survey.mjs --init --need landing --probe
node skill/scripts/survey.mjs --check
node skill/scripts/review.mjs --delivery-init
node skill/scripts/review.mjs --jury-init
node skill/scripts/review.mjs --jury-start
node skill/scripts/review.mjs --jury-round
node skill/scripts/review.mjs --regate
node skill/scripts/review.mjs --jury-status
node skill/scripts/review.mjs --final --tribunal .bureau/review/tribunal.json
node skill/scripts/review.mjs --report

• Exige orden.
• Exige evidencia.
• Rechaza score < 3,5 y P0.
• Marca puertas obsoletas por hash.
• La puerta 1 exige el relevamiento de cinco fuentes verificadas, en el orden de la cola.
• El jurado tiene un time box de 10 minutos; vale la mejor ronda registrada dentro de él.
• Genera .bureau/review/scorecard.html.

/bureau slop

node skill/scripts/audit.mjs .
node skill/scripts/audit.mjs . --json --out .bureau/evidence/audit.json
node skill/scripts/audit.mjs . --fail-on p0
node skill/scripts/audit.mjs --list-rules

Detecta el subconjunto mecánico: degradado morado, texto en degradado, fondo puro, fuentes estándar de IA, léxico genérico, placeholder, autoplay, overflow de accesibilidad, transition: all, scroll hijack, div onclick, etc.

No detecta talento. Leer los hallazgos en contexto.

/bureau ship

Checklist:

• afirmaciones con fuente;
• OG 1200×630;
• sitemap/robots;
• 404/500;
• analytics + consentimiento;
• monitoreo;
• rollback;
• redirects;
• headers de seguridad.

/bureau doctor

node skill/scripts/doctor.mjs
node skill/scripts/doctor.mjs --json

Verifica Node, Playwright, Chromium, ffmpeg, ImageMagick, git, gh, Figma, artefactos del proyecto e instalaciones por host.

Scaffold

node skill/scripts/new-project.mjs --list
node skill/scripts/new-project.mjs mi-sitio --template product-surface

Crea proyecto + BUREAU.md, DESIGN.md, MOTION.md, config, carpetas de evidencia, el LINEAGE.md de la plantilla y README. La página empieza como copia de la plantilla; mide cuánto se ha alejado:

node skill/scripts/divergence.mjs index.html --templates --out .bureau/evidence/divergence.json

Salida 0 cuando todos los pares están en --max o por debajo (por defecto 0.35), 1 cuando un par es demasiado parecido, 2 en error de uso.

Tokens

node skill/scripts/tokens.mjs \
  --in design/tokens.json \
  --out-dir src/styles \
  --mode light \
  --check

Acepta W3C DTCG, Tokens Studio y JSON plano. Genera:

• tokens.css (hex + override OKLCH);
• tokens.tailwind.css (@theme);
• tokens.normalized.json;
• contrast.md.

--check falla en contraste < 4,5:1 y aliases no resueltos.

Figma sync

node skill/scripts/figma-sync.mjs --in design/figma-variables.json --out design/tokens.json

Acepta:

• Tokens Studio (global/light/dark);
• W3C DTCG;
• export de Figma Variables (variables[] con valuesByMode).

Resuelve aliases e informa los no resueltos.

Códigos de salida

Ejemplos de flujo

# proyecto nuevo
node skill/scripts/new-project.mjs studio --template kinetic-editorial
cd studio
node ../skill/scripts/audit.mjs . --out .bureau/evidence/audit.json

# QA
node ../skill/scripts/visual-audit.mjs http://localhost:4173 --out .bureau/qa --full --motion

# review
node ../skill/scripts/review.mjs --status
node ../skill/scripts/review.mjs --gate g0-intake --scores .bureau/review/g0.json

Repetir hasta el Tribunal. No saltar el orden.