Ir ao conteúdo
SEED engenhariaDesign System

Boas práticas

0. Como usar e manter este arquivo

seed-praticas.md v0.1 · §00seção 2 de 1700-como-usar-e-manter-este-arquivo.md · MD5 ba5dbab5
  • 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.
  • 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 houver seção não auditada; v1.0 quando todas estiverem. Toda edição sobe o número e ganha linha no §15.

Esc