Ir ao conteúdo
SEED engenharia

Boas práticas

Cabeçalho — seed-praticas.md

seed-praticas.md v1.13 · §cabeçalhoseção 1 de 25_cabecalho.md · MD5 24e0b743

Arquivo canônico de ORIENTAÇÃO, não de regra de marca. Estado: estável (orientação em vigor, não regra de marca) · Versão: v1.13 · Data: 2026-10-24 · Decisor: Rafael Sant'Ana.

O que é: a base de conhecimento da SEED sobre COMO SE FAZ BEM cada tipo de material — carrossel, post, apresentação, proposta, mensagem, mockup, código com o design system, documento técnico de engenharia, fotografia de obra, acessibilidade fora da tela, vídeo curto, e-mail, anúncio pago, artigo e sinalização de campo. Prática de mercado, reunida aqui para que quem produz (pessoa ou agente de IA, pela skill seed-ds) não precise pesquisar na internet a cada peça. Manutenção manual, por decisão dele (F9.5, MANIFESTO §168): cada seção é datada e diz de onde veio; atualizar é editar a seção, datar de novo e registrar no §15.

REGRA DE PRECEDÊNCIA (lida antes de qualquer seção): onde este arquivo contradisser o marca-seed.md, o seed-tokens.json, o seed-componentes.md, o seed-composicao.md ou o sobreaseed.md, eles vencem, sem exceção. Valor de cor, fonte, token, medida de logotipo e dado institucional citados aqui não são fonte — a fonte é o canon de marca, e aqui é orientação de como se faz.

✅ As 14 seções importadas estão auditadas (F9.8, 2026-09-07 e 08 — MANIFESTO §188 a §191). Elas foram trazidas em bloco, sem edição, das referências das skills seed-ds-* de 2026-05-13, e a auditoria achou muita coisa: afirmação de desempenho sem autor nem amostra, número verdadeiro colado no rótulo errado, cor e tipografia que não existem mais no design system, dado institucional falso, nome de organização real usado como cliente fictício e até uma oferta comercial que a base tinha criado sozinha. O que sobreviveu está etiquetado pela régua da §1.0, e o que não pôde ser provado está dito na cara, seção por seção, no bloco "o que ficou de fora".

🆕 E a base cresceu: as bases NOVAS começaram a entrar (F9.8, onda 5 — veredito V-B2 dele, MANIFESTO §186). São oito, aprovadas sem corte, e as oito estão aqui: §16 documento técnico de engenharia (o entregável da engenharia elétrica, que o acervo especificava na forma e não na escrita) · §17 fotografia de obra (quatro peças pedem "rol de fotos" e nenhuma dizia como a foto tem de ser) · §18 acessibilidade fora da tela (medida na web pelo acervo, ausente em post, vídeo, PDF e slide) · §19 vídeo curto e Reels · §20 e-mail de conteúdo · §21 anúncio pago · §22 artigo e conteúdo longo · §23 sinalização e impresso de campo. Diferente das 14 importadas, estas nascem já sob a régua de etiquetas — e trouxeram a quinta etiqueta, a [norma], porque lei e norma técnica não cabiam em nenhuma das quatro.

⚠ A regra de precedência continua valendo, e por um motivo que não envelhece: o canon de marca muda, e uma orientação escrita hoje pode divergir dele amanhã sem que ninguém perceba. Foi o que aconteceu entre maio e setembro de 2026 com cinco cores e quatro tamanhos de texto. A guarda guarda-praticas.py mede o vencimento de cada seção; a precedência protege o intervalo.

Como a skill seed-ds usa isto: pelo modo do pedido (peça, texto, apresentação, código) ela lê a seção correspondente daqui DEPOIS do canon de marca, e aplica a prática só no que não contradiz a marca. O que faltar aqui vira pedido de cobertura (modelo na skill) — é assim que a base cresce.


Esc