@fontdata/ai-harness 4.4.0 → 4.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (214) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +94 -1
  3. package/dist/cli.js +1 -0
  4. package/dist/config/config.js +24 -13
  5. package/dist/delphi/catalogo.js +308 -0
  6. package/dist/delphi/classificar.js +27 -2
  7. package/dist/delphi/command.js +50 -2
  8. package/dist/delphi/uses.js +90 -0
  9. package/dist/doctor/checks.js +37 -1
  10. package/dist/init.js +9 -1
  11. package/dist/install/perfis.js +15 -4
  12. package/dist/mapa/extratores/pascal.js +1 -1
  13. package/dist/update/update.js +80 -23
  14. package/package.json +1 -1
  15. package/templates/CLAUDE.md +2 -1
  16. package/templates/catalog.json +9 -4
  17. package/templates/hooks/comentarios/check.mjs +62 -5
  18. package/templates/hooks/hooks.json +2 -1
  19. package/templates/hooks/lib/config.mjs +1 -0
  20. package/templates/hooks/padroes-proibidos.mjs +68 -0
  21. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +6 -6
  22. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +6 -0
  23. package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
  24. package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
  25. package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
  26. package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
  27. package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
  28. package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
  29. package/templates/skills/auditar-performance/SKILL.md +9 -0
  30. package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
  31. package/templates/skills/auditar-seguranca/SKILL.md +55 -14
  32. package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
  33. package/templates/skills/auditar-ui/SKILL.md +18 -3
  34. package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
  35. package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
  36. package/templates/skills/harness/references/validar-ideia.md +7 -6
  37. package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
  38. package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
  39. package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
  40. package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
  41. package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
  42. package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
  43. package/templates/skills/security-audit/HUNTING.md +251 -0
  44. package/templates/skills/security-audit/LICENSE +21 -0
  45. package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
  46. package/templates/skills/security-audit/ORIGEM.md +51 -0
  47. package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
  48. package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
  49. package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
  50. package/templates/skills/security-audit/SKILL.md +192 -0
  51. package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
  52. package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
  53. package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
  54. package/templates/skills/security-audit/report-schema.json +461 -0
  55. package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
  56. package/templates/skills/security-audit/validate-findings.cjs +773 -0
  57. package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  58. package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
  59. package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
  60. package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  61. package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  62. package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  63. package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  64. package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  65. package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  66. package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  67. package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  68. package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  69. package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  70. package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  71. package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  72. package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  73. package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  74. package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  75. package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  76. package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  77. package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  78. package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  79. package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  80. package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  81. package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  82. package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  83. package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  84. package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  85. package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  86. package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  87. package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  88. package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  89. package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  90. package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  91. package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  92. package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  93. package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  94. package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  95. package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  96. package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
  97. package/templates/skills/vercel-react-best-practices/README.md +123 -0
  98. package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
  99. package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
  100. package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  101. package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
  102. package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  103. package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  104. package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  105. package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  106. package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  107. package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  108. package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  109. package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  110. package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  111. package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  112. package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  113. package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  114. package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  115. package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  116. package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  117. package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  118. package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  119. package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  120. package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  121. package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  122. package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  123. package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  124. package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  125. package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  126. package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  127. package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  128. package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  129. package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  130. package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  131. package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  132. package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  133. package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  134. package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  135. package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  136. package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  137. package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  138. package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  139. package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  140. package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  141. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  142. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  143. package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  144. package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  145. package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  146. package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  147. package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  148. package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  149. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  150. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  151. package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  152. package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  153. package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  154. package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  155. package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  156. package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  157. package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  158. package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  159. package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  160. package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  161. package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  162. package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  163. package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  164. package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  165. package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  166. package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  167. package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  168. package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  169. package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  170. package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  171. package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  172. package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
  173. package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
  174. package/templates/skills/vercel-react-native-skills/README.md +165 -0
  175. package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
  176. package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
  177. package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
  178. package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
  179. package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
  180. package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
  181. package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
  182. package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
  183. package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
  184. package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
  185. package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
  186. package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
  187. package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
  188. package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
  189. package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
  190. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
  191. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
  192. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
  193. package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
  194. package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
  195. package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
  196. package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
  197. package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
  198. package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
  199. package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
  200. package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
  201. package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
  202. package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
  203. package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
  204. package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
  205. package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
  206. package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
  207. package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
  208. package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
  209. package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
  210. package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
  211. package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
  212. package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
  213. package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
  214. package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
@@ -0,0 +1,143 @@
1
+ ---
2
+ name: patch-acbr
3
+ description: Aplica patch local nos fontes do ACBr com o ritual completo que impede a perda silenciosa da alteração - avaliar alternativa sem patch, localizar o fonte, backup .bak-fontdata, edição preservando ISO-8859-1 e CRLF, marca "// PATCH FONTDATA:" e registro no trabalho em docs/trabalhos. Use quando a correção exigir alterar qualquer arquivo dentro da pasta de componentes do ACBr (ACBrNFSeX, ACBrNFe, ACBrCTe, ACBrMDFe, ACBrDFe, provedores, ACBrXmlWriter, ACBrXmlDocument). Não use para alterar o código do próprio projeto.
4
+ ---
5
+
6
+ # Patch local no ACBr
7
+
8
+ A pasta do ACBr costuma ser **compartilhada entre os sistemas que compilam contra ela** e **não é repositório
9
+ git** do projeto. Todo patch aplicado ali:
10
+
11
+ - some na próxima atualização do ACBr, **sem aviso**, e o bug volta;
12
+ - afeta os outros sistemas que compilam contra a mesma pasta;
13
+ - não aparece em nenhum `git diff` do projeto.
14
+
15
+ Por isso o patch é o **último recurso**, e quando acontece precisa deixar rastro.
16
+
17
+ ## Passo 1: esgotar a alternativa sem patch
18
+
19
+ Antes de tocar no ACBr, responda por escrito:
20
+
21
+ 1. Dá para resolver no código do projeto? Preencher outra propriedade, chamar outro serviço, pós-processar o XML
22
+ gerado antes do envio.
23
+ 2. O método que precisa mudar é `virtual`? Se for, dá para **descender** o provedor ou a classe em vez de editar o
24
+ ACBr.
25
+ 3. A versão nova do ACBr já corrige? Confira antes de patchar.
26
+
27
+ Só siga se as três respostas forem não. Registre-as no documento do passo 5: é o que evita alguém repatchar depois
28
+ sem entender por quê.
29
+
30
+ **Armadilha conhecida:** em `ACBrNFSeXGravarXml.pas` só `GerarXMLImovel` é `virtual`;
31
+ `GerarXMLEnderecoNacionalImovel` **não é**. Um `override` que delega para ele volta a gerar o formato nacional em
32
+ silêncio. Verifique a virtualidade de toda a cadeia, não só do método de entrada.
33
+
34
+ ## Passo 2: localizar a pasta do ACBr
35
+
36
+ **O ACBr não fica no repositório do projeto e pode não existir na máquina atual**: o desenvolvimento Delphi
37
+ acontece em Windows, e o clone do repositório pode estar em outra máquina.
38
+
39
+ Procure nesta ordem:
40
+
41
+ 1. Variável de ambiente `ACBR_PATH`, se definida.
42
+ 2. Caminho registrado em `docs/trabalhos/` por um patch anterior (`grep -rl "PATCH FONTDATA" docs/trabalhos/`).
43
+ 3. Busca por um arquivo conhecido: `ACBrNFSeXServicos.ini`, `ACBrNFSeXGravarXml.pas`, `ACBrNFeWebServices.pas`.
44
+
45
+ Se não encontrar, **pare e informe**:
46
+
47
+ > A pasta do ACBr não está acessível nesta máquina. O patch precisa ser aplicado no ambiente Windows onde o projeto
48
+ > compila. Segue o patch pronto para aplicar lá: <arquivo, trecho antes, trecho depois>.
49
+
50
+ Não invente caminho, não crie a pasta, não siga às cegas.
51
+
52
+ ## Passo 3: backup antes de qualquer edição
53
+
54
+ ```
55
+ <arquivo>.pas → <arquivo>.pas.bak-fontdata
56
+ ```
57
+
58
+ Um backup por arquivo, na própria pasta do componente. Se já existir um `.bak-fontdata`, **não sobrescreva**: já
59
+ há patch anterior ali, então leia o que ele mudou antes de empilhar outro.
60
+
61
+ ## Passo 4: editar preservando o encoding
62
+
63
+ Os fontes do ACBr são **ISO-8859-1 com CRLF**. Um `Write` ingênuo os converte para UTF-8 com LF e suja o arquivo
64
+ inteiro.
65
+
66
+ - Edite por script que leia e grave em `latin1`, preservando `\r\n`.
67
+ - Comentários da marca em **ASCII puro**: sem acento, sem `ç`, sem travessão.
68
+ - Altere o mínimo possível: quanto menor o patch, maior a chance de sobreviver a um merge manual.
69
+
70
+ Marque **início e fim**, sempre:
71
+
72
+ ```pascal
73
+ // PATCH FONTDATA: ISSNet exige municipio junto do CEP no endereco do imovel.
74
+ // Ver docs/trabalhos/<id>/
75
+ ... alteracao ...
76
+ // FIM PATCH FONTDATA
77
+ ```
78
+
79
+ ## Passo 5: registrar no trabalho em `docs/trabalhos/<id>/`
80
+
81
+ Sem este passo o patch está perdido, porque ele não aparece no `git diff` do projeto.
82
+
83
+ Crie ou atualize o `relatorios/TECNICO.md` do trabalho em `docs/trabalhos/<id>/` com uma seção contendo:
84
+
85
+ - o **caminho do arquivo** dentro da pasta do ACBr;
86
+ - a **versão do ACBr** em que o patch foi aplicado;
87
+ - o trecho **antes** e **depois**;
88
+ - por que não deu para resolver no código do projeto (as três respostas do passo 1);
89
+ - como **reaplicar** depois de atualizar o ACBr.
90
+
91
+ ## Passo 6: avisar sobre a reaplicação
92
+
93
+ Ao terminar, diga explicitamente ao usuário:
94
+
95
+ > Este patch está fora do git. Ao atualizar o ACBr, ele se perde e o bug volta. A instrução de reaplicação está em
96
+ > `docs/trabalhos/<id>/`.
97
+
98
+ ## Exemplo
99
+
100
+ **Entrada:** "O `<end>` do imóvel está saindo no formato nacional mesmo no ISSNet, e a prefeitura recusa com
101
+ *Element 'CEP': This element is not expected*."
102
+
103
+ **Saída:**
104
+
105
+ ```
106
+ PASSO 1 — alternativa sem patch
107
+ Resolver no projeto? não — o XML é montado inteiro pelo ACBr antes de voltar
108
+ Método virtual? GerarXMLImovel é virtual, MAS delega para
109
+ GerarXMLEnderecoNacionalImovel, que NÃO é. O override
110
+ volta a gerar o formato nacional.
111
+ Versão nova corrige? não, o ACBr trata o ISSNet como Padrão Nacional puro
112
+ => patch justificado
113
+
114
+ PASSO 2 — localização
115
+ ACBr não acessível nesta máquina (macOS). Patch preparado para aplicar no
116
+ ambiente Windows:
117
+ <ACBr>\Fontes\ACBrDFe\ACBrNFSeX\ACBrNFSeXGravarXml.pas
118
+
119
+ PASSO 3 — backup
120
+ ACBrNFSeXGravarXml.pas.bak-fontdata
121
+
122
+ PASSO 4 — edição (ISO-8859-1, CRLF, comentario em ASCII)
123
+ // PATCH FONTDATA: ISSNet usa TCEndereco (cMun+CEP) no endereco do imovel,
124
+ // nao TCEnderObraEvento (CEP solto) do Padrao Nacional. Sem isso a
125
+ // prefeitura recusa com "Element 'CEP': This element is not expected".
126
+ ... trecho ...
127
+ // FIM PATCH FONTDATA
128
+
129
+ PASSO 5 — docs/trabalhos/<id>/relatorios/TECNICO.md
130
+ seção "Patch no ACBr" com caminho, versão, antes/depois e reaplicação
131
+
132
+ PASSO 6 — aviso
133
+ Patch fora do git: se perde ao atualizar o ACBr.
134
+ ```
135
+
136
+ ## Quando não usar
137
+
138
+ - **Alterar o código do projeto**: fluxo normal, sem ritual de patch.
139
+ - **Antes de esgotar o passo 1**: patch é último recurso, não atalho.
140
+ - **Atualizar a versão do ACBr**: outra operação, que aliás **desfaz** os patches existentes; nesse caso o trabalho
141
+ é reaplicar os patches documentados em `docs/trabalhos/` (`grep -rl "PATCH FONTDATA" docs/trabalhos/`).
142
+ - **Quando o ACBr não está acessível e o usuário quer a alteração aplicada mesmo assim**: entregue o patch pronto
143
+ para o ambiente Windows; não simule.
@@ -26,6 +26,15 @@ Identifique a stack e percorra os pontos quentes de `references/pontos-quentes.m
26
26
  sempre que possível: profiler, `EXPLAIN`, análise de bundle, tempos em log ou teste de carga já existente.
27
27
  Achado sem medição é marcado como estimativa.
28
28
 
29
+ Conforme a stack detectada, consulte também as regras da skill correspondente:
30
+
31
+ - `react` ou `next` no `package.json` → `vercel-react-best-practices`;
32
+ - `react-native` ou `expo` no `package.json` → `vercel-react-native-skills`;
33
+ - Postgres (`pg`, `postgres`, Prisma com provider `postgresql`, FireDAC com driver PG) → `supabase-postgres-best-practices`.
34
+
35
+ No plugin, os nomes são `fontdata:vercel-react-best-practices`, `fontdata:vercel-react-native-skills` e
36
+ `fontdata:supabase-postgres-best-practices`. Sem a stack, a skill não é consultada. Achado que vem de uma dessas regras cita a skill e a regra aplicada.
37
+
29
38
  Sem caso concreto, não é achado: diga a situação (tela, endpoint, volume de dados) e o tempo ou consumo que ela
30
39
  produz. Leia quem chama o trecho apontado e o que ele chama. Escale o impacto pela carga esperada que o projeto
31
40
  declara (`SPEC.md`, `CLAUDE.md`, README, configuração de deploy); sem carga declarada, assuma a menor plausível. Diga
@@ -25,6 +25,14 @@
25
25
  - Complexidade evitável (O(n²) em laços aninhados sobre coleções grandes).
26
26
  - Estrutura de dados inadequada (busca linear onde cabe mapa ou conjunto).
27
27
 
28
+ ## Regras por stack
29
+
30
+ Só quando o projeto tem a stack:
31
+
32
+ - React ou Next.js → `vercel-react-best-practices`.
33
+ - React Native ou Expo → `vercel-react-native-skills`.
34
+ - Postgres → `supabase-postgres-best-practices`.
35
+
28
36
  ## Como medir
29
37
 
30
38
  | Camada | Ferramenta típica |
@@ -1,15 +1,17 @@
1
1
  ---
2
2
  name: auditar-seguranca
3
3
  description: Auditoria de segurança e LGPD — procura vulnerabilidade, segredo ou token exposto, dados pessoais sem proteção, dependências vulneráveis, inputs sem validação e configurações inseguras.
4
- argument-hint: "[foco opcional: 'só segurança', 'só lgpd', 'autenticação'...]"
4
+ argument-hint: "[perfil opcional: quick (padrão), standard ou deep] [foco opcional: 'só segurança', 'só lgpd', 'autenticação'...]"
5
5
  ---
6
6
 
7
7
  # Auditoria de segurança e LGPD
8
8
 
9
- Foco (opcional): $ARGUMENTS
9
+ Parâmetros (opcionais): $ARGUMENTS
10
10
 
11
11
  Auditoria **defensiva** do próprio projeto, em duas frentes: **segurança técnica** e **conformidade com a LGPD**.
12
- Se o foco restringir o escopo, respeite-o; sem foco, rode as duas frentes. **Não altere código.**
12
+ Se o argumento começar por `quick`, `standard` ou `deep`, esse é o perfil da segurança técnica; o resto é o foco.
13
+ Se o foco restringir o escopo, respeite-o; sem foco, rode as duas frentes. **Não altere código.** Nada desta
14
+ auditoria é gravado no repositório fora de `docs/trabalhos/<id>/`.
13
15
 
14
16
  ## Passo 1 — Criar o trabalho de auditoria
15
17
 
@@ -22,10 +24,28 @@ Se o foco restringir o escopo, respeite-o; sem foco, rode as duas frentes. **Nã
22
24
 
23
25
  ## Passo 2 — Segurança técnica
24
26
 
25
- Siga o checklist de `references/seguranca-tecnica.md`: segredos, dependências, validação de entrada,
26
- autenticação e autorização, configuração. Classifique cada achado em **CRÍTICO / ALTO / MÉDIO / BAIXO**, com
27
- evidência (`arquivo:linha`) e correção recomendada. **Nunca** copie o valor de um segredo para o relatório — só a
28
- localização.
27
+ Use a skill **`security-audit`** (no plugin, `fontdata:security-audit`) em **full audit mode**: o pedido já é uma
28
+ auditoria completa, então não pergunte qual modo rodar. Ela audita em fases e valida cada candidato com um agent
29
+ novo:
30
+
31
+ - **Perfil:** `quick` por padrão, ou `standard`/`deep` quando o argumento pedir. Um foco (caminho, subsistema,
32
+ tema como autenticação) vira **scoped run**, e o resto fica `out_of_scope`, nunca `covered`.
33
+ - **Pasta de saída:** a padrão da skill, `~/security-audit-skill/<repo>/run-<N>`, fora do repositório. Num runner
34
+ de CI ela some com o runner; o que precisa ficar vai para `anexos/`.
35
+ - **Rastro:** ao fim, copie `findings.json` e `coverage-ledger.json` da pasta da execução para
36
+ `docs/trabalhos/<id>/anexos/`. O `REPORT.md` e os outros arquivos da skill ficam na pasta dela.
37
+
38
+ Cada registro do `findings.json` tem um de três vereditos:
39
+
40
+ - `confirmed`: tem rastro completo no código e resultado observado; é o único que recebe severidade;
41
+ - `needs_validation`: hipótese ancorada no código, bloqueada por um fato que a skill não conseguiu verificar (por
42
+ exemplo, uma configuração de deploy). Não tem severidade;
43
+ - `rejected`: candidato refutado; não entra nos relatórios.
44
+
45
+ Complemente com o checklist de `references/seguranca-tecnica.md` naquilo que a skill não cobre: segredos
46
+ versionados (inclusive no histórico do git) e código Delphi/legado. Achado que a skill já apontou não se repete.
47
+ Classifique cada achado do checklist em **CRÍTICO / ALTO / MÉDIO / BAIXO**, com evidência (`arquivo:linha`) e
48
+ correção recomendada. **Nunca** copie o valor de um segredo para o relatório — só a localização.
29
49
 
30
50
  Sem caso concreto, não é achado: diga a entrada ou situação (requisição, usuário, dado) e o que ela expõe ou permite.
31
51
  Leia quem chama o trecho apontado e o que ele chama.
@@ -45,10 +65,19 @@ Categoria sem código para avaliar é dita explicitamente, não presumida.
45
65
 
46
66
  ## Passo 4 — Relatório técnico
47
67
 
48
- Grave `docs/trabalhos/<id>/relatorios/TECNICO.md` a partir de `templates/relatorios/TECNICO.md`: sumário por
49
- severidade e veredito LGPD, achados críticos primeiro, segurança técnica, conformidade LGPD por categoria (no
50
- formato do relatório da `lgpd-checker`), pontos positivos e plano de ação priorizado. Preencha `arquivos` com os
51
- arquivos citados.
68
+ Grave `docs/trabalhos/<id>/relatorios/TECNICO.md` a partir de `templates/relatorios/TECNICO.md`, em pt-BR:
69
+ sumário por severidade e veredito LGPD, achados críticos primeiro, segurança técnica, conformidade LGPD por
70
+ categoria (no formato do relatório da `lgpd-checker`), "Precisa de validação", pontos positivos e plano de ação
71
+ priorizado. Preencha `arquivos` com os arquivos citados.
72
+
73
+ O `REPORT.md` da `security-audit` vem em inglês e não é copiado: o relatório é composto a partir do
74
+ `findings.json`.
75
+
76
+ - Os `confirmed` da skill entram na escala do harness: critical → **CRÍTICO**, high → **ALTO**, medium →
77
+ **MÉDIO**, low e informational → **BAIXO**.
78
+ - Os achados do checklist complementar entram na mesma escala, sem repetir o que a skill apontou.
79
+ - **Precisa de validação:** cada `needs_validation`, sem severidade, com o `arquivo:linha` da hipótese e o fato que
80
+ falta verificar.
52
81
 
53
82
  Use numeração única sobre a escala (1, 2, 3… contínuos de CRÍTICO a BAIXO). Cada achado vem em 4 partes:
54
83
  **O que é** (`arquivo:linha`), **Problema** (o caso concreto), **Correção** e **Se não corrigir**. Antes de citar,
@@ -69,7 +98,19 @@ npx @fontdata/ai-harness evento relatorio_gerado --trabalho <id> --nome auditar-
69
98
  npx @fontdata/ai-harness evento trabalho_concluido --trabalho <id> --nome auditar-seguranca
70
99
  ```
71
100
 
72
- ## Passo 6 — Próximos passos
101
+ ## Passo 6 — 🚦 GATE do trabalho de correção
102
+
103
+ Liste os achados que viram task, em ordem de severidade:
104
+
105
+ - os `confirmed` da `security-audit`;
106
+ - os achados do checklist complementar;
107
+ - os achados da LGPD com severidade.
108
+
109
+ Os `needs_validation` ficam fora até alguém verificar o fato que falta. Pergunte se deve criar o trabalho de
110
+ correção. Com o "sim" do usuário, chame `/nova-tarefa` citando o id desta auditoria, com um recorte de **uma task
111
+ por achado**: a severidade, o `arquivo:linha`, a correção mínima e o teste de regressão sugeridos. A auditoria
112
+ em si continua sem alterar código.
73
113
 
74
- Achados que viram correção seguem por `/resolver-bug` (defeito pontual) ou `/nova-tarefa` (adequação maior),
75
- citando o id desta auditoria.
114
+ Sem o "sim", ou em execução não interativa (`npx @fontdata/ai-harness auditar-seguranca -- -p`, para CI), em que o
115
+ GATE não é exibido, os relatórios já gravados bastam: os achados que viram correção seguem por `/resolver-bug`
116
+ (defeito pontual) ou `/nova-tarefa` (adequação maior), citando o id desta auditoria.
@@ -31,6 +31,11 @@ Cada achado: severidade, `arquivo:linha`, descrição e correção recomendada.
31
31
 
32
32
  Achados por categoria (CAT-1 a CAT-11), com o artigo da lei e a recomendação.
33
33
 
34
+ ## Precisa de validação
35
+
36
+ Cada hipótese `needs_validation`, sem severidade: `arquivo:linha` e o fato que falta verificar. Fica fora do plano
37
+ de ação até ser verificada.
38
+
34
39
  ## Pontos positivos
35
40
 
36
41
  ## Plano de ação
@@ -41,7 +41,22 @@ A senha nunca vai para os relatórios nem para o rastro.
41
41
  4. Sem caso concreto, não é achado: diga a ação na tela e o resultado errado que a pessoa vê ou deixa de conseguir.
42
42
  Quando o achado aponta código, leia quem chama o trecho apontado e o que ele chama.
43
43
 
44
- ## Passo 3 — Relatório técnico
44
+ ## Passo 3 — Conferir o código das telas
45
+
46
+ 1. Para cada tela visitada no Passo 2, localize no código-fonte da aplicação os componentes que a renderizam e
47
+ confira esse código contra `references/web-interface-guidelines.md`.
48
+ 2. Escopo das regras conforme a lente:
49
+ - `a11y`: só as seções `### Accessibility`, `### Focus States` e `### Forms`;
50
+ - `ux` ou `tudo`: todas as seções.
51
+ 3. Ignore o frontmatter e a linha "Review these files for compliance" do arquivo vendorizado: os alvos são as telas
52
+ visitadas, não arquivos passados como parâmetro.
53
+ 4. Registre cada achado com `arquivo:linha`, na mesma escala (**CRÍTICO**, **SÉRIO**, **MODERADO**, **MENOR**) e
54
+ com o mesmo rigor de caso concreto. Se a navegação já apontou o problema, acrescente o `arquivo:linha` ao achado
55
+ existente em vez de criar outro.
56
+ 5. Sem acesso ao código-fonte da aplicação, pule este passo e registre isso no **Não verificado**, dizendo quais
57
+ telas ficaram sem conferência de código.
58
+
59
+ ## Passo 4 — Relatório técnico
45
60
 
46
61
  Grave `docs/trabalhos/<id>/relatorios/TECNICO.md` a partir de `templates/relatorios/TECNICO.md`: achados agrupados
47
62
  por **tela** e **severidade**, cada um com o elemento afetado, o critério WCAG (quando houver) e a correção
@@ -53,7 +68,7 @@ caso concreto), **Correção** e **Se não corrigir**. Antes de citar um `arquiv
53
68
  trecho no estado atual. Feche com **Não verificado**: telas, lentes ou fluxos que não foram percorridos ou medidos,
54
69
  e por quê.
55
70
 
56
- ## Passo 4 — Relatório para a gestão
71
+ ## Passo 5 — Relatório para a gestão
57
72
 
58
73
  Grave `docs/trabalhos/<id>/relatorios/CLIENTE.md` a partir de `templates/relatorios/CLIENTE.md`: quais perfis de
59
74
  pessoas têm dificuldade, em quais tarefas, e as prioridades — **sem jargão técnico**.
@@ -66,7 +81,7 @@ npx @fontdata/ai-harness evento relatorio_gerado --trabalho <id> --nome auditar-
66
81
  npx @fontdata/ai-harness evento trabalho_concluido --trabalho <id> --nome auditar-ui
67
82
  ```
68
83
 
69
- ## Passo 5 — Próximos passos
84
+ ## Passo 6 — Próximos passos
70
85
 
71
86
  Correções aprovadas seguem por `/nova-tarefa` (conjunto de melhorias) ou `/resolver-bug` (tela que não funciona),
72
87
  citando o id desta auditoria.
@@ -0,0 +1,44 @@
1
+ # Atribuição
2
+
3
+ O arquivo `web-interface-guidelines.md` desta pasta é uma cópia sem alterações do `command.md` da raiz do
4
+ repositório **Web Interface Guidelines**, da Vercel Labs, disponível em
5
+ https://github.com/vercel-labs/web-interface-guidelines (commit `434b7f91364665f2f733b310ec54809bf8f37937`),
6
+ distribuído sob a licença MIT reproduzida abaixo.
7
+
8
+ | Origem | Destino |
9
+ |---|---|
10
+ | `command.md` | `web-interface-guidelines.md` |
11
+
12
+ ## Como atualizar
13
+
14
+ 1. Clone o repositório numa pasta nova e vazia e faça `git checkout` do commit desejado. Não execute nada do
15
+ conteúdo baixado (em especial o `install.sh`).
16
+ 2. Copie o `command.md` da raiz por cima de `web-interface-guidelines.md`, sem editar o conteúdo.
17
+ 3. Troque o commit deste arquivo pelo novo e confira se o `LICENSE` de origem mudou; se mudou, substitua o
18
+ texto da licença abaixo.
19
+ 4. Rode `npx vitest run tests/vendor-web-interface-guidelines.test.ts` e confirme que o `diff` entre a cópia e o
20
+ `command.md` do commit está vazio.
21
+
22
+ ---
23
+
24
+ MIT License
25
+
26
+ Copyright (c) 2025 Vercel Labs
27
+
28
+ Permission is hereby granted, free of charge, to any person obtaining a copy
29
+ of this software and associated documentation files (the "Software"), to deal
30
+ in the Software without restriction, including without limitation the rights
31
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
32
+ copies of the Software, and to permit persons to whom the Software is
33
+ furnished to do so, subject to the following conditions:
34
+
35
+ The above copyright notice and this permission notice shall be included in all
36
+ copies or substantial portions of the Software.
37
+
38
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
40
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
41
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
42
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
43
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
44
+ SOFTWARE.
@@ -0,0 +1,191 @@
1
+ ---
2
+ description: Review UI code for Vercel Web Interface Guidelines compliance
3
+ argument-hint: <file-or-pattern>
4
+ ---
5
+
6
+ # Web Interface Guidelines
7
+
8
+ Review these files for compliance: $ARGUMENTS
9
+
10
+ Read files, check against rules below. Output concise but comprehensive—sacrifice grammar for brevity. High signal-to-noise.
11
+
12
+ ## Rules
13
+
14
+ ### Accessibility
15
+
16
+ - Icon-only buttons need `aria-label`
17
+ - Form controls need `<label>` or `aria-label`
18
+ - Interactive elements need keyboard handlers (`onKeyDown`/`onKeyUp`)
19
+ - `<button>` for actions, `<a>`/`<Link>` for navigation (not `<div onClick>`)
20
+ - Images need `alt` (or `alt=""` if decorative)
21
+ - Decorative icons need `aria-hidden="true"`
22
+ - Async updates (toasts, validation) need `aria-live="polite"`
23
+ - Use semantic HTML (`<button>`, `<a>`, `<label>`, `<table>`) before ARIA
24
+ - Headings hierarchical `<h1>`–`<h6>`; include skip link for main content
25
+ - `scroll-margin-top` on heading anchors
26
+ - Meaningful media needs captions, transcripts, or descriptions as applicable
27
+ - Media controls need keyboard support; decorative media needs assistive-tech hiding
28
+
29
+ ### Focus States
30
+
31
+ - Interactive elements need visible focus: `focus-visible:ring-*` or equivalent
32
+ - Never `outline-none` / `outline: none` without focus replacement
33
+ - Use `:focus-visible` over `:focus` (avoid focus ring on click)
34
+ - Group focus with `:focus-within` for compound controls
35
+ - Sticky headers/footers/overlays must not cover the focused element
36
+
37
+ ### Forms
38
+
39
+ - Inputs need `autocomplete` and meaningful `name`
40
+ - Use correct `type` (`email`, `tel`, `url`, `number`) and `inputmode`
41
+ - Never block paste (`onPaste` + `preventDefault`)
42
+ - Labels clickable (`htmlFor` or wrapping control)
43
+ - Disable spellcheck on emails, codes, usernames (`spellCheck={false}`)
44
+ - Checkboxes/radios: label + control share single hit target (no dead zones)
45
+ - Submit button stays enabled until request starts; spinner during request
46
+ - Errors inline next to fields; focus first error on submit
47
+ - Placeholders end with `…` and show example pattern
48
+ - `autocomplete="off"` on non-auth fields to avoid password manager triggers
49
+ - Warn before navigation with unsaved changes (`beforeunload` or router guard)
50
+
51
+ ### Animation
52
+
53
+ - Honor `prefers-reduced-motion` (provide reduced variant or disable)
54
+ - Animate `transform`/`opacity` only (compositor-friendly)
55
+ - Never `transition: all`—list properties explicitly
56
+ - Set correct `transform-origin`
57
+ - SVG: transforms on `<g>` wrapper with `transform-box: fill-box; transform-origin: center`
58
+ - Animations interruptible—respond to user input mid-animation
59
+ - Autoplay motion >5 seconds alongside other content needs pause, stop, or hide controls
60
+ - Muted decorative loops must stop under `prefers-reduced-motion`
61
+
62
+ ### Typography
63
+
64
+ - `…` not `...`
65
+ - Curly quotes `“` `”` not straight `"`
66
+ - Non-breaking spaces: `10&nbsp;MB`, `⌘&nbsp;K`, brand names
67
+ - Loading states end with `…`: `"Loading…"`, `"Saving…"`
68
+ - `font-variant-numeric: tabular-nums` for number columns/comparisons
69
+ - Use `text-wrap: balance` or `text-pretty` on headings (prevents widows)
70
+
71
+ ### Content Handling
72
+
73
+ - Text containers handle long content: `truncate`, `line-clamp-*`, or `break-words`
74
+ - Flex children need `min-w-0` to allow text truncation
75
+ - Handle empty states—don't render broken UI for empty strings/arrays
76
+ - User-generated content: anticipate short, average, and very long inputs
77
+
78
+ ### Images
79
+
80
+ - `<img>` needs explicit `width` and `height` (prevents CLS)
81
+ - Below-fold images: `loading="lazy"`
82
+ - Above-fold critical images: `priority` or `fetchpriority="high"`
83
+
84
+ ### Performance
85
+
86
+ - Large lists (>50 items): virtualize (`virtua`, `content-visibility: auto`)
87
+ - No layout reads in render (`getBoundingClientRect`, `offsetHeight`, `offsetWidth`, `scrollTop`)
88
+ - Batch DOM reads/writes; avoid interleaving
89
+ - Prefer uncontrolled inputs; controlled inputs must be cheap per keystroke
90
+ - Add `<link rel="preconnect">` for CDN/asset domains
91
+ - Critical fonts: `<link rel="preload" as="font">` with `font-display: swap`
92
+ - Prefer `<video autoplay muted loop playsinline>` over animated GIF; provide a still alternative
93
+ - Short non-essential loops: Safari H.264 MP4 `<picture>` source, `prefers-reduced-motion` media condition, and still fallback
94
+
95
+ ### Navigation & State
96
+
97
+ - URL reflects state—filters, tabs, pagination, expanded panels in query params
98
+ - Links use `<a>`/`<Link>` (Cmd/Ctrl+click, middle-click support)
99
+ - Deep-link all stateful UI (if uses `useState`, consider URL sync via nuqs or similar)
100
+ - Destructive actions need confirmation modal or undo window—never immediate
101
+
102
+ ### Touch & Interaction
103
+
104
+ - `touch-action: manipulation` (prevents double-tap zoom delay)
105
+ - `-webkit-tap-highlight-color` set intentionally
106
+ - `overscroll-behavior: contain` in modals/drawers/sheets
107
+ - Page rubber-band suppression: `overscroll-behavior: none` on `<html>` inside `@media (pointer: fine)`; keep coarse-pointer page defaults for pull-to-refresh. Test hybrid touch devices: `pointer` describes the primary input, and `none` also disables scroll chaining and native swipe navigation
108
+ - During drag: disable text selection, `inert` on dragged elements
109
+ - Drag/swipe/pinch/path gestures need tap/click and keyboard alternatives unless essential
110
+ - `autoFocus` sparingly—desktop only, single primary input; avoid on mobile
111
+
112
+ ### Safe Areas & Layout
113
+
114
+ - Full-bleed layouts need `env(safe-area-inset-*)` for notches
115
+ - Avoid unwanted scrollbars: `overflow-x-hidden` on containers, fix content overflow
116
+ - Flex/grid over JS measurement for layout
117
+
118
+ ### Dark Mode & Theming
119
+
120
+ - `color-scheme: dark` on `<html>` for dark themes (fixes scrollbar, inputs)
121
+ - `<meta name="theme-color">` matches page background
122
+ - Native `<select>`: explicit `background-color` and `color` (Windows dark mode)
123
+
124
+ ### Locale & i18n
125
+
126
+ - Dates/times: use `Intl.DateTimeFormat` not hardcoded formats
127
+ - Numbers/currency: use `Intl.NumberFormat` not hardcoded formats
128
+ - Detect language via `Accept-Language` / `navigator.languages`, not IP
129
+ - Brand names, code tokens, identifiers: wrap with `translate="no"` to prevent garbled auto-translation
130
+
131
+ ### Hydration Safety
132
+
133
+ - Inputs with `value` need `onChange` (or use `defaultValue` for uncontrolled)
134
+ - Date/time rendering: guard against hydration mismatch (server vs client)
135
+ - `suppressHydrationWarning` only where truly needed
136
+
137
+ ### Hover & Interactive States
138
+
139
+ - Buttons/links need `hover:` state (visual feedback)
140
+ - Interactive states increase contrast: hover/active/focus more prominent than rest
141
+
142
+ ### Content & Copy
143
+
144
+ - Active voice: "Install the CLI" not "The CLI will be installed"
145
+ - Title Case for headings/buttons (Chicago style)
146
+ - Numerals for counts: "8 deployments" not "eight"
147
+ - Specific button labels: "Save API Key" not "Continue"
148
+ - Error messages include fix/next step, not just problem
149
+ - Second person; avoid first person
150
+ - `&` over "and" where space-constrained
151
+
152
+ ### Anti-patterns (flag these)
153
+
154
+ - `user-scalable=no` or `maximum-scale=1` disabling zoom
155
+ - `onPaste` with `preventDefault`
156
+ - `transition: all`
157
+ - `outline-none` without focus-visible replacement
158
+ - Inline `onClick` navigation without `<a>`
159
+ - `<div>` or `<span>` with click handlers (should be `<button>`)
160
+ - Images without dimensions
161
+ - Large arrays `.map()` without virtualization
162
+ - Form inputs without labels
163
+ - Icon buttons without `aria-label`
164
+ - Hardcoded date/number formats (use `Intl.*`)
165
+ - `autoFocus` without clear justification
166
+ - Animated GIF when compressed video is suitable
167
+ - Gesture-only action without tap/click and keyboard alternative
168
+
169
+ ## Output Format
170
+
171
+ Group by file. Use `file:line` format (VS Code clickable). Terse findings.
172
+
173
+ ```text
174
+ ## src/Button.tsx
175
+
176
+ src/Button.tsx:42 - icon button missing aria-label
177
+ src/Button.tsx:18 - input lacks label
178
+ src/Button.tsx:55 - animation missing prefers-reduced-motion
179
+ src/Button.tsx:67 - transition: all → list properties
180
+
181
+ ## src/Modal.tsx
182
+
183
+ src/Modal.tsx:12 - missing overscroll-behavior: contain
184
+ src/Modal.tsx:34 - "..." → "…"
185
+
186
+ ## src/Card.tsx
187
+
188
+ ✓ pass
189
+ ```
190
+
191
+ State issue + location. Skip explanation unless fix non-obvious. No preamble.
@@ -6,7 +6,7 @@ Code e multi-agents. Dê um diagnóstico **honesto e acionável**. Na dúvida, e
6
6
  ## Contexto
7
7
 
8
8
  - **Ideia:** o que o usuário descreveu ao chamar o `/harness` ou nesta conversa.
9
- - **Janela de tempo:** se não foi informada, assuma **~4 horas** (formato imersão) e **diga que assumiu**.
9
+ - **Janela de tempo:** opcional. Se o usuário informou, compare a estimativa com ela; se não, não pergunte nem assuma um valor: estime o esforço e julgue o escopo pela primeira fatia vertical entregável.
10
10
  - **Modo de execução:** TDD obrigatório e sub-agents implementando módulos independentes em paralelo.
11
11
 
12
12
  Ideia ausente ou vaga demais: **pare e faça as perguntas mínimas**, uma por vez, antes de avaliar.
@@ -18,22 +18,23 @@ Para cada um, um veredito curto com a **evidência ou o risco concreto**, sem re
18
18
  1. **Decomposição em módulos** — 2 a 4 módulos que agents separados implementariam de forma **genuinamente
19
19
  independente** (não tocam os mesmos arquivos nem dependem um do outro para começar). Não dar para quebrar assim
20
20
  já é alerta sobre o escopo.
21
- 2. **Fatia vertical entregável** — o menor caminho ponta a ponta **funcionando** ao fim da janela, mesmo simples.
22
- Sem fatia demonstrável, o escopo está errado.
21
+ 2. **Fatia vertical entregável** — o menor caminho ponta a ponta **funcionando** ao fim da janela ou, sem ela, na primeira entrega,
22
+ mesmo simples. Sem fatia demonstrável, o escopo está errado.
23
23
  3. **Complexidade oculta** — autenticação de terceiros, pagamentos, uploads, tempo real, integrações externas,
24
24
  processamento pesado, mobile nativo, infra e deploy. Para cada uma presente, diga como **cortar, simular ou
25
25
  adiar**.
26
26
  4. **Stack** — está clara e é dominada? Se precisa ser decidida antes, sinalize como pré-requisito bloqueante.
27
27
  5. **Testabilidade (TDD)** — para pelo menos 2 módulos, os **testes críticos** (um de entrada válida e um de caso
28
28
  de erro) escritos antes do código. Se o comportamento essencial é difícil de testar, explique por quê.
29
- 6. **Estimativa realista** — esforço por módulo, soma e comparação com a janela, pessimista onde houver incerteza.
29
+ 6. **Estimativa realista** — esforço por módulo, soma e comparação com a janela quando informada, pessimista onde
30
+ houver incerteza.
30
31
 
31
32
  ## Veredito
32
33
 
33
34
  Feche com **um** dos três, justificado em até 3 linhas:
34
35
 
35
- - ✅ **APROVADO** — cabe na janela. Liste em 1 linha os módulos e a fatia vertical alvo e siga para a etapa
36
- contexto (`/sincronizar-claude-md`), após confirmação.
36
+ - ✅ **APROVADO** — cabe na janela informada ou, sem ela, numa primeira entrega com a fatia vertical. Liste em 1
37
+ linha os módulos e a fatia vertical alvo e siga para a etapa contexto (`/sincronizar-claude-md`), após confirmação.
37
38
  - ✂️ **AJUSTAR** — boa ideia, grande demais. **Reescreva a ideia recortada em 2 a 3 frases**, preservando a
38
39
  essência, pronta para virar SPEC. Diga o que ficou de fora (backlog).
39
40
  - ❌ **REPROVAR** — inviável mesmo recortada. Explique o porquê e **proponha uma alternativa no mesmo domínio**