@fontdata/ai-harness 4.2.0 → 4.3.0

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 (38) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +10 -0
  3. package/dist/atalhos/atalhos.js +59 -0
  4. package/dist/cli.js +12 -0
  5. package/dist/comentarios/command.js +7 -1
  6. package/dist/comentarios/instalar.js +63 -11
  7. package/dist/fontes/listar.js +80 -0
  8. package/dist/mapa/config.js +152 -0
  9. package/dist/mapa/extratores/csharp.js +33 -0
  10. package/dist/mapa/extratores/dart.js +31 -0
  11. package/dist/mapa/extratores/go.js +17 -0
  12. package/dist/mapa/extratores/index.js +33 -0
  13. package/dist/mapa/extratores/java.js +7 -0
  14. package/dist/mapa/extratores/js.js +22 -0
  15. package/dist/mapa/extratores/kotlin.js +18 -0
  16. package/dist/mapa/extratores/pascal.js +39 -0
  17. package/dist/mapa/extratores/php.js +18 -0
  18. package/dist/mapa/extratores/python.js +19 -0
  19. package/dist/mapa/extratores/rust.js +19 -0
  20. package/dist/mapa/extratores/tipos.js +1 -0
  21. package/dist/mapa/mapa.js +123 -0
  22. package/dist/update/update.js +14 -2
  23. package/dist/versao/config.js +1 -1
  24. package/package.json +1 -1
  25. package/templates/agents/auditor-plano.md +4 -1
  26. package/templates/agents/investigador.md +3 -0
  27. package/templates/agents/qa.md +1 -0
  28. package/templates/agents/revisor-spec.md +6 -3
  29. package/templates/agents/revisor-testes.md +3 -1
  30. package/templates/commands/revisar-pr.md +21 -3
  31. package/templates/hooks/comentarios/check.mjs +208 -41
  32. package/templates/rules/comentarios.md +8 -2
  33. package/templates/skills/auditar-performance/SKILL.md +11 -1
  34. package/templates/skills/auditar-seguranca/SKILL.md +8 -0
  35. package/templates/skills/auditar-ui/SKILL.md +8 -0
  36. package/templates/skills/evoluir-harness/references/code-reviewer.md +16 -5
  37. package/templates/skills/executar-plan/references/delegacao.md +14 -3
  38. package/templates/skills/nova-tarefa/references/isso-ja-existe.md +3 -0
@@ -0,0 +1,39 @@
1
+ function semComentariosPascal(texto) {
2
+ return texto.replace(/\{[^}]*\}|\(\*[\s\S]*?\*\)|\/\/[^\n]*/g, (m) => m.replace(/[^\n]/g, ' '));
3
+ }
4
+ function simbolosPascal(texto) {
5
+ const limpo = semComentariosPascal(texto);
6
+ const inicio = /^\s*interface\b/im.exec(limpo);
7
+ if (!inicio)
8
+ return [];
9
+ const resto = limpo.slice(inicio.index + inicio[0].length);
10
+ const fim = /^\s*implementation\b/im.exec(resto);
11
+ const secao = fim ? resto.slice(0, fim.index) : resto;
12
+ const simbolos = [];
13
+ let profundidade = 0;
14
+ for (const linha of secao.split('\n')) {
15
+ const tipo = /^\s*([A-Za-z_]\w*)\s*=\s*(?:packed\s+)?(class|record|interface|dispinterface)\b(.*)$/i.exec(linha);
16
+ if (tipo) {
17
+ const depois = tipo[3] ?? '';
18
+ if (/^\s*;/.test(depois) || /^\s*of\b/i.test(depois))
19
+ continue;
20
+ if (profundidade === 0)
21
+ simbolos.push(tipo[1] ?? '');
22
+ if (!/^\s*(\([^)]*\))?\s*;/.test(depois))
23
+ profundidade++;
24
+ continue;
25
+ }
26
+ if (profundidade > 0) {
27
+ if (/:\s*(?:packed\s+)?record\b/i.test(linha))
28
+ profundidade++;
29
+ else if (/^\s*end\s*;/i.test(linha))
30
+ profundidade--;
31
+ continue;
32
+ }
33
+ const rotina = /^\s*(?:function|procedure)\s+([A-Za-z_]\w*)\s*(?![\w.])/i.exec(linha);
34
+ if (rotina)
35
+ simbolos.push(`${rotina[1]}()`);
36
+ }
37
+ return simbolos;
38
+ }
39
+ export const extratorPascal = { nome: 'pascal', extrair: simbolosPascal };
@@ -0,0 +1,18 @@
1
+ const TIPO = /^\s*(?:(?:abstract|final|readonly)\s+)*(?:class|interface|trait|enum)\s+([A-Za-z_]\w*)/;
2
+ const FUNCAO = /^\s*((?:(?:public|private|protected|static|abstract|final)\s+)*)function\s+&?\s*([A-Za-z_]\w*)\s*\(/;
3
+ const RESTRITO = /\b(?:private|protected)\b/;
4
+ function simbolosPhp(texto) {
5
+ const simbolos = [];
6
+ for (const linha of texto.split('\n')) {
7
+ const tipo = TIPO.exec(linha)?.[1];
8
+ if (tipo) {
9
+ simbolos.push(tipo);
10
+ continue;
11
+ }
12
+ const funcao = FUNCAO.exec(linha);
13
+ if (funcao && !RESTRITO.test(funcao[1] ?? ''))
14
+ simbolos.push(`${funcao[2]}()`);
15
+ }
16
+ return simbolos;
17
+ }
18
+ export const extratorPhp = { nome: 'php', extrair: simbolosPhp };
@@ -0,0 +1,19 @@
1
+ const NOME = '(\\p{L}[\\p{L}\\p{N}_]*)';
2
+ const FORMAS_PYTHON = [
3
+ [new RegExp(`^(?:async\\s+)?def\\s+${NOME}`, 'u'), (n) => `${n}()`],
4
+ [new RegExp(`^class\\s+${NOME}`, 'u'), (n) => n],
5
+ ];
6
+ function simbolosPython(texto) {
7
+ const simbolos = [];
8
+ for (const linha of texto.split('\n')) {
9
+ for (const [forma, formatar] of FORMAS_PYTHON) {
10
+ const nome = forma.exec(linha)?.[1];
11
+ if (nome) {
12
+ simbolos.push(formatar(nome));
13
+ break;
14
+ }
15
+ }
16
+ }
17
+ return simbolos;
18
+ }
19
+ export const extratorPython = { nome: 'python', extrair: simbolosPython };
@@ -0,0 +1,19 @@
1
+ const NOME = '([A-Za-z_]\\w*)';
2
+ const FORMAS_RUST = [
3
+ [new RegExp(`^\\s*pub\\s+(?:(?:const|async|unsafe|extern(?:\\s+"[^"]*")?)\\s+)*fn\\s+${NOME}`), (n) => `${n}()`],
4
+ [new RegExp(`^\\s*pub\\s+(?:unsafe\\s+)?(?:struct|enum|trait|type|mod|const)\\s+${NOME}`), (n) => n],
5
+ ];
6
+ function simbolosRust(texto) {
7
+ const simbolos = [];
8
+ for (const linha of texto.split('\n')) {
9
+ for (const [forma, formatar] of FORMAS_RUST) {
10
+ const nome = forma.exec(linha)?.[1];
11
+ if (nome) {
12
+ simbolos.push(formatar(nome));
13
+ break;
14
+ }
15
+ }
16
+ }
17
+ return simbolos;
18
+ }
19
+ export const extratorRust = { nome: 'rust', extrair: simbolosRust };
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,123 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { basename, extname, join, posix, relative, resolve } from 'node:path';
3
+ import { listarFontes } from '../fontes/listar.js';
4
+ import { suggestFlag } from '../install/flags.js';
5
+ import { acharRaiz } from '../raiz.js';
6
+ import { lerConfigMapa, MapaConfigErro } from './config.js';
7
+ import { extratorPara } from './extratores/index.js';
8
+ const PASTAS_COMPARTILHADAS = new Set([
9
+ 'lib', 'utils', 'util', 'shared', 'common', 'core', 'comum', 'compartilhado', 'helpers',
10
+ ]);
11
+ const LIMITE_PADRAO = 4000;
12
+ const FLAGS = ['--limite'];
13
+ function simbolosDoArquivo(caminho, doProjeto) {
14
+ const extensao = extname(caminho).toLowerCase();
15
+ const extrator = doProjeto.get(extensao) ?? extratorPara(extensao);
16
+ if (!extrator)
17
+ return [];
18
+ const texto = readFileSync(caminho, 'utf8').replace(/\r\n?/g, '\n');
19
+ return [...new Set(extrator.extrair(texto))];
20
+ }
21
+ function compartilhada(pasta) {
22
+ return PASTAS_COMPARTILHADAS.has(posix.basename(pasta).toLowerCase());
23
+ }
24
+ /**
25
+ * Símbolos públicos por pasta imediata, em texto, com as pastas compartilhadas primeiro e corte por pasta inteira
26
+ * em `limite` caracteres. `pasta` (relativa à raiz, com `/`) restringe a listagem a essa subpasta.
27
+ * O regex do `.ai-harness/mapa.json` substitui o extrator embutido da extensão; config inválida lança `MapaConfigErro`.
28
+ */
29
+ export function gerarMapa(raiz, opcoes) {
30
+ const prefixo = opcoes.pasta ? `${opcoes.pasta.replace(/\/+$/, '')}/` : '';
31
+ const doProjeto = lerConfigMapa(raiz);
32
+ const porPasta = new Map();
33
+ for (const rel of listarFontes(raiz, [...doProjeto.keys()])) {
34
+ if (!rel.startsWith(prefixo))
35
+ continue;
36
+ const simbolos = simbolosDoArquivo(join(raiz, rel), doProjeto);
37
+ if (simbolos.length === 0)
38
+ continue;
39
+ const pasta = posix.dirname(rel);
40
+ const linhas = porPasta.get(pasta) ?? [];
41
+ linhas.push(` ${basename(rel)}: ${simbolos.join(', ')}`);
42
+ porPasta.set(pasta, linhas);
43
+ }
44
+ const blocos = [...porPasta.entries()]
45
+ .map(([pasta, linhas]) => ({ cabecalho: pasta === '.' ? './' : `${pasta}/`, linhas, comum: compartilhada(pasta) }))
46
+ .sort((a, b) => Number(b.comum) - Number(a.comum) || (a.cabecalho < b.cabecalho ? -1 : 1));
47
+ const saida = [];
48
+ let tamanho = -1;
49
+ let exibidas = 0;
50
+ let arquivosCortados = 0;
51
+ for (const bloco of blocos) {
52
+ const texto = [bloco.cabecalho, ...bloco.linhas].join('\n');
53
+ if (exibidas > 0 && tamanho + 1 + texto.length > opcoes.limite)
54
+ break;
55
+ if (exibidas === 0 && texto.length > opcoes.limite) {
56
+ const [primeira, ...demais] = bloco.linhas;
57
+ saida.push(bloco.cabecalho, primeira ?? '');
58
+ tamanho = bloco.cabecalho.length + 1 + (primeira ?? '').length;
59
+ for (const linha of demais) {
60
+ if (tamanho + 1 + linha.length > opcoes.limite) {
61
+ arquivosCortados++;
62
+ continue;
63
+ }
64
+ saida.push(linha);
65
+ tamanho += 1 + linha.length;
66
+ }
67
+ }
68
+ else {
69
+ saida.push(texto);
70
+ tamanho += 1 + texto.length;
71
+ }
72
+ exibidas++;
73
+ }
74
+ const foraPastas = blocos.length - exibidas;
75
+ if (foraPastas > 0 || arquivosCortados > 0) {
76
+ const partes = [];
77
+ if (arquivosCortados > 0)
78
+ partes.push(`${arquivosCortados} arquivo(s) de ${blocos[0]?.cabecalho}`);
79
+ if (foraPastas > 0)
80
+ partes.push(`${foraPastas} ${foraPastas === 1 ? 'pasta' : 'pastas'}`);
81
+ const verbo = foraPastas + arquivosCortados === 1 ? 'ficou' : 'ficaram';
82
+ saida.push(`... ${partes.join(' e ')} ${verbo} de fora (limite de ${opcoes.limite} caracteres); ` +
83
+ 'detalhe com: npx @fontdata/ai-harness mapa <pasta>');
84
+ }
85
+ return saida.join('\n');
86
+ }
87
+ /** `mapa [caminho] [--limite <n>]`: imprime o mapa e sai com 0; com `.ai-harness/mapa.json` inválido, diz o campo e sai com 1. */
88
+ export function runMapCommand(argv) {
89
+ let caminho;
90
+ let limite = LIMITE_PADRAO;
91
+ for (let i = 0; i < argv.length; i++) {
92
+ const token = argv[i] ?? '';
93
+ if (!token.startsWith('-')) {
94
+ if (caminho !== undefined)
95
+ throw new Error(`Argumento inesperado: ${token}`);
96
+ caminho = token;
97
+ continue;
98
+ }
99
+ if (token !== '--limite') {
100
+ const sugestao = suggestFlag(token, FLAGS);
101
+ throw new Error(`Flag desconhecida: ${token}.${sugestao ? ` Você quis dizer ${sugestao}?` : ''}`);
102
+ }
103
+ const valor = Number(argv[++i]);
104
+ if (!Number.isInteger(valor) || valor <= 0)
105
+ throw new Error('--limite precisa de um número inteiro maior que zero.');
106
+ limite = valor;
107
+ }
108
+ const alvo = caminho === undefined ? acharRaiz() : resolve(process.cwd(), caminho);
109
+ const raiz = acharRaiz(alvo);
110
+ const pasta = relative(raiz, alvo).split(/[\\/]/).filter(Boolean).join('/');
111
+ let mapa;
112
+ try {
113
+ mapa = gerarMapa(raiz, { limite, pasta });
114
+ }
115
+ catch (erro) {
116
+ if (!(erro instanceof MapaConfigErro))
117
+ throw erro;
118
+ console.error(erro.message);
119
+ return 1;
120
+ }
121
+ console.log(mapa || 'Nenhum símbolo público encontrado.');
122
+ return 0;
123
+ }
@@ -1,7 +1,7 @@
1
1
  import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
2
2
  import { dirname, join, resolve } from 'node:path';
3
3
  import { allCommands, loadCatalog } from '../catalog.js';
4
- import { COMMENTS_HOOK_PATH, COMMENTS_HOOK_TEMPLATE, commentsHooksConfig, ensureCommentsBaseline, hookProprio, hookProprioRegistrado } from '../comentarios/instalar.js';
4
+ import { COMMENTS_HOOK_PATH, COMMENTS_HOOK_TEMPLATE, commentsHooksConfig, completarCommentsBaseline, descreverCompletarBaseline, descreverLimpezaBaseline, ensureCommentsBaseline, hookProprio, hookProprioRegistrado, limparCommentsBaseline } from '../comentarios/instalar.js';
5
5
  import { CONFIG_PATH, gravarInstalarComentarios, gravarRegistrarMcp, migrarSecaoBanco, readConfig, syncGitignore, temSecaoBancoLegada, writeDefaultConfig, } from '../config/config.js';
6
6
  import { applyAtomically } from '../install/atomic.js';
7
7
  import { suggestFlag } from '../install/flags.js';
@@ -218,6 +218,19 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
218
218
  const settings = mergeSettings(root, { hooks, allow: harnessPermissions({ banco: report.permissoesBanco }), deny: HARNESS_DENY, removeAllow: BANCO_PERMISSIONS_LEGADAS }, now);
219
219
  if (settings.changed)
220
220
  ajustes.push(`${SETTINGS_PATH} atualizado${settings.backup ? ` (backup em ${settings.backup})` : ''}.`);
221
+ const avisos = [];
222
+ // Uma falha na limpeza ou no acréscimo da catraca nunca deixa o update pela metade, sem lock.
223
+ try {
224
+ const limpeza = write.length ? descreverLimpezaBaseline(limparCommentsBaseline(root)) : null;
225
+ if (limpeza)
226
+ ajustes.push(limpeza);
227
+ const acrescimo = write.length ? descreverCompletarBaseline(completarCommentsBaseline(root)) : null;
228
+ if (acrescimo)
229
+ ajustes.push(acrescimo);
230
+ }
231
+ catch (error) {
232
+ avisos.push(error instanceof Error ? error.message : String(error));
233
+ }
221
234
  if (report.registrarComentarios)
222
235
  ensureCommentsBaseline(root);
223
236
  if (report.adotada) {
@@ -230,7 +243,6 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
230
243
  writeFileSync(projectRule, projectRuleContent(renamed.map(({ para }) => para)));
231
244
  }
232
245
  }
233
- const avisos = [];
234
246
  if (report.registrarMcp && report.mudancaMcp === 'invalido')
235
247
  avisos.push(MCP_INVALIDO);
236
248
  else if (report.registrarMcp) {
@@ -59,7 +59,7 @@ export function parseCaminhoJson(texto) {
59
59
  }
60
60
  return chaves.length > 0 ? chaves : null;
61
61
  }
62
- function contarGrupos(padrao) {
62
+ export function contarGrupos(padrao) {
63
63
  return (new RegExp(`${padrao}|`).exec('')?.length ?? 1) - 1;
64
64
  }
65
65
  function contarSegmentosDoFormato(formato) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fontdata/ai-harness",
3
- "version": "4.2.0",
3
+ "version": "4.3.0",
4
4
  "description": "Harness de engenharia com IA da Fontdata para Claude Code: roda os slash commands direto na pasta do projeto via npx, sem instalar nada — ou instala-os em .claude/commands.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -32,9 +32,12 @@ Use `Bash` só para rodar o `doctor` e ler o histórico: você é somente leitur
32
32
  ## Saída
33
33
 
34
34
  - **Veredito:** `APROVADO` ou `REPROVADO`.
35
- - **Achados** em BLOQUEANTE, IMPORTANTE e SUGESTÃO, cada um apontando a task (`T-SS.NN`) e a correção esperada.
35
+ - **Achados** em BLOQUEANTE, IMPORTANTE e SUGESTÃO, cada um apontando a task (`T-SS.NN`), o caso concreto (o
36
+ trecho do plano, as duas tasks que tocam o mesmo arquivo, o critério que não dá para responder com sim ou não) e a
37
+ correção esperada. Achado sem caso concreto não entra.
36
38
  - O valor para o orquestrador gravar em `auditoria_plano` no frontmatter do `PLAN.md` (`aprovado` ou
37
39
  `reprovado`).
40
+ - **Não verificado:** o que ficou sem ler, executar ou medir, e por quê; se nada ficou de fora, "nada".
38
41
 
39
42
  Registre o veredito no rastro:
40
43
 
@@ -26,7 +26,10 @@ ou quando ficou claro que ela ainda é hipótese. Você não corrige o bug.
26
26
  - **Sintoma** e **como reproduzir**.
27
27
  - **Causa raiz:** `comprovada` ou `hipotese`, com a evidência (`arquivo:linha`, trecho do histórico, saída da
28
28
  reprodução).
29
+ - **Hipóteses:** cada hipótese confirmada ou descartada, com o caso concreto que a decidiu (a entrada, o comando ou
30
+ a linha que a confirma ou a derruba). Hipótese sem caso concreto continua aberta.
29
31
  - **Arquivos envolvidos**, para o campo `arquivos` do plano.
30
32
  - **Riscos da correção:** o que mais depende do trecho afetado.
33
+ - **Não verificado:** o que ficou sem ler, executar ou medir, e por quê; se nada ficou de fora, "nada".
31
34
 
32
35
  Não proponha refatorações amplas: a correção mínima fica para o plano do `/resolver-bug`.
@@ -29,6 +29,7 @@ Você não corrige nada: se algo falha, você reporta.
29
29
  - **Veredito:** `APROVADO` ou `REPROVADO`.
30
30
  - Tabela: critério → atendido (sim/não) → evidência.
31
31
  - Resultado da suíte: comando, total de testes e falhas.
32
+ - **Não verificado:** o que ficou sem ler, executar ou medir, e por quê; se nada ficou de fora, "nada".
32
33
 
33
34
  Registre a suíte e o veredito no rastro:
34
35
 
@@ -20,8 +20,9 @@ a coisa errada. Você não edita a SPEC: aponta o que precisa mudar.
20
20
 
21
21
  1. **Especulação:** recurso que ninguém pediu agora, opção ou extensão "para o futuro".
22
22
  2. **Excesso de engenharia:** camada, abstração ou configuração maior do que o problema descrito pede.
23
- 3. **Reuso:** código novo onde já existe função, módulo ou padrão que resolve. Cite o `arquivo` e o símbolo que
24
- você encontrou na busca.
23
+ 3. **Reuso:** código novo onde já existe função, módulo ou padrão que resolve. Antes de aceitar algo novo, rode
24
+ `npx @fontdata/ai-harness mapa` para ver os símbolos públicos por pasta e depois busque. Cite o `arquivo` e o
25
+ símbolo que você encontrou na busca.
25
26
  4. **Sintoma ou causa:** a proposta corrige o efeito visível e deixa a origem do problema no lugar.
26
27
 
27
28
  ## Lente 2: compreensão
@@ -53,8 +54,10 @@ e a divergência entra como achado.
53
54
  Depois:
54
55
 
55
56
  - **Achados** em BLOQUEANTE, IMPORTANTE e SUGESTÃO, cada um com a seção da SPEC afetada, a lente que o
56
- encontrou e a correção esperada.
57
+ encontrou, o caso concreto (o trecho da SPEC, o `arquivo` e o símbolo achados na busca, ou a pergunta que o
58
+ implementador faria) e a correção esperada. Achado sem caso concreto não entra.
57
59
  - **Veredito:** `APROVADO` ou `REPROVADO`. Qualquer BLOQUEANTE reprova.
60
+ - **Não verificado:** o que ficou sem ler, executar ou medir, e por quê; se nada ficou de fora, "nada".
58
61
 
59
62
  Registre o veredito no rastro:
60
63
 
@@ -45,7 +45,9 @@ valor exato.
45
45
  ## Saída
46
46
 
47
47
  - **Veredito:** `APROVADO` ou `REPROVADO`.
48
- - **Achados** em BLOQUEANTE, IMPORTANTE e SUGESTÃO, cada um com `arquivo:linha` e o motivo.
48
+ - **Achados** em BLOQUEANTE, IMPORTANTE e SUGESTÃO, cada um com `arquivo:linha`, o motivo e o caso concreto: a
49
+ implementação errada que passaria no teste ou a entrada que ele deixa de fora. Achado sem caso concreto não entra.
50
+ - **Não verificado:** o que ficou sem ler, executar ou medir, e por quê; se nada ficou de fora, "nada".
49
51
 
50
52
  Registre o veredito no rastro:
51
53
 
@@ -27,6 +27,12 @@ Caso contrário, revise diretamente.
27
27
 
28
28
  ## Passo 3 — Avaliar
29
29
 
30
+ Leia o entorno, não só o diff: quem chama o código alterado e o que ele chama. Se a assinatura ou o comportamento
31
+ mudou, procure todas as chamadas e cite as que não foram ajustadas.
32
+
33
+ Julgue performance e concorrência pela carga que o projeto declara (`SPEC.md`, `CLAUDE.md`, README, configuração de
34
+ deploy). Sem carga declarada, assuma a menor plausível. Nos dois casos, diga qual carga assumiu.
35
+
30
36
  1. **Correção:** bugs, casos de borda, erros silenciados.
31
37
  2. **Aderência** à SPEC e ao plano do trabalho.
32
38
  3. **Testes:** existem e cobrem o crítico? Falhariam com a implementação errada?
@@ -37,9 +43,21 @@ Caso contrário, revise diretamente.
37
43
 
38
44
  ## Passo 4 — Classificar e concluir
39
45
 
40
- Cada achado em **BLOQUEANTE**, **IMPORTANTE** ou **SUGESTÃO**, com `arquivo:linha` e a correção proposta. Termine
41
- com o veredito: **aprovar**, **aprovar com ressalvas** ou **solicitar mudanças**. Com achados a corrigir, ofereça
42
- o Passo 5.
46
+ Sem caso concreto, não é achado: diga a entrada ou situação e o resultado errado que ela produz. O que não tem caso
47
+ vai, no máximo, como pergunta no fecho.
48
+
49
+ Cada achado em **BLOQUEANTE**, **IMPORTANTE** ou **SUGESTÃO**, em 4 partes:
50
+
51
+ - **O que é:** `arquivo:linha` e o trecho;
52
+ - **Problema:** o caso concreto;
53
+ - **Correção:** a mudança proposta;
54
+ - **Se não corrigir:** o que acontece.
55
+
56
+ Use numeração única entre os grupos (1, 2, 3… contínuos de BLOQUEANTE a SUGESTÃO), para o usuário pedir "corrija 2
57
+ e 5". Antes de citar, reconfirme no estado atual do arquivo que o `arquivo:linha` aponta o trecho.
58
+
59
+ Termine com o veredito: **aprovar**, **aprovar com ressalvas** ou **solicitar mudanças**, e com a seção
60
+ **Não verificado**: o que não foi lido, executado ou medido, e por quê. Com achados a corrigir, ofereça o Passo 5.
43
61
 
44
62
  ## Passo 5 — Organizar as correções (opcional, só se o usuário pedir)
45
63