# Plugin `seed-ds` para o Claude Code — SEED Design System 2026.10.31+89194dea

Este plugin é **um caminho por arquivo** até o SEED Design System (DS), gerado por `06-validacao/geradores/gen-plugin.py` a partir da skill `seed-ds`
publicada (canon de 2026-10-31). **O caminho principal continua sendo o endereço público**, que serve a **qualquer IA** sem
instalar nada: 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."* O `llms.txt` (https://ds.seed.eng.br/llms.txt) é a porta de
entrada de máquina. Só use o plugin se o seu agente é o Claude Code e você quer a skill e três atalhos já instalados.

## Instalar (2 comandos)

```
claude plugin marketplace add https://ds.seed.eng.br/10-publicacao/plugin/marketplace.json
claude plugin install seed-ds@seed-ds
```

Dentro de uma sessão, os mesmos dois passos são `/plugin marketplace add https://ds.seed.eng.br/10-publicacao/plugin/marketplace.json` e
`/plugin install seed-ds@seed-ds`. Precisa de Claude Code 2.1.224 ou mais novo (fonte `archive`); não precisa de `git`
nem de conta. Atualizar: `claude plugin marketplace update seed-ds` e `claude plugin update seed-ds@seed-ds` (a versão do
plugin é a da skill: `2026.10.31+89194dea`). Remover: `claude plugin uninstall seed-ds@seed-ds`.

## O que vem

| componente | o que faz |
|---|---|
| skill `seed-ds` | a MESMA skill publicada em https://ds.seed.eng.br/10-publicacao/skill/seed-ds/ (byte a byte; assinada em `VERSAO.json.sig`), com `references/`, `assets/` e o conferidor |
| `/seed-ds:seed-tela` | monta uma tela nova ou adequa uma que já existe ao DS, medindo antes e depois |
| `/seed-ds:seed-peca` | produz ou adequa uma peça gráfica, impressa ou documento com a marca |
| `/seed-ds:seed-conferir` | roda o conferidor de peça (`conferir-peca.py`) e lê a ficha com o denominador |
| subagente `seed-ds:seed-revisor` | revisor que SÓ LÊ (sem Edit, Write nem Bash): aponta divergências do DS com evidência |

Os comandos de plugin levam o prefixo do plugin (`/seed-ds:seed-tela`); se nenhum outro plugin tiver comando de mesmo nome,
o Claude Code também aceita o nome curto `/seed-tela` [não conferido nesta CLI].

## Limites

- **O plugin difere da skill publicada em 3 arquivos** (todos declarados em `gen-plugin.py`):
  `scripts/atualizar.py` não vai (ele troca a própria pasta; no plugin quem atualiza é `claude plugin update`), e o `SKILL.md` e o
  `scripts/conferir-frescor.py` saem na variante que manda atualizar por `claude plugin update seed-ds@seed-ds` e proíbe baixar ou rodar o `atualizar.py`.
  O texto da skill publicada em https://ds.seed.eng.br/10-publicacao/skill/seed-ds/ não mudou.
- O `VERSAO.json` e o `VERSAO.json.sig` (assinatura ed25519 que o atualizador e o `instalar.py` conferem) vão iguais aos da skill
  publicada; por isso o `sha256` que eles declaram para esses 3 arquivos não bate com a cópia do plugin. A assinatura **vale para a skill
  publicada**; no plugin a integridade é o `sha256` do zip no `marketplace.json`, conferido pelo Claude Code ao baixar.
- O `/seed-ds:seed-conferir` roda o script Python `conferir-peca.py` que vem no pacote da skill (nada é baixado); com `--url` ele abre o
  Chrome local e lê a origem indicada, e com `--alvo` grava `FICHA-ADEQUACAO.md` na pasta corrente. **O pacote não pré-aprova escrita
  (`Edit`, `Write`) nem terminal (`Bash`)**: o Claude Code pede a sua aprovação a cada gravação e a cada execução, no modo normal, porque os
  comandos leem código e HTML de terceiros (o `allowed-tools` só pré-aprova, e um `Bash(python ...)` com curinga
  antes do subcomando equivale a "qualquer Python").
- O conferidor precisa de Python 3 na máquina; sem ele a skill manda dizer NÃO MEDI e citar a evidência de cada item.
- Pedido de cobertura (quando o canon não cobre) só é enviado com a confirmação explícita da pessoa.

Documentação do formato: https://code.claude.com/docs/en/plugins · https://code.claude.com/docs/en/plugins/marketplace-reference · https://code.claude.com/docs/en/plugins/host-marketplace (lidas em 2026-10-18).