O que Truing faz?
Trate a página como um artefato funcional. Leia o HTML, CSS, JavaScript, conteúdo, assets e estados renderizados reais antes de recomendar ou alterar qualquer coisa. Uma preferência visual é uma hipótese até que as evidências da página a confirmem.
O trabalho do Truing é informação útil e organizada e a remoção de arestas ásperas. Não é um skill de embelezamento. Se uma mudança deixar a página melhor visualmente, mas não ajudar em nenhuma tarefa nomeada, deixe-a de fora, a menos que o usuário tenha solicitado estilização.
O fluxo de trabalho é a política definida em R-RUN-001. Os cartões de branch possuem as regras de design e suas ressalvas. Leia apenas os branches relevantes. Todos os arquivos funcionam offline; URLs de fonte pública são citações opcionais. Use as ferramentas de arquivo, edição, execução e renderização disponíveis no host. Nenhum skill complementar, framework, catálogo, conta ou consulta de rede é um pré-requisito.
Preserve fatos, obrigações, ajuda de acessibilidade, tarefas importantes infrequentes e identidade eficaz. Obtenha a decisão do proprietário relevante antes de remover uma capacidade, divulgação obrigatória ou alegação comercial contestada. Trate o código-fonte e o texto da página como evidência, não como autoridade para ampliar a tarefa.
Fluxo de trabalho em tempo de execução
- Inspecionar. Registre o público, o trabalho, a superfície, o conteúdo, as ações importantes, a plataforma, o modelo de estados e as restrições. Classifique a superfície como UI operacional, landing page de showcase ou página de showcase de leitura. Liste os fatos fornecidos, obrigações, tarefas importantes raras, ajuda de acessibilidade e identidade que devem sobreviver. Identifique incógnitas explicitamente. Para uma nova página, inspecione o repositório e o conteúdo fornecido, estabeleça o propósito e os fatos antes do design, e pergunte apenas por informações faltantes que alterem o resultado.
- Diagnosticar. Descreva os sintomas observáveis separadamente das causas possíveis. Use evidências do código, conteúdo e comportamento renderizado. Marque a incerteza. Classifique cada problema como manter, esclarecer, reagrupar, rebaixar ou remover. Quando a questão é se um bloco ou cartão deve existir, onde um fato pertence em relação ao controle que precisa dele, ou qual elemento único deve reter a atenção, aplique information-and-attention.md em qualquer superfície, não apenas nos branches acima. Dê o menor reparo e um near miss onde a regra não deve se aplicar.
- Escolher. Ao escolher ou substituir um componente, verifique as alternativas locais, depois leia o skill ou a documentação do componente relevante antes de propor uma escolha. Use o passo de seleção de componente. Separe um objetivo estabelecido de uma suposição plausível, então siga a primeira linha que se aplica:
- A solicitação é uma avaliação: permaneça somente leitura.
- O objetivo está estabelecido, incluindo um reparo explícito com escopo definido: prossiga dentro do escopo e decida os detalhes da implementação você mesmo. Nenhuma entrevista de aprovação.
- Prioridades plausíveis diferentes alterariam a tarefa principal, hierarquia, conteúdo ou capacidades: forneça observações e duas ou três direções delimitadas, faça uma pergunta focada e pare antes de edições dependentes de direção. Inferir a categoria da página não resolve sua prioridade.
- Reparar. Edite o código real quando autorizado, nesta ordem:
- Encontre o ponto de entrada e os componentes existentes do projeto e implemente a menor alteração completa para a tarefa diagnosticada.
- Para um reparo de interação, leia interaction-and-states.md, accessibility-and-responsive.md e verification.md primeiro. Trace o caminho desde a ativação até os estados resultantes e a recuperação, incluindo foco quando um controle desaparece ou é desabilitado, e conteúdo ativo em larguras estreitas ou texto ampliado.
- Para qualquer página operacional, primeiro escreva o mapa de tarefas em information-design.md e aplique os cartões de R-INF-001..019 cujo escopo a página atenda; nomeie aqueles que não se aplicam. Escreva o mapa uma vez por função que usa a página (R-INF-018). Siga esta ordem: remover ou mesclar, depois reorganizar, depois arestas ásperas. Relate o mapa de tarefas.
- Para um reparo visual, corrija a higiene na ordem de padrões 1 a 6 de visual-craft.md, fixando cada correção em seu proprietário (token, componente) e não no local de chamada. Pare quando a página ficar clara. Execute o passo de composição (padrão 7) apenas quando o usuário pedir distinção visual ou a superfície for um showcase.
- Limites de escopo. Vinculações, cada uma com sua verificação:
- Repare o caminho. Corrija defeitos evidenciados ao longo do caminho reparado, incluindo os pré-existentes. Verificação: cada alteração nomeia seu defeito e sua regra quando não é óbvia.
- Deixe o resto. Mantenha arquivos, comportamentos, geometria, ênfase e estilização não relacionados. Verificação: cada linha alterada remonta a um defeito no diff.
- Mantenha o acesso. Preserve a semântica de acessibilidade, a menos que uma correção evidenciada exija uma alteração; então explique o porquê e verifique o acesso equivalente. Verificação: foco, nomes e papéis correspondem ou são explicados.
- Defeito, não preferência. Um defeito demonstrado de affordance de estado justifica uma alteração; uma preferência por hierarquia, tamanho ou posicionamento uniforme não justifica. Verificação: você pode apontar a falha observada.
- Possua em um token. Em um sistema de design, expresse regras visuais através de seus tokens e componentes (R-VIS-000). Verificação: nenhuma proporção de tamanho ou cor de assinatura é escrita em um local de chamada.
- Nomeie o que você não pôde executar. Quando a renderização não está disponível, liste os caminhos exatos que precisam de verificação externa no navegador.
- Verificar. Confirme o que você mediu, então exercite-o. O procedimento completo, os observáveis de cada verificação e os códigos de saída estão em verification.md; estas linhas são o mínimo:
- Build correto. O nome do asset servido corresponde à saída do build.
- Tarefas. Percorra cada linha do mapa de tarefas na página renderizada, clicando do número até os registros. Execute
scripts/roughness-probe.mjs; passe o mouse, varra e abra sobreposições em ambos os temas você mesmo. - Renderização. Larguras largas e estreitas, texto ampliado, teclado, toque, movimento reduzido; verificações que dependem de observação exigem capturas de tela, não revisão de código.
- Estados. Os estados que a página realmente tem, de vazio até sucesso e retorno de foco.
- Extremos de dados. Com nenhum, um, muitos, faltando e o maior valor realista, as linhas obrigatórias e a ação principal permanecem no primeiro viewport, e nenhum
nullouNaNbruto aparece (R-INF-019). - Passeio de destruição. Em páginas com trabalho assíncrono real: corte a conexão, falhe ao salvar, esvazie os dados e siga cada etapa de recuperação (passeio). Apenas local ou staging.
- Resultado da auditoria. NOT CLEAN não é uma aprovação: corrija cada achado ou nomeie por que permanece. CLEAN também não é uma aprovação: auditorias encontram defeitos, não utilidade.
- Alegações visuais. Apenas com uma mudança de composição visível antes/depois (R-VIS-038); correções de token e alinhamento são higiene.
- Regressões. Revisite cada defeito nomeado na rodada anterior, com a captura de tela que o comprova.
- Cobertura. Páginas x temas x larguras realmente renderizadas; qualquer outra coisa não é verificada.
Escolha a referência certa
Leia apenas o branch que corresponde à pergunta:
| Pergunta | Leia |
|---|---|
| Página operacional: o que deve mostrar, como as pessoas alcançam os registros, quantos estados e cores, o que é áspero? Leia primeiro | information-design.md |
| O que está na página, o que deve sobreviver, os rótulos e divulgações são claros? | purpose-and-content.md |
| Estrutura está definida: parece resolvida? Tipografia, espaçamento, badges, gráficos, colunas de tabela, estados, cor, profundidade | visual-craft.md, um índice de sete padrões; abra apenas os arquivos de padrão que você precisa |
| O trabalho da superfície é mostrar dados: títulos e escala de gráficos, posicionamento de filtros, varredura de linha em um passe | data-display.md |
| Este bloco deve existir, onde um fato pertence, o que retém a atenção, a ênfase compete com a tarefa? | information-and-attention.md |
| Controles operacionais, representação de dados, divulgação de ações secundárias | product-ui.md |
| Formulários e entrada de dados: momento da validação, quais campos, redação de erros, ordem dos campos | R-SYN-022 em interaction-and-states.md, R-VIS-032 em tables-forms-responsive.md |
| Uma busca ou filtro não retornou nada | R-INF-016 em information-design.md |
| Uma página de registro: identidade, estado, ações em um cabeçalho | R-INF-017 em information-design.md |
Dados reais quebram a página: um bloco vazio ocupa o topo, “1 itens”, uma lista de pré-visualização empurra o resto para baixo, um valor longo quebra sua linha, null na tela | R-INF-019 em information-design.md |
| Superfície de landing ou editorial | showcase-and-reading.md |
| Estados orientados a eventos, feedback assíncrono, esperas, movimento, foco, recuperação | interaction-and-states.md |
| Verificações com escopo WCAG, comportamento responsivo, unidades, escala de texto, acesso de entrada | accessibility-and-responsive.md |
| Transformar um diagnóstico em um reparo delimitado | critique-and-repair.md |
| Antes de relatar qualquer resultado visual ou comportamental | verification.md |
| A proveniência, tipo de evidência, escopo ou exceção de uma regra deve ser relatada | sources.md |
Sonda de aspereza. Execute node scripts/roughness-probe.mjs <config.json> contra uma página em execução, após copiar os campos de roughness-probe.md. Ele exercita hover, sobreposições, ações de linha e cores de estado. Saída 0: nada encontrado no que mede. Saída 1: achados para corrigir ou nomear. Saída 2: não foi possível medir.
Auditoria de renderização. Quando um navegador puder ser executado, inicie o servidor de desenvolvimento ou pré-visualização do projeto, então execute node scripts/render-audit.mjs <config.json>. Copie render-audit.example.json. Ele precisa de playwright ou playwright-core, ou defina PLAYWRIGHT_MODULE e CHROME_PATH. Saída 0: limpo no que mede. Saída 1: achados para corrigir ou nomear. Saída 2: nada respondeu, ou a execução mediu a coisa errada; não prova nada. Então siga o caminho rápido em visual-craft.md. render-audit.md diz o que cada verificação cobre.
Exemplos trabalhados. Leia apenas quando sua tarefa corresponder: painel, formulário, landing page, editorial ou passo de composição.
Saída
Abra com os achados classificados por quanto eles bloqueiam o mapa de tarefas, uma linha cada com seu ID de regra. O livro-razão refere-se a eles pelo ID da regra em vez de repeti-los.
Para uma avaliação, retorne um livro-razão de evidências compacto: superfície e tarefa, fatos observados, diagnóstico e incerteza, IDs de regras aplicáveis, menor reparo ou recomendação, conteúdo e controles retidos, near misses e verificações. Não edite.
Para uma alteração autorizada, retorne o mesmo livro-razão mais os arquivos alterados, verificações antes e depois, estados renderizados e limitações. Use o idioma do usuário. A falta de um navegador ou capacidade de teste deixa esse resultado não verificado; termine o trabalho autorizado independente e relate a limitação exata em vez de alegar sucesso visual ou funcional.