Boas práticas
0. Como usar e manter este arquivo
- Uma seção por tema, numerada; o título diz o material e o recorte (formatos · boas práticas · estrutura). Nova prática de um tema existente entra NA seção dele, com a data; tema novo ganha seção nova no fim, antes do §15.
- O §15 (registro de versões) fica sempre por último e MANTÉM o número 15, mesmo com seções de número maior acima dele. A numeração aqui é identidade, não posição: o §15 é citado por dezenas de linhas de changelog e é excluído por número pela guarda
guarda-praticas.py(junto com o §0, porque nenhum dos dois é prática que envelhece). Renumerá-lo quebraria as duas coisas de uma vez. - Todo trecho tem data e origem. Na v0.1 a origem é a referência de maio/2026 (bloco de procedência no início de cada seção, com o MD5 do arquivo preservado em
09-pesquisa/skills-v1-2026-05/referencias/). Trecho novo declara a fonte (pesquisa datada, medição, decisão dele) — prática de mercado sem data é prática que envelhece em silêncio (regra da casa: citação de norma sai datada). - Auditar uma seção = lê-la contra o canon de marca, remover ou corrigir o que contradiz, apagar o aviso "não auditado" do bloco de procedência e registrar no §15. Até lá, a regra de precedência do cabeçalho protege quem consome.
- O que NÃO entra aqui: regra de marca (vai ao
marca-seed.md), token (seed-tokens.json), componente (seed-componentes.md), dado institucional (sobreaseed.md). Este arquivo é o COMO do mercado; o QUÊ da SEED mora nos outros. - Versão: semântica simples — v0.x enquanto houvesse seção não auditada; v1.0 quando todas estiveram (alcançado em 2026-09-08, com as 14 seções importadas auditadas). Daqui em diante, v1.x: cada seção nova das oito aprovadas no V-B2, cada revisão de ciclo e cada correção sobem o número e ganham linha no §15. A base só volta a 0.x se um dia for reimportada em bloco.