# seed-ds — a skill do SEED Design System para qualquer IA

Uma skill é um pacote de instruções em Markdown com referências e assets: qualquer IA que leia arquivos ou endereços usa (Claude, ChatGPT, Gemini, Copilot, agentes próprios). A seed-ds ensina a IA a consultar este canon por tipo de tarefa, instalar os tokens, usar só os assets oficiais e citar seção e versão; leva um retrato local para trabalhar sem rede e gera um pedido de cobertura quando o canon não cobre. Ela não é o design system: é o caminho até ele.

- Baixar: https://ds.seed.eng.br/10-publicacao/skill/seed-ds.zip
- Ler: https://ds.seed.eng.br/10-publicacao/skill/seed-ds/SKILL.md · pasta: https://ds.seed.eng.br/10-publicacao/skill/seed-ds/ · versão exata: https://ds.seed.eng.br/10-publicacao/skill/seed-ds/VERSAO.json
- Canon de 2026-09-07 — marca v5.38 · componentes v1.45 · tokens v1.23 · boas práticas v0.1

## Como instalar

- Qualquer IA com acesso à web: cole no início da conversa "Use o SEED Design System publicado em https://ds.seed.eng.br. Leia primeiro https://ds.seed.eng.br/10-publicacao/skill/seed-ds/SKILL.md e siga-o; os arquivos que ele cita estão na mesma pasta."
- IA sem web, com arquivos (projetos do ChatGPT, Gems, Copilot): envie a pasta descompactada como arquivos do projeto e instrua "siga o SKILL.md".
- claude.ai: em Configurações, área de Skills, envie o seed-ds.zip inteiro (uma vez por conta).
- Claude Code: peça "instale a skill seed-ds a partir de https://ds.seed.eng.br/skill/", ou rode `curl -sSLO https://ds.seed.eng.br/10-publicacao/skill/instalar.py && python instalar.py` (baixa, confere MD5 e instala em ~/.claude/skills/seed-ds; --destino .claude/skills para um projeto só).
- Agentes por API e outros que leem skills de uma pasta (formato aberto Agent Skills): instale a pasta seed-ds/ ou envie-a pela plataforma; sem suporte ao formato, aponte o SKILL.md no ar.

## Como ela se mantém atualizada

Toda vez que usa a rede, a skill compara a versão da cópia (metadata.versao / VERSAO.json) com a publicada em https://ds.seed.eng.br/10-publicacao/skill/seed-ds/VERSAO.json e avisa se houver versão nova. No Claude Code, com autorização da pessoa, scripts/atualizar.py baixa o zip, confere o MD5 de cada arquivo e troca a pasta instalada. No claude.ai e na API a pessoa baixa o zip de novo e substitui a cópia.

## Os quatro modos

- **código** — quando: tela, componente, página, formulário, código React/Tailwind/shadcn, refatorar para o DS, mockup estático. Consulta: registry (instala os tokens) → componente § → composição → telas → ícones.
- **peça** — quando: proposta, placa, cartão, timbrado, crachá, etiqueta, uniforme, frota, post, capa, one-pager — o que vira PNG, PDF ou impresso. Consulta: spec §12 → template aprovado → grafismo gerado na medida → assets oficiais.
- **texto** — quando: e-mail, WhatsApp, mensagem, texto institucional, microcópia, legenda. Consulta: grafia da marca → linguagem editorial → voz → sistema de e-mail.
- **apresentação / documento** — quando: deck, slides, documento com a marca que não é peça do §12. Consulta: marca §13 → peças do §12 quando houver → tokens e fontes.

## Quando o canon não cobre

A IA entrega o mais próximo, marcado como provisório, e um pedido de cobertura preenchido para enviar a contato@seed.eng.br com o assunto "[DS] pedido de cobertura — …". Cada pedido vira pendência com código (LC) no roadmap. Formulário público previsto (F9.7).