@andespindola/crow-skills 0.40.0 → 0.42.0

package/skills/crow-design/licenses/Apache-2.0.txt

@@ -0,0 +1,191 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright
+      owner or by an individual or Legal Entity authorized to submit on
+      behalf of the copyright owner. For the purposes of this definition,
+      "submitted" means any form of electronic, verbal, or written
+      communication sent to the Licensor or its representatives, including
+      but not limited to communication on electronic mailing lists, source
+      code control systems, and issue tracking systems that are managed by,
+      or on behalf of, the Licensor for the purpose of discussing and
+      improving the Work, but excluding communication that is conspicuously
+      marked or otherwise designated in writing by the copyright owner as
+      "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Paul Bakaus
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/skills/crow-design/licenses/Impeccable-NOTICE.md

@@ -0,0 +1,11 @@
+# Third-Party Notices
+
+This project includes content derived from third-party work, used under the terms of its original license.
+
+## Platform Design Skills
+
+The `skill/reference/ios.md` and `skill/reference/android.md` platform reference files are distilled from ehmo's `platform-design-skills` (Apple Human Interface Guidelines and Material Design 3 rules), rewritten in Impeccable's voice.
+
+**Original work:** https://github.com/ehmo/platform-design-skills
+**Original license:** MIT
+**Author:** ehmo

package/skills/crow-design/licenses/design-system-MIT.txt

@@ -0,0 +1,26 @@
+MIT License
+
+A skill de origem "design-system" (metadata.author: claudekit, version 1.0.0) declara
+"license: MIT" no frontmatter do SKILL.md instalado. O pacote instalado não traz arquivo
+de licença nem linha de copyright; o titular abaixo é o autor declarado nos metadados.
+Texto padrão da licença MIT:
+
+Copyright (c) claudekit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/crow-design/licenses/platform-design-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/crow-design/licenses/taste-skill-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Leonxlnx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/crow-design/references/aceite-e-pre-voo.md

@@ -0,0 +1,267 @@
+<!-- Derivado de Impeccable (Apache-2.0, Paul Bakaus), design-taste-frontend e high-end-visual-design (MIT, Leonxlnx), design-system (MIT, claudekit) e platform-design-skills (MIT, ehmo); reescrito e modificado pelo Crow em 2026-11-13. Ver ../NOTICE.md. -->
+# Aceite e pré-voo do design-contract
+
+Leia ao fechar o design-contract: aqui está o que bloqueia a entrega (gates objetivos), o que orienta a revisão (heurísticas com escape), a checagem de usabilidade do próprio contrato e o pré-voo completo, caixa por caixa.
+
+## Como o aceite funciona
+
+O contrato está pronto quando todos os **gates** passam e cada **heurística** foi aplicada e, quando não foi seguida, tem o motivo registrado. Gate reprova sozinho; heurística nunca reprova sozinha, mas exceção sem motivo escrito conta como decisão não tomada.
+
+**Rodadas limitadas.** Verifique tudo de uma vez, em lote (todas as classes de dispositivo, todos os modos, todos os estados), corrija tudo de uma vez, confirme em no máximo mais uma rodada e pare. Rodar a mesma checagem até cansar não melhora o contrato; o que sobrou depois da segunda rodada vai para a lista de pendências com dono.
+
+**Evidência rotulada.** Cada caixa marcada diz como foi verificada: observado (comando rodado, saída lida, captura aberta), inferido (leitura do contrato e das regras) ou simulado (viewport emulado, toque sintético, pseudo-localização). "Passou" sem comando não é evidência. O que não foi verificado aparece como não verificado, não some.
+
+**Documento provisório e documento normativo.** Antes do build, a direção vive num documento provisório de direção (ex.: `direcao.md`), rotulado como tal. O documento do sistema normativo (ver [documento do sistema](documento-do-sistema.md)) é escrito ou promovido depois que a direção foi construída e conferida; antes disso, uma regra escrita é defendida contra a realidade em vez de corrigida por ela.
+
+## (a) Gates objetivos
+
+Cada gate diz o que bloqueia e como verificar. Nenhum gate é liberável por brief ou marca, porque cada um protege uma das três classes não liberáveis de [anti-padrões](anti-padroes.md): acessibilidade, verdade do conteúdo e integridade do sistema de tokens e do contrato (inclusive a existência das decisões escritas que os gates exigem). O que o brief ou o dono podem mudar, com motivo registrado, são os valores que um gate marca como default (por exemplo, a largura no gate 10), nunca a existência da decisão nem os limiares.
+
+1. **Contraste por modo.** Texto normal 4.5:1, texto grande (≥24px regular ou ≥18,66px em negrito) 3:1, não-texto 3:1 (borda que é o limite de controle, pelo papel `semantic.border.control`, já que `border.default` é decorativo; ícone que carrega informação, anel de foco, marcas de gráfico). Por par fg/bg, por estado (padrão, hover, pressionado, selecionado, desabilitado informativo, erro) e por modo que o contrato decidiu ter (claro, escuro, alto contraste). Alfa só com contraste medido sobre o fundo real. *Como verificar:* cada par declarado em `$contrast` no arquivo de tokens, por modo, e `python3 scripts/validar_tokens.py ARQUIVO.json` sai com 0; pares sobre imagem, gradiente ou vidro medidos no pior ponto e listados. Reduzir intensidade de cor (suavizar, dessaturar) reabre este gate.
+2. **Foco.** Todo interativo tem `:focus-visible` com contorno de pelo menos 2px, 3:1 contra a cor adjacente que o anel de fato toca (o fundo, quando há offset; o componente, quando o anel é interno), offset de 2px, feito com `outline` real (ou sombra mais `outline` transparente), sem anel translúcido e sem `outline: none` sem substituto; o foco não fica escondido sob elemento fixo; ordem de foco igual à visual; modal prende e devolve o foco. *Como verificar:* tokens de foco por modo no arquivo de tokens; especificação de foco presente em cada componente da matriz; percurso por Tab descrito para o fluxo principal.
+3. **Alvos.** Mínimo de 24×24 CSS px ou espaçamento equivalente (WCAG 2.5.8 AA); 44×44 em `pointer: coarse` e no iOS; 48×48dp com 8dp de espaço no Android. *Como verificar:* tokens de altura de controle por densidade e por tipo de ponteiro; lista de controles abaixo de 44 com o motivo (só ponteiro fino, espaçados).
+4. **Movimento reduzido.** Em todo nível do botão de MOVIMENTO, cada movimento não essencial tem alternativa intencional sob `prefers-reduced-motion: reduce` (sem deslocamento espacial, opacidade e cor mantidas, loops parados); conteúdo visível por padrão (revelação anima só com `no-preference` e JS ativo); movimento automático que dura mais de 5 segundos no total e roda junto com outro conteúdo tem pausa, parada ou ocultação (WCAG 2.2.2, nível A), seja qual for a duração de cada ciclo; pan horizontal e scrollytelling com caminho que mantém todo o conteúdo alcançável. Em qualquer modo e nível, nada pisca mais de 3 vezes por segundo, salvo abaixo dos limiares de flash geral e de vermelho por área (WCAG 2.3.1, nível A). *Como verificar:* tabela de movimento do contrato com a coluna "reduzido" preenchida em toda linha e nenhum efeito com flash, estroboscópio ou alternância acima de 3 por segundo fora dos limiares de área (ver [movimento](movimento.md)).
+5. **Forced colors.** O contrato diz como a interface aparece com `forced-colors: active`: limites de controle, foco e estados continuam visíveis (bordas e contornos reais, não só sombra e fundo), ícones informativos herdam a cor do sistema. *Como verificar:* seção de forced colors no contrato, com os componentes que dependem de sombra ou fundo listados e resolvidos.
+6. **Estados completos.** Cada componente tem a matriz de estados com aparência, texto e comportamento, e "não se aplica" justificado onde for o caso (ver [componentes e estados](componentes-e-estados.md)). Nenhum estado depende só de cor. *Como verificar:* contagem de células vazias na matriz igual a zero.
+7. **Tokens válidos.** Três camadas (primitivo, semântico, componente), versão semântica em `$meta.version`, modos sobrescrevendo só semânticos existentes, referências que resolvem sem ciclo, direção das camadas respeitada. *Como verificar:* `python3 scripts/validar_tokens.py ARQUIVO.json` sai com 0 (avisos lidos e tratados ou justificados; 1 e 2 bloqueiam). Ver [sistema de tokens](sistema-de-tokens.md).
+8. **Honestidade de conteúdo.** Nenhum depoimento, pessoa, cliente, logo de terceiro, métrica, preço ou benchmark inventado com cara de real; todo mock rotulado como ilustrativo e listado na lista de substituição bloqueante; e-mail em domínio reservado e telefone como placeholder não discável e rotulado (o Brasil não tem faixa reservada); imagem gerada só com consentimento e nunca como produto real; placeholder nunca como entrega final; cada asset e cada fonte com origem, licença e proveniência registradas. *Como verificar:* lista de substituição e tabela de assets presentes no contrato; nenhum asset sem linha (ver [texto e conteúdo](texto-e-conteudo.md)).
+9. **RTL e pseudo-localização, quando há i18n.** Propriedades lógicas em tudo que tem lado, ícones direcionais decididos um a um, expansão de 30 a 40% acomodada, tracking e altura de linha por script, `unicode-range` sem cortar Latin-1. *Como verificar:* passada de pseudo-localização (texto alongado e acentuado, depois RTL forçado) descrita com o resultado; o que cortou ou não espelhou listado e resolvido (ver [adaptação](adaptacao.md)).
+10. **Largura e contêiner decididos.** O gate exige a **decisão de largura escrita por superfície**: o que é largura total e o que é contido, e qual contêiner vale em cada região; altura cheia em `dvh`/`svh` descontando o cromo, nunca `100vh`. O default do pacote para telas de app é largura total; o brief ou o dono podem recusá-lo para uma superfície, com o motivo registrado no contrato. *Como verificar:* a decisão está escrita por superfície, e todo desvio do default de app tem motivo registrado (ver [layout e espaço](layout-e-espaco.md)).
+
+## (b) Heurísticas de revisão
+
+Orientam a revisão do contrato e de qualquer composição de decisão. Cada uma tem o motivo e o escape; o escape aplicado é registrado.
+
+- **Squint.** Aperte os olhos (ou desfoque a composição): a ordem de leitura que sobra é a pretendida? O elemento que leva a ênfase continua o primeiro? *Motivo:* hierarquia que só funciona com o texto legível não é hierarquia. *Escape:* superfície de leitura contínua (documento longo), em que a uniformidade é proposital.
+- **Memória.** O que alguém descreveria desta primeira tela uma hora depois? Se a resposta é "uma landing de SaaS", a direção não deixou marca. *Motivo:* a primeira tela é a tese. *Escape:* Operar, onde o memorável é a tarefa ter sido fácil.
+- **Esqueleto.** Tire cor, imagem e efeito e fique com caixas e tipografia: a estrutura ainda se sustenta e ainda é distinta? *Motivo:* ousadia que mora só na superfície some na primeira mudança de tema. *Escape:* direção cujo mundo é a própria textura (registrado).
+- **Remoção.** Remova um adorno. Se a tela continua funcionando sem o visual dominante, o visual é fraco; se a marca some quando se esconde a navegação, a hierarquia é fraca. *Motivo:* cada elemento tem de ganhar o lugar. *Escape:* nenhum para adorno que não faz falta; ele sai.
+- **Especificidade.** O momento, a tela ou a direção poderiam ser usados sem mudança por um produto vizinho? *Motivo:* o que serve a qualquer um não pertence a ninguém. *Escape:* saída "canon" escolhida pelo dono (o padrão da categoria executado sem ironia), registrada.
+- **Categoria.** Dá para adivinhar a estética pela categoria, ou pela categoria mais o que ela costuma evitar? Então é o default (ver [anti-padrões](anti-padroes.md) e [direção estética](direcao-estetica.md)). *Escape:* o brief ou a marca fixaram essa estética.
+- **Dispositivo e contexto.** A direção funciona no celular com uma mão, em rede lenta, sem som, com movimento reduzido, com zoom de 200%, traduzida? *Motivo:* o efeito que só existe no desktop do designer não existe. *Escape:* superfície com alvo declarado único (instalação, quiosque), registrado.
+- **Impacto, quando o registro é ousado.** Se o dono escolheu o registro ousado, a primeira tela provoca uma reação que uma versão segura não provocaria? Sem isso, o registro ousado foi declarado e não entregue. *Escape:* registro seguro escolhido; então esta pergunta não se aplica.
+- **Contagem de rótulos acima de título.** Por semântica, não por classe: no máximo um a cada três seções como orientação. *Escape:* brief ou marca, registrado.
+- **Teto de zigue-zague.** No máximo duas alternâncias seguidas de imagem e texto. *Escape:* sequência paralela real com variação de escala.
+- **Hero em até duas linhas.** Título do hero cabe em duas linhas no desktop, na língua mais longa. *Escape:* mundo tipográfico em que o título é a peça.
+- **Coerência de botões.** Os valores declarados de VARIÂNCIA, MOVIMENTO e DENSIDADE correspondem ao que o contrato especifica. *Escape:* nenhum; se não correspondem, um dos dois muda.
+
+## (c) Heurísticas de Nielsen como checagem do contrato
+
+Aqui as dez heurísticas avaliam **o que o contrato especifica**, antes de existir interface: o contrato prevê feedback, saída, consistência e recuperação? A nota de uma tela já construída, com relatório de UI pronta, é da `crow-interface`.
+
+Pontue cada heurística de 0 a 4 pelo que está decidido no contrato:
+
+1. **Visibilidade do estado do sistema.** Verificar se: há indicador para cada operação assíncrona; toda ação (salvar, enviar, excluir) tem confirmação; processo de vários passos mostra progresso; a localização atual na navegação está marcada; validação de formulário é inline, não só no envio. *0:* nenhum feedback previsto; *1:* raro; *2:* parcial, lacunas grandes; *3:* a maioria das operações com feedback claro; *4:* toda ação confirma, progresso sempre visível.
+2. **Correspondência com o mundo real.** Verificar se: a terminologia é familiar ao público, sem jargão sem explicação; a ordem da informação segue a expectativa; ícones e metáforas são reconhecíveis; a linguagem é a do domínio do público; o fluxo de leitura é natural (no sentido de leitura do idioma). *0:* jargão técnico puro; *1:* exige conhecimento de domínio; *2:* misto; *3:* quase todo natural; *4:* fala a língua do público do começo ao fim.
+3. **Controle e liberdade.** Verificar se: há desfazer e refazer; formulários e modais têm cancelar; há caminho claro de volta; filtros, busca e seleção se limpam com facilidade; processos longos têm saída. *0:* a pessoa fica presa; *1:* saídas obscuras; *2:* fluxos principais com saída, bordas sem; *3:* sai e desfaz quase tudo; *4:* desfazer, cancelar, voltar e Esc em todo lugar.
+4. **Consistência e padrões.** Verificar se: a terminologia é consistente; a mesma ação produz o mesmo resultado em toda parte; convenções da plataforma são seguidas; há consistência visual (cor, tipo, espaço, componentes); o mesmo gesto tem o mesmo comportamento. *0:* parecem produtos costurados; *1:* muitas inconsistências; *2:* fluxos principais batem, detalhes divergem; *3:* desvios ocasionais sem confusão; *4:* sistema coeso e previsível.
+5. **Prevenção de erro.** Verificar se: ações destrutivas têm desfazer ou confirmação; restrições impedem entrada inválida (seletor de data, lista); defaults reduzem erro; rótulos evitam mal-entendido; há salvamento automático e recuperação de rascunho. *0:* erro fácil, sem proteção; *1:* poucas proteções; *2:* erros comuns pegos, bordas escapam; *3:* a maioria dos caminhos de erro bloqueada; *4:* erro quase impossível por restrições inteligentes.
+6. **Reconhecer em vez de lembrar.** Verificar se: as opções estão visíveis, não enterradas; há ajuda contextual onde precisa; há recentes e histórico; há autocompletar e sugestão; ícones têm rótulo. *0:* memorização pesada; *1:* quase tudo de memória; *2:* principais visíveis, secundárias escondidas; *3:* quase tudo descobrível; *4:* nada precisa ser memorizado.
+7. **Flexibilidade e eficiência.** Verificar se: há atalhos de teclado para ações comuns; há elementos personalizáveis; há recentes e favoritos; há ações em lote; recursos de especialista não complicam o básico. *0:* um caminho rígido; *1:* poucas alternativas; *2:* algum atalho, lote limitado; *3:* bons aceleradores; *4:* vários caminhos, recursos de especialista, personalizável.
+8. **Estética e minimalismo.** Verificar se: só o necessário aparece em cada passo; a hierarquia dirige a atenção; cor e ênfase têm propósito; não há enfeite competindo; o layout é focado. *0:* tudo compete; *1:* poluído; *2:* conteúdo principal claro, periferia ruidosa; *3:* focado, ruído menor; *4:* cada elemento ganha o lugar.
+9. **Reconhecer, diagnosticar e recuperar de erros.** Verificar se: mensagens são em linguagem simples, sem código; o problema é específico ("O e-mail não tem @", não "Entrada inválida"); há sugestão de recuperação; o erro aparece perto da origem; o erro não apaga o formulário. *0:* erros crípticos ou ausentes; *1:* vagos ("Algo deu errado"); *2:* nomeiam o problema, não a solução; *3:* problema e próximos passos; *4:* aponta, sugere a correção e preserva o trabalho.
+10. **Ajuda e documentação.** Verificar se: a ajuda é pesquisável; há ajuda contextual (tooltip, dica, tour opcional); a organização é por tarefa, não por recurso; o conteúdo é conciso e varrível; o acesso não tira a pessoa do contexto. *0:* nenhuma ajuda; *1:* difícil de achar ou irrelevante; *2:* básica, sem contexto; *3:* boa, pesquisável, por tarefa; *4:* a informação certa no momento certo.
+
+**Total e bandas.** Máximo de 40 pontos. Em Persuadir e Experienciar, as heurísticas 7 e 10 podem ser "não se aplica", e o total é lido em porcentagem. Bandas: 36–40 (90% ou mais) excelente, só acabamento; 28–35 (70% ou mais) bom, reforçar os pontos fracos; 20–27 (50% ou mais) aceitável, melhorias significativas antes de fechar; 12–19 (30% ou mais) fraco, o contrato precisa de revisão estrutural; 0–11 crítico, refazer. Não há "faixa típica" a esperar: a nota é do contrato em mãos, sem âncora.
+
+**Severidade de cada achado:**
+
+| Prioridade | Nome | O que é | Ação no contrato |
+|---|---|---|---|
+| P0 | Bloqueante | impede completar a tarefa | corrigir antes de entregar o contrato |
+| P1 | Grave | causa dificuldade ou confusão significativa | corrigir antes do build |
+| P2 | Menor | incômodo com contorno | corrigir na próxima rodada ou registrar |
+| P3 | Acabamento | sem impacto real | corrigir se houver tempo |
+
+Desempate entre dois níveis: "a pessoa entraria em contato com o suporte por causa disso?" Se sim, é pelo menos P1.
+
+## (d) Carga cognitiva
+
+Passe o contrato pelo checklist de oito itens, pelas faixas de memória de trabalho, pelas aplicações (uma ação primária e uma ou duas secundárias, navegação de topo por volta de 5 com as faixas por plataforma: tab bar do iOS de 2 a 5, barra do Android de 3 a 5) e pelas oito violações nomeadas descritas em [dados e densidade](dados-e-densidade.md). Quatro ou mais falhas no checklist num ponto de decisão é carga alta: é heurística, então não reprova sozinha, mas pede correção ou o motivo registrado para manter. As personas de checagem, também lá, entram aqui: percorra a ação principal com as duas ou três pertinentes à superfície.
+
+## (e) Pré-voo
+
+Cada caixa é verificável e marcada com **[G]** (gate: bloqueia) ou **[H]** (heurística: aplicada ou com motivo registrado). Caixa que não se aplica à superfície é marcada "não se aplica" com o motivo.
+
+### Leitura e direção
+- [ ] [G] A linha de leitura está declarada, não silenciosa: tipo de página, público, linguagem, sistema ou família estética, modo (Persuadir, Operar, Ler ou Experienciar) e os botões V/M/D (ver [leitura do brief](leitura-do-brief.md)).
+- [ ] [G] Os botões VARIÂNCIA, MOVIMENTO e DENSIDADE foram derivados do brief e declarados com o sinal que os justifica; nenhum baseline aplicado em silêncio (sem sinal, 5/4/4, dito como tal).
+- [ ] [G] Em redesign, o modo está declarado (preservar ou refazer) e a auditoria do existente foi feita antes; em preservar, os botões são os do existente, e qualquer aumento é proposta explícita (ver [redesign e sistemas existentes](redesign-e-sistemas-existentes.md)).
+- [ ] [G] O sistema de design de origem foi escolhido (pacote oficial, com o nome conferido no registro na hora) ou a estética foi nomeada; um único sistema por projeto.
+- [ ] [G] O registro (seguro ou ousado) e a trilha (leve, padrão ou completa) estão declarados.
+- [ ] [H] A direção passa no teste de categoria e não é variação por obrigação contra a marca.
+- [ ] [H] Alternativas descartadas estão listadas com o motivo; a saída "canon" foi oferecida quando a direção estava aberta.
+- [ ] [G] O contrato de direção tem tese, mundo próprio, história, primeira tela, forma e acabamento, e nenhum bloco soa como mood; ele não vai para código, DOM, atributos de dados nem texto de leitor de tela (ver [direção estética](direcao-estetica.md)).
+- [ ] [G] Conflitos entre pedido, marca, requisito e autoridade visual estão nomeados com a fonte de cada lado, opções com custo e risco, e quem decide; suposições estão rotuladas como suposições.
+- [ ] [H] Cada exceção a um default recusável tem motivo e entra no documento do sistema.
+
+### Sistema e tokens
+- [ ] [G] Tokens válidos: o validador sai com 0 no arquivo de tokens do contrato.
+- [ ] [H] Os locks viram tokens: acentos e famílias de neutros declarados pela estratégia de cor escolhida (ver [cor](cor.md)), tema por página declarado, uma escala de raio com regra de mistura documentada.
+- [ ] [G] Os modos existentes (claro, escuro, alto contraste) foram decididos com o dono; quando há dois ou mais, cada semântico usado tem valor em cada modo e paridade de hierarquia.
+- [ ] [G] Nenhum valor cru em componente; componente referencia semântico (exceções declaradas).
+- [ ] [G] Escala de camadas tokenizada usada para tudo que sobrepõe (ver [superfície e profundidade](superficie-e-profundidade.md)).
+- [ ] [H] Versão, changelog e dono do sistema declarados; exceções com dono e validade.
+
+### Tipografia
+- [ ] [G] Corpo com 16px ou mais na web, texto secundário com 14px ou mais, campo de formulário com 16px no celular. 12px só nos papéis declarados: rótulo de badge ou pílula, legenda e rótulo de eixo de gráfico, metadado não essencial (carimbo de hora, contador); sempre com contraste AA (4.5:1) e nunca como única portadora da informação. Nada abaixo de 12px.
+- [ ] [H] Medida de leitura de 45–75ch (alvo 60–70ch) para prosa; tabelas densas podem passar de 120ch.
+- [ ] [G] Tracking mínimo de −0.04em, só em display latino; nada de tracking negativo em CJK ou árabe; `unicode-range` sem cortar Latin-1.
+- [ ] [G] Cada fonte tem licença declarada e fallback livre equivalente com métricas compatíveis; nenhuma fonte comercial suposta disponível.
+- [ ] [H] Fonte justificada pelo mundo, não pelo reflexo nem pela categoria; serifa só com o critério de [tipografia](tipografia.md); ênfase com itálico ou peso da mesma família.
+- [ ] [H] Escala com degraus visíveis: 1.125–1.2 em rem fixo para Operar e Ler; 1.25–1.333 ou mais, fluida com `clamp()` só no display, para Persuadir e Experienciar; display até cerca de 6rem.
+- [ ] [H] Itálico e display com descendentes têm folga (altura de linha de pelo menos 1.1 e espaço inferior); nada cortado.
+- [ ] [G] Numerais `tabular-nums` em colunas de número; mono só para código, IDs e medidas.
+- [ ] [H] Títulos balanceados e a copy real rodada em cada classe de dispositivo, sem estouro.
+
+### Cor e contraste
+- [ ] [G] Gate de contraste por par, por estado e por modo (ver gate 1), incluindo placeholder, botão (rótulo a 4.5:1 salvo texto grande real), formulário (valor, placeholder, foco, ajuda, erro contra o fundo da seção) e texto sobre imagem com scrim.
+- [ ] [G] Nenhum estado ou significado só por cor.
+- [ ] [G] Forced colors resolvido (gate 5).
+- [ ] [H] Estratégia de cor escolhida antes das cores; acento único por padrão, saturação contida (ver [cor](cor.md)), segundo acento só com função.
+- [ ] [H] Claro ou escuro decidido por cena física, não por categoria.
+- [ ] [H] Sem preto e branco puros como default; texto sobre superfície colorida derivado do matiz, nunca cinza genérico.
+- [ ] [H] Sem os clusters de default (creme, serifa e terracota; quase preto e neon; jornal; roxo e azul; bege e latão) salvo brief ou marca, e sem rodízio "entre projetos".
+- [ ] [H] Paletas de dados (categórica, sequencial, divergente) validadas para discromatopsia e reverificadas no escuro, quando há dados.
+
+### Layout e composição
+- [ ] [G] Largura e contêiner decididos por superfície (gate 10).
+- [ ] [G] Altura cheia em `dvh`/`svh` descontando o cromo; nunca `100vh` nem `h-screen`.
+- [ ] [G] Ordem do DOM e de foco igual à ordem visual em cada breakpoint.
+- [ ] [H] Espaço numa escala de base 4; mais espaço acima do título do que abaixo; grupos apertados e separação generosa; padding de seção por token de densidade, não um mínimo fixo para toda seção.
+- [ ] [H] Breakpoints pelo conteúdo e container queries; valores de breakpoint só como exemplo.
+- [ ] [H] Elemento que leva a ênfase nomeado em cada superfície; um só.
+- [ ] [H] Cards só onde a elevação comunica hierarquia; nada de três cards iguais por reflexo; nenhum card dentro de card.
+- [ ] [H] Variedade de composição em marketing sem cota obrigatória; repetição deliberada de padrão do sistema é permitida.
+- [ ] [H] No máximo duas alternâncias seguidas de imagem e texto; sem cabeçalho dividido por default; bento com N células para N itens, com ritmo e alguma diversidade de fundo.
+- [ ] [H] Listas longas em marketing viram outro componente; sem ficha técnica com borda em toda linha.
+- [ ] [H] Navegação em uma linha no desktop, altura na faixa de 64 a 72px como orientação, padrão escolhido pela arquitetura de informação e pelo conteúdo.
+- [ ] [H] Cada seção tem colapso mobile declarado; o override mobile das faixas de variância está escrito.
+
+### Primeira tela e hero
+- [ ] [H] Título em até duas linhas no desktop, subtítulo em até três ou quatro, ações visíveis sem rolar, medido na língua mais longa.
+- [ ] [H] No máximo quatro elementos de texto no hero (um rótulo ou faixa de marca opcional, título, subtítulo, ações com uma primária e no máximo uma secundária); logo wall, avatares, preço e bullets ficam fora do hero.
+- [ ] [H] O hero tem um visual real; texto com mancha de gradiente não é hero, salvo direção tipográfica deliberada.
+- [ ] [H] Padding superior do hero proporcional ao token de densidade, sem empurrar o título para baixo da dobra.
+- [ ] [H] Superfície operacional abre na matéria de trabalho, sem hero.
+
+### Superfície e profundidade
+- [ ] [G] Borda que é o único limite de componente interativo com 3:1 em cada modo.
+- [ ] [G] Vidro, quando usado, só em camada fixa ou sobreposta, com fallback de `prefers-reduced-transparency` por modo e contraste verificado nos quatro cenários (claro e escuro, com e sem transparência).
+- [ ] [H] Elevação declarada uma vez (borda ou sombra); sombra tingida pelo matiz, com deslocamento e desfoque suave; sem card fantasma, sem halo colorido, sem sombra dura fora de mundo neobrutalista.
+- [ ] [H] Raio concêntrico (interno = externo − padding); pílula (`radius.full`, 9999px) só em controle pequeno salvo regra de mistura.
+- [ ] [H] Moldura dupla, quando usada, só em mídia e hero, nunca em campo de formulário.
+- [ ] [H] Grão estático em camada fixa sem captura de ponteiro; nada de grão em contêiner que rola.
+- [ ] [H] Superfícies do navegador (seleção, cursor de texto, cor da barra de rolagem, anel de foco, sublinhado) tematizadas pela paleta, conforme [superfície e profundidade](superficie-e-profundidade.md).
+
+### Movimento
+- [ ] [G] Movimento reduzido em todo nível do botão (gate 4).
+- [ ] [G] Conteúdo visível por padrão; revelação é melhoria progressiva.
+- [ ] [G] Movimento automático que dura mais de 5 segundos no total e roda junto com outro conteúdo tem pausa (WCAG 2.2.2); loops param fora da tela.
+- [ ] [G] Pan horizontal e scrollytelling com caminho nativo que mantém todo o conteúdo alcançável por rolagem e teclado; um único mecanismo de fixação por elemento.
+- [ ] [G] Toda interação de ponteiro (magnético, rastro, menu radial, arrastar) tem equivalente por teclado e por toque simples.
+- [ ] [H] Movimento motivado (hierarquia, narrativa, feedback ou transição de estado), justificado numa frase; um momento autoral por superfície, não a mesma entrada em toda seção.
+- [ ] [G] Nada pisca mais de 3 vezes por segundo fora dos limiares de área de flash geral e de vermelho (WCAG 2.3.1, nível A; gate 4).
+- [ ] [H] Durações e easings dos tokens (ver [movimento](movimento.md)): em Operar, 100–150ms feedback, 150–250ms estado, até 250ms layout e sobreposição, sem entrada focal; nos demais modos, 100–150ms feedback, 150–300ms estado, 300–500ms layout e sobreposição, 500–800ms entrada focal só em Persuadir e Experienciar; entrada ease-out, saída ease-in e mais curta, progressão linear, mola só com gesto.
+- [ ] [H] Só transform e opacity animados; filtro estático; transições com propriedades listadas, nunca `all`; nenhum ouvinte de rolagem.
+- [ ] [H] Pressionar afunda, nunca sobe.
+- [ ] [H] No máximo um marquee por página.
+- [ ] [H] O movimento declarado no botão é o movimento especificado; se não dá para entregar, o botão desce.
+
+### Componentes e estados
+- [ ] [G] Matriz de estados completa por componente (gate 6), com o texto de cada estado.
+- [ ] [G] Foco especificado (gate 2) e alvos (gate 3).
+- [ ] [G] Desabilitado resolvido: `aria-disabled` focável com explicação quando há motivo a dar, `disabled` nativo quando não; nada de opacidade de 50% como único tratamento.
+- [ ] [G] Regiões vivas existem antes da mudança e recebem o texto nela; `aria-invalid` só depois da validação; sem `role="alert"` estático na carga.
+- [ ] [G] Carregamento por esqueleto com a forma do conteúdo; spinner só inline na ação; sem opacidade reduzida em texto.
+- [ ] [G] Diálogo com foco inicial, foco preso, devolução ao gatilho, Esc, `aria-modal`, `aria-labelledby`, rolagem travada e botões nomeados pelo resultado; sobreposições escapam do contêiner.
+- [ ] [G] Menus e disclosures conforme a especificação canônica de [componentes e estados](componentes-e-estados.md) (`aria-expanded`, Esc que fecha e devolve o foco, setas em menu de comandos).
+- [ ] [H] Árvore de decisão aplicada: inline, disclosure, popover ou sheet, e modal só para interrupção ou foco protegido; desfazer preferido a confirmar.
+- [ ] [H] Uma ação primária por região; um rótulo por intenção; CTA em uma linha no desktop.
+- [ ] [H] Estados de hover e pressionado como tokens opacos.
+- [ ] [H] Ícones de uma biblioteca, uma espessura acompanhando o texto, 3:1 quando carregam significado, nome acessível em botão só com ícone; sem emoji ou glifo no lugar de ícone.
+- [ ] [H] Vazios com as cinco partes e os seis tipos canônicos de [componentes e estados](componentes-e-estados.md#estado-vazio); primeiro uso opcional, com um a três conceitos e tours de 3 a 7 passos que não bloqueiam; "visto" persistido.
+- [ ] [H] Momento de personalidade com tese e as seis proteções; nada de piada em perda, dinheiro ou privacidade; som só com consentimento.
+- [ ] [H] Componente novo só quando nenhum existente serve; extração só para padrão usado três ou mais vezes com a mesma intenção.
+
+### Formulários
+- [ ] [G] Rótulo persistente; placeholder é exemplo e tem 4.5:1.
+- [ ] [G] Erro inline ligado ao campo, com texto que diz como corrigir; formulário não é apagado no erro.
+- [ ] [H] Requisitos antes do envio; obrigatório e opcional consistentes; ajuda no markup; `type`, `inputmode` e `autocomplete` certos.
+- [ ] [H] Validação no cliente para ajudar, sempre repetida no servidor; envio duplo bloqueado.
+
+### Texto
+- [ ] [G] Nenhuma copy fornecida foi reescrita; claims e textos legais não mudaram sem aprovação.
+- [ ] [H] Vocabulário: nome pelo que a pessoa entende, uma ação com um nome do começo ao fim, verbo mais objeto, destrutiva com objeto e consequência, nada de Sim, Não, OK, Enviar genéricos.
+- [ ] [H] Erro com o que falhou, por quê quando útil, e como recuperar; carregando nomeia a operação; vazio distingue os tipos; sucesso curto.
+- [ ] [H] Releitura da copy gerada (gramática, referente, alucinação, tentativa de soar profundo); sem os clichês listados em [texto e conteúdo](texto-e-conteudo.md); um registro de texto por página.
+- [ ] [H] Pontuação pelo locale, com os caracteres reais: em pt-BR, travessão legítimo em diálogo e aposto, meia-risca em intervalos, aspas curvas; a heurística contra travessão-muleta só em copy gerada.
+- [ ] [H] Limites de texto por medida visual (linhas e largura) testados na língua mais longa, não por contagem de palavras em inglês.
+- [ ] [H] Citações reais, até três linhas, com nome, cargo e empresa quando houver.
+- [ ] [G] Nome acessível contém o rótulo visível; `alt` informativo transmite a informação; `alt` vazio em decoração.
+
+### Conteúdo e assets
+- [ ] [G] Honestidade de conteúdo (gate 8): sem pessoa, depoimento, cliente, logo, métrica, preço ou número inventado com cara de real; mock rotulado e na lista de substituição bloqueante.
+- [ ] [G] E-mail em domínio reservado (`nome@example.com` ou `.test`) e telefone como placeholder não discável, como `(00) 0000-0000`, ambos rotulados como exemplo; o Brasil não tem faixa reservada, e 555-0100 a 555-0199 só vale para números dos EUA.
+- [ ] [G] Logo de terceiro só com relação comprovada; parede de logos só com logos, legíveis nos dois modos, abaixo do hero.
+- [ ] [G] Sem screenshot falso montado com divs nem rodapé de versão inventado; sem picsum ou placeholder como entrega final.
+- [ ] [G] Imagem gerada só com consentimento, rotulada, nunca como produto real; foto de banco com pessoa identificável dentro das restrições da licença.
+- [ ] [G] Origem, licença e proveniência registradas para cada asset e cada fonte.
+- [ ] [H] Duas ou três imagens reais quando o assunto pede imagem; SVG decorativo à mão só quando pedido, marca geométrica simples ou geometria exata.
+- [ ] [H] Sem os cromos de metadado (rótulo de versão no hero, rodapé de versão em marketing, faixa de cidade e clima, contador de estoque, crédito de foto decorativo, eyebrow numerado, pílulas sobre imagem, chamada para rolar, faixa decorativa no pé do hero, subtexto flutuante, barra com trilho, ponto de status decorativo, borda dupla por linha), salvo informação real.
+
+### Adaptação e idiomas
+- [ ] [G] Funcionalidade central disponível em toda classe de dispositivo; arquitetura de informação igual entre contextos.
+- [ ] [G] Zoom de 200% e reflow a 320 CSS px sem perda; espaçamento de texto ampliado sem corte.
+- [ ] [G] Áreas seguras respeitadas (`env(safe-area-inset-*)` com `viewport-fit=cover`) em barras fixas e botões flutuantes.
+- [ ] [G] RTL e pseudo-localização quando há i18n (gate 9).
+- [ ] [H] Estratégia por contexto escrita (celular, tablet, desktop; impressão e e-mail quando estão no escopo).
+- [ ] [H] Capacidade de entrada por `pointer` e `hover`; nada depende de hover.
+- [ ] [H] Imagens com `srcset`, `sizes` e `<picture>` quando o recorte muda; dimensões declaradas.
+- [ ] [H] Gestos e controles customizados com toque, arraste completo, rolagem atravessando e interrupção especificados, e a evidência que será exigida declarada.
+
+### Dados, quando a superfície é produto
+- [ ] [G] Tabela com números à direita e `tabular-nums`, status com texto e ícone à esquerda junto do rótulo, cabeçalho semântico.
+- [ ] [G] Gráficos não dependem só de cor; têm resumo textual e tabela alternativa; tooltip abre no foco.
+- [ ] [G] Todo KPI tem fonte, período e definição, ou está rotulado como ilustrativo.
+- [ ] [H] Densidade de linha por token (compacta, padrão, confortável), com 44px em `pointer: coarse` para linhas com ações.
+- [ ] [H] Ordenação, filtros, seleção em massa, paginação ou virtualização, coluna fixa e overflow decididos; estado de vista na URL.
+- [ ] [H] Primeiro viewport com o que se decide hoje; hierarquia de indicadores; sparkline e anel só quando são o dado.
+- [ ] [H] Barras começam em zero; legenda direta quando cabe; forma do gráfico escolhida pela tarefa.
+- [ ] [H] Estados de dados por bloco (carregando, os seis tipos de vazio, parcial, erro, sem permissão, offline, extremos).
+- [ ] [H] Atalhos descobríveis e sem conflito; command palette, quando há, segue o padrão de combobox e não substitui navegação visível.
+- [ ] [H] Carga cognitiva sem quatro falhas num ponto de decisão.
+
+### Nativo, quando há app
+- [ ] [G] Alvos de 44×44pt no iOS e 48×48dp com 8dp no Android; Dynamic Type e `sp`; Reduzir Movimento e "Remover animações" respeitados.
+- [ ] [H] Estrutura por classe de tamanho; navegação traduzida entre plataformas (tab bar, barra de navegação, rail, drawer); voltar do sistema intocado.
+- [ ] [H] Controles da plataforma; sem os vícios "portado de site" e "pele de iOS".
+- [ ] [H] Handoff para `crow-native-mobile` com classes de tamanho, tabela de navegação, tokens por modo e o que ficou sem hardware.
+
+### Desempenho como orçamento
+- [ ] [H] Orçamentos declarados para o build: LCP abaixo de 2,5s, INP abaixo de 200ms, CLS abaixo de 0,1; imagem principal com prioridade, fontes limitadas aos pesos usados com `font-display` decidido; efeitos caros (vidro, WebGL, vídeo) justificados no orçamento. A medição é do build, por `crow-frontend` e `crow-interface`.
+
+### Registro premium, quando escolhido
+- [ ] [H] O registro premium foi pedido ou escolhido pelo dono, nunca aplicado por default.
+- [ ] [H] A vibe e a composição de partida foram escolhidas pelo brief e declaradas, sem sorteio silencioso.
+- [ ] [H] Cada técnica do catálogo usada está dentro dos guarda-corpos de [registro premium](registro-premium.md): moldura dupla só em mídia e hero, botão-ilha com alvo e contraste, macroespaço pelo token de densidade, easing por propósito, vidro só em camada fixa com fallback, grão estático, navegação escolhida pela arquitetura.
+- [ ] [H] Rótulo em pílula acima de título raro, com 12px ou mais e contraste AA.
+- [ ] [H] Fallbacks presentes (movimento reduzido, transparência reduzida, sem JS, forced colors); nada de "sem fallbacks genéricos".
+- [ ] [H] A checagem de impacto foi aplicada; persona, preço de agência e raciocínio silencioso não são critério.
+
+### Documento do sistema
+- [ ] [G] Documento provisório de direção (ex.: `direcao.md`) antes do build; documento normativo só depois.
+- [ ] [G] Nenhum componente inventado para preencher o documento; lista vazia declarada.
+- [ ] [H] Exemplos de valores neutros e sintéticos, fora dos clusters de default.
+
+### Fechamento
+- [ ] [G] Cada requisito do brief está presente no contrato e é encontrável em segundos.
+- [ ] [G] Não verificado listado; evidência rotulada (observado, inferido, simulado).
+- [ ] [G] Próximo responsável nomeado, com o que recebe.
+
+## (f) O que não é deste contrato
+
+- **Crítica pontuada, auditoria técnica e polimento de UI já construída** (nota de usabilidade de tela pronta, auditoria de código e desempenho medido, variantes ao vivo, endurecimento, otimização, extração de componentes no código) são da `crow-interface`, que recebe este contrato como barra.
+- **Auditoria de acessibilidade** da interface construída (leitor de tela, teclado, conformidade WCAG medida) é da `crow-accessibility`. Os gates acima garantem que o contrato especifica acessibilidade; não provam que o build a entrega.
+- **Integração com stack, dados e comportamento** é da `crow-frontend`; **app nativo** é da `crow-native-mobile`.
+- Este contrato decide antes de construir. Pré-voo verde não é prova de deploy nem de build correto.