BUREAU / Documentação / Comandos

Comandos

Todos os comandos, flags, scripts e códigos de saída.

Comandos são invocados como /bureau <comando> quando o host expõe slash commands, ou por linguagem natural. O roteador do SKILL.md também aceita pedidos sem comando.

Tabela

/bureau

Sem argumento, inspeciona o projeto:

• BUREAU.md ausente → propõe init;
• comps ausentes → propõe concept;
• URL sem QA → propõe qa;
• QA antigo → propõe review;
• tudo pronto → propõe ship.

Lidera com duas ações de maior valor e uma linha de evidência cada. Nunca executa passo destrutivo sozinho.

/bureau auto

Roda o pipeline completo com três checkpoints humanos:

1. Escolha da direção — três comps + recomendação.
2. Trava da direção de arte — world sheet, espécime, folha de cor.
3. Ship — scorecard + launch checklist.

Entre os checkpoints, aja: escreva os artefatos, rode os scripts, corrija P0/P1, re-rode a evidência. Não peça permissão para decisões reversíveis. Pare apenas quando o checkpoint exigir gosto, verdade ou compromisso irreversível.

Se o usuário não puder participar, escolha a opção mais defensável, registre a suposição e continue. O Tribunal continua valendo.

/bureau init

1. Faz no máximo três perguntas bloqueantes por rodada.
2. Propõe defaults para o resto.
3. Escreve BUREAU.md e .bureau/config.json.
4. Declara o modo por superfície.
5. Monta o inventário de evidência.

Critério de pronto: oferta, público, prova com fonte, non-goals e métrica.

/bureau concept

1. Gera três direções com lentes diferentes.
2. Cria três comps no mesmo viewport, com conteúdo real.
3. Pontua com a matriz de 6 critérios.
4. Escolhe e registra a decisão + rejeitados.
5. Escreve a mescla escolhida em .bureau/comps/blend.md: três linhagens, três eixos, uma tensão.

Nunca entregue três variações da mesma ideia.

/bureau direction

1. World sheet: ground, voz, luz, material, motion, imagem, proibições.
2. Tokens OKLCH + hex, escala, espaçamento, raios.
3. Espécime tipográfico + folha de cor em contexto.
4. Primeiro viewport como tese.
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 em camadas.
3. JS mínimo.
4. Estados completos.
5. Conteúdo real.
6. i18n.

O build não começa sem DESIGN.md e um comp escolhido.

/bureau motion

1. Escreve MOTION.md.
2. Escolhe um caráter.
3. Implementa uma entrada, uma narrativa, uma assinatura.
4. Projeta reduced motion.
5. Mede 60 fps.

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

/bureau figma

1. Descobre as ferramentas MCP disponíveis.
2. Lê variáveis e screenshot do frame.
3. Sincroniza tokens.
4. Compara código vs Figma no mesmo viewport.
5. Registra desvios intencionais.

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

Sem MCP: exporte JSON + PNG e registre a limitação.

/bureau qa

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

Opções:

O relatório inclui overflow, contraste, alvos de toque, imagens, fontes, vídeos, console, requests, LCP, CLS, long tasks e 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 ordem.
• Exige evidência.
• Recusa score < 3,5 e P0.
• Marca portões obsoletos por hash.
• O Gate 1 exige o levantamento de cinco fontes verificadas, na ordem da fila.
• O júri tem um time box de 10 minutos; vale a melhor rodada registrada dentro dele.
• Gera .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 o subconjunto mecânico: gradiente roxo, texto em gradiente, fundo puro, fontes padrão de IA, léxico genérico, placeholder, autoplay, overflow de acessibilidade, transition: all, scroll hijack, div onclick, etc.

Não detecta talento. Leia os achados no contexto.

/bureau ship

Checklist:

• claims com fonte;
• OG 1200×630;
• sitemap/robots;
• 404/500;
• analytics + consentimento;
• monitoramento;
• rollback;
• redirects;
• headers de segurança.

/bureau doctor

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

Verifica Node, Playwright, Chromium, ffmpeg, ImageMagick, git, gh, Figma, artefatos do projeto e instalações por host.

Scaffold

node skill/scripts/new-project.mjs --list
node skill/scripts/new-project.mjs meu-site --template product-surface

Cria projeto + BUREAU.md, DESIGN.md, MOTION.md, config, pastas de evidência, o LINEAGE.md do template e README. A página começa como cópia do template; meça o quanto ela se afastou:

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

Saída 0 quando todos os pares estão em --max ou abaixo (padrão 0.35), 1 quando um par é parecido demais, 2 em erro de uso.

Tokens

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

Aceita W3C DTCG, Tokens Studio e JSON plano. Gera:

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

--check falha em contraste < 4,5:1 e aliases não resolvidos.

Figma sync

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

Aceita:

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

Resolve aliases e reporta os não resolvidos.

Códigos de saída

Exemplos de fluxo

# projeto novo
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

Repita até o Tribunal. Não pule a ordem.