@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.
- package/.claude-plugin/plugin.json +2 -2
- package/README.md +94 -1
- package/dist/cli.js +1 -0
- package/dist/config/config.js +24 -13
- package/dist/delphi/catalogo.js +308 -0
- package/dist/delphi/classificar.js +27 -2
- package/dist/delphi/command.js +50 -2
- package/dist/delphi/uses.js +90 -0
- package/dist/doctor/checks.js +37 -1
- package/dist/init.js +9 -1
- package/dist/install/perfis.js +15 -4
- package/dist/mapa/extratores/pascal.js +1 -1
- package/dist/update/update.js +80 -23
- package/package.json +1 -1
- package/templates/CLAUDE.md +2 -1
- package/templates/catalog.json +9 -4
- package/templates/hooks/comentarios/check.mjs +62 -5
- package/templates/hooks/hooks.json +2 -1
- package/templates/hooks/lib/config.mjs +1 -0
- package/templates/hooks/padroes-proibidos.mjs +68 -0
- package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +6 -6
- package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +6 -0
- package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
- package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
- package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
- package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
- package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
- package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
- package/templates/skills/auditar-performance/SKILL.md +9 -0
- package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
- package/templates/skills/auditar-seguranca/SKILL.md +55 -14
- package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
- package/templates/skills/auditar-ui/SKILL.md +18 -3
- package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
- package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
- package/templates/skills/harness/references/validar-ideia.md +7 -6
- package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
- package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
- package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
- package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
- package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
- package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
- package/templates/skills/security-audit/HUNTING.md +251 -0
- package/templates/skills/security-audit/LICENSE +21 -0
- package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
- package/templates/skills/security-audit/ORIGEM.md +51 -0
- package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
- package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
- package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
- package/templates/skills/security-audit/SKILL.md +192 -0
- package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
- package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
- package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
- package/templates/skills/security-audit/report-schema.json +461 -0
- package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
- package/templates/skills/security-audit/validate-findings.cjs +773 -0
- package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
- package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
- package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
- package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
- package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
- package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
- package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
- package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-best-practices/README.md +123 -0
- package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
- package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
- package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
- package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
- package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
- package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
- package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
- package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
- package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
- package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
- package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
- package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
- package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-native-skills/README.md +165 -0
- package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
- package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
- package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
- package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
- package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
- package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
- package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
- package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
- 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
|
-
|
|
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
|
|
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
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
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
|
|
49
|
-
severidade e veredito LGPD, achados críticos primeiro, segurança técnica, conformidade LGPD por
|
|
50
|
-
formato do relatório da `lgpd-checker`), pontos positivos e plano de ação
|
|
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 —
|
|
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
|
-
|
|
75
|
-
|
|
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 —
|
|
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
|
|
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
|
|
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 MB`, `⌘ 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
|
|
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,
|
|
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
|
|
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
|
|
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**
|