visual-system-experiment

Experimento visual serve para decidir direção, não para consertar tela. Correção de tela é contrato comum (execute-task).

O protocolo geral está em experiment-protocol. Aqui ficam as especificidades visuais.

Contrato congelado — o que nunca é livre

• Tokens. apps/app/src/pecas/pecas.css (regras em docs/agents/regua-nextdoor/IDENTIDADE-DAS-PECAS.md) é a fonte da verdade. Valor cru no lugar de token invalida o candidato, por melhor que pareça.
• Componentes: as peças de apps/app/src/pecas/ e o shadcn/ui; nada de HeroUI ou Material Web no apps/app. Peça que falta entra na biblioteca, não é desenhada no candidato.
• Acessibilidade é eliminatória, não estética: alvo de toque, contraste, foco visível, ordem de leitura. Reprovou aqui, não compete por mérito.
• Três viewports: 375 / 768 / 1440. Candidato que só funciona em um não é candidato.

Produção

Cada visual-designer trabalha isolado, sem ver os outros. Entrega: diff dentro da fronteira, gate --fast verde, e uma justificativa sem se identificar — o julgamento é cego.

Medida

node scripts/visual/loop.mjs          # gates -> build -> serve -> screenshot -> auditoria
node scripts/visual/loop.mjs --fast   # captura contra servidor já rodando

A auditoria determinística de .visual/<run>/ é a parte objetiva da comparação: contagem de achados por severidade, por candidato, no mesmo conjunto de rotas.

Nunca dirija o browser por fora do loop: é o gatilho do perfil fantasma "Visual Capture", que quebra seis asserts de pgTAP parecendo regressão real.

Julgamento

A régua está em references/evaluation-rubric.md. Ordem: eliminatórios → objetivo → ofício. Termina numa decisão do coordenador, registrada no card com o ranking do juiz e a pergunta que sobrou; o dono vê o resultado no marco seguinte.