# Relatório e apoios opcionais

A pessoa não precisa de programa nem JSON para usar esta Skill. Um parecer em linguagem comum é suficiente quando permite entender a conclusão, sua sustentação e o próximo trabalho. Escolha tabela somente quando as relações ficam mais fáceis de comparar. Preserve identidade e alcance sem transformar a resposta num formulário.

## Forma de devolução

1. Conclusão e ajuste de maior consequência, ou contribuição suficiente reconhecida.
2. Objeto, localização/edição examinada, pergunta, alcance e limite.
3. Achados com referência/trecho, critério quando útil, diferença, consequência, correção e conferência afetada. Dependências inacessíveis ficam explícitas.
4. O que foi efetivamente conferido ou corrigido, condição resultante e próximo movimento. Não converter documento em prova de execução ou benefício humano.

A matriz por critério pode ficar em anexo consultável. O [instrumento](criterios.md) e [método de síntese](aplicar-criterios.md) governam a leitura. O resumo não apaga pendências nem promove exame focal a integral.

## Dados estruturados

Use `criterios.json` quando precisar registrar ou conferir mecanicamente os mesmos 42 critérios. É cópia distribuída da régua geral; a manutenção conserva IDs e a relação com o capítulo de origem. O texto legível e JSON devem permanecer correspondentes. Mudança de instrumento não altera automaticamente registros históricos nem converte uma avaliação antiga para a nova régua.

Um relatório JSON tem `checklist_version` igual à edição do instrumento, `agent.name`, `scope.kind` (`completa` ou `focal`) e `criteria`. Cada linha tem `id`, `status` e as referências/justificativas correspondentes. `status` admite `Em ordem`, `Ajustar`, `Não se aplica` ou `null`. Use `references` como lista de referências localizadas, `notes` para sustentação/limite, `adjustment` para ajuste concreto e `reason` para dispensa. Em ordem e Ajustar exigem `notes` com sustentação textual, além das referências. Uma linha sem conclusão precisa de `notes` que explique a dependência; quando informado em outra situação, `notes` também deve ser texto. A edição do agente, se identificada, pode constar separadamente em `agent.version`.

Exemplo mínimo de formato, sem atribuir avaliação a agente real:

```json
{
  "checklist_version": "1.0.0",
  "agent": {"name": "Agente do exemplo"},
  "scope": {"kind": "focal", "description": "Somente correspondência da entrada"},
  "criteria": [{"id": "ES-03", "status": null, "notes": "Original da entrada não foi disponibilizado; correspondência não concluída."}],
  "priority_adjustment": "Obter o original pertinente para concluir a comparação."
}
```

`dimension_results`, quando informado, deve coincidir com a síntese calculável. O conferidor não inventa classificação para critérios não examinados. Ajuste confirmado continua visível mesmo quando outro critério depende de leitura; a saída também lista pendentes e não examinados. Sem classificação por dimensão, a conclusão focal pode continuar plenamente útil.

## Conferência formal opcional

Se houver Python 3 disponível, o assistente pode executar `python3 scripts/conferir-relatorio.py caminho-do-relatorio.json` a partir da pasta da Skill. O programa não altera o relatório e usa apenas a biblioteca padrão. Pode ser executado por caminho absoluto, sem depender da pasta atual, pois resolve o instrumento pela própria localização. A pessoa não precisa instalar Python para seguir o método manual.

O programa confere edição da régua, identidade, alcance, IDs, duplicatas, situações permitidas, referências/justificativas exigidas, cobertura completa quando declarada e coerência de síntese. Saída normal é JSON; erro formal retorna código 2. Referência preenchida não prova leitura, justificativa preenchida não prova dispensa, ajuste escrito não prova correção. Conteúdo, utilidade e autoridade continuam sob julgamento fundamentado.
