Convenções do dossiê

Leia antes de escrever qualquer arquivo. O _meta/briefing.md explica o que pesquisar; este arquivo explica como registrar.

1. Idioma e estilo

• Tudo em português do Brasil, direto, sem tom de curso.
• Sem hífen e sem travessão em texto corrido. Vírgula, ponto ou parênteses no lugar. Palavra composta se escreve junto ou separada (pós processamento, sob demanda, print farm). Hífen só em nome de arquivo, id, URL, flag de comando e trecho de código.
• Sem tabela de Markdown em prosa. Dado tabular vai para YAML ou CSV. Em prosa, lista com asterisco.
• Título de vídeo, de tópico e de matéria é citado como está, entre aspas, mesmo que tenha hífen: citação literal não se altera.

2. Nomes de arquivo e pasta

• Minúsculo, kebab, sem acento, sem caractere especial.
• Pasta de assunto não leva data. Arquivo de captura (transcrição, captura de página, dado bruto) leva AAAA-MM-DD- na frente.
• Seções numeradas com dois dígitos: 01-mercado/, 02-maquinas/. Documentos dentro da seção também: 01-comparativo-fdm.md.
• Perfil de empresa: 06-empresas/perfis/<slug-da-empresa>.md. Tópico destrinchado: 08-comunidade-e-foruns/destrinchados/<slug-do-topico>.md. Transcrição: 07-canais-e-criadores/transcricoes/AAAA-MM-DD-<canal>-<titulo-curto>.md (a data é a de publicação do vídeo).
• Nunca renomear arquivo já referenciado por outro sem atualizar a referência.

3. Frontmatter obrigatório em todo .md

---
titulo: Comparativo de filamentos de marcas nacionais
slug: comparativo-marcas-nacionais
secao: "03-filamentos"
versao: 1
criado_em: 2026-09-04
atualizado_em: 2026-09-04
status: rascunho          # rascunho | revisado | final
confianca_geral: media    # alta | media | baixa
palavras_chave: [filamento, pla, petg, preco, brasil]
fontes_principais:
  - id: fonte-national3d-filamentos
numeros_criticos: 7       # quantas afirmações numéricas o documento carrega
numeros_verificados: 5    # quantas foram checadas em segunda fonte
resumo: >
  Uma frase única dizendo o que este documento conclui, para o índice.
---

Ciclo de status: rascunho (escrito, não checado), revisado (passou por verificação adversarial e as correções foram aplicadas), final (fechado na task 5). confianca_geral é a confiança média das afirmações do documento, não a sua vontade.

scripts/validar-frontmatter.py confere tudo isso e falha se um id de fonte não existir no catálogo.

Como contar numeros_criticos, decidido na task 4

Até a task 3 conviviam dois critérios, contar ocorrência de número e contar frase com número, e a diferença chegava a cinco vezes no mesmo arquivo. O critério canônico agora é executável e está em scripts/contar-numeros-criticos.py:

• Uma afirmação numérica é cada valor numérico distinto afirmado no corpo. Conta dinheiro, percentual, medida com unidade, contagem e razão.
• Não conta: ano isolado, data, número dentro de id de fonte, de URL, de nome de arquivo, de norma (LC 123/2006, artigo 18A) ou de bloco de código. O frontmatter também não conta.
• O mesmo valor repetido no documento conta uma vez, e a grafia é normalizada antes (R$ 79,00 e R$ 79 são o mesmo número).
• Duas decisões explicam o desenho. Contar por frase mistura grandezas: “a peça de R$ 39,90 paga R$ 11,98 de taxa, ou 30,0 por cento” carrega três números que podem estar errados de forma independente. E contar cada ocorrência infla: num documento de tarifa o valor R$ 79,00 aparece quinze vezes e continua sendo um número para conferir. Valor distinto é exatamente o que a verificação vai ter de checar, um a um.

numeros_verificados continua sendo contagem humana do agente: quantas daquelas afirmações têm segunda fonte independente ou fonte primária aberta e lida. Ele nunca pode ser maior que numeros_criticos.

4. Fonte por id, nunca URL solta

Toda fonte é registrada uma vez em _meta/fontes.yaml e referenciada por id em todo lugar. No corpo do texto, cite assim: `1`. Em YAML de dado, o campo fonte recebe o id.

Esquema de uma fonte:

- id: fonte-national3d-filamentos
  nome: Loja oficial National3D
  url: https://www.lojanational3d.com.br/
  tipo: loja              # loja | canal | video | forum | topico | empresa | imprensa | relatorio | api | repositorio | academico | orgao-publico | evento | outro
  idioma: pt-BR
  acessado_em: 2026-09-04
  metodo_de_acesso: curl  # curl | navegador | api | download | rss | websearch
  status_do_acesso: ok    # ok | nao-aberto | bloqueado-cloudflare | 403 | 404 | paywall | exige-login
  confianca: alta         # alta = primária lida na íntegra; media = secundária confiável; baixa = citação de terceiro
  e_primaria: true
  conflita_com: []        # ids de fontes que dizem outra coisa
  observacao: >
    O preço no Pix é cerca de 10 por cento menor que o promocional. Registre os dois.

Os campos tipo_bruto, frente_de_origem e tamanho existem nas entradas semeadas pelo script e podem ficar.

5. Esquemas dos YAML de dado

Cada YAML de dado tem o esquema exemplificado na primeira entrada do próprio arquivo e no _meta/briefing.md seção 5. Regras comuns a todos:

• id único, prefixado pelo tipo: canal-, video-, comunidade-, topico-, empresa-, imprensa-, case-, maquina-, filamento-, nicho-.
• coletado_em sempre presente. Dado sem data é dado inválido.
• confianca em toda entrada: alta só quando a página foi aberta e lida.
• fonte aponta para um id do catálogo.
• Campo desconhecido é null, nunca string vazia nem chute.
• Preço no Brasil tem três versões: tabela_brl, promocional_brl, pix_brl (ou pix_ou_avista_brl em máquina). Um negócio real paga o do Pix.
• Propriedade mecânica de filamento tem dois blocos separados: propriedades_declaradas (datasheet do fabricante) e propriedades_medidas (ensaio de terceiro, com fonte e data). Nunca misturar.

Validação: sh scripts/validar-yaml.sh roda o Psych do Ruby em todos os YAML. Rode antes de fechar qualquer task.

6. Regras de qualidade

• Não inventar. URL, empresa ou número sem fonte é o pior resultado possível. Se não achou, vai para _meta/lacunas.md com o que foi tentado.
• Todo número carrega valor, fonte (id) e data de validade.
• Separar o que foi lido (abri_e_li) do que foi visto em listagem (vi_em_listagem) e do que é lembrança (nao_confirmado).
• Contradição entre fontes se registra nas duas, com conflita_com, e o texto diz qual é mais confiável e por quê.
• Fonte única e autodeclarada (blog de vendedor medindo a própria bancada) é relato, não estatística. Pode ser citada, rotulada.
• Número que entra no sumário executivo precisa de duas fontes independentes ou rótulo explícito de não verificado.
• Case só é brasileiro depois de confirmar cidade e nome da pessoa. Já aconteceu de um case americano circular em seis veículos brasileiros como se fosse local.
• Projeto de lei não é lei. Registrar o status real da tramitação.

7. Rastros obrigatórios

• _meta/log-de-coleta.md: uma linha por coleta, append only, com data, o que foi coletado, método, resultado e onde foi salvo.
• _meta/lacunas.md: o que não foi possível apurar. Nunca vazio.
• _meta/metodologia.md: o que funciona e o que está bloqueado, atualizado quando algo mudar.
• transcript/: ao fechar cada task, rodar node scripts/salvar-transcript.mjs latest <nome> e preencher a linha de subagentes na ficha técnica.
• data/brutos/: todo JSON, CSV ou JSONL cru baixado, com nome datado. Bruto não se edita.

Este documento cita 1 fonte

As fontes estão numeradas na ordem em que aparecem no texto. Cada número no texto leva à entrada correspondente; a data ao lado do id é a data de acesso registrada na citação.

1. 1 National3D Filamentos fonte-national3d-filamentos https://www.lojanational3d.com.br/ empresa, fonte primária, confiança alta, lida por curl, catalogada em 04/09/2026. Acesso citado em 04/09/2026.
   observação do catálogo

   Loja de fabrica oficial, linha PLA Max High Speed, ABS Premium MG-94, PETG, TPU Flex 95A e nylon. Expositora da Expo3DBR.

   voltar ao texto