/design-system
Se encontrar placeholders desconhecidos ou precisar verificar quais ferramentas estão conectadas, consulte CONNECTORS.md.
Gerencie seu sistema de design — audite para consistência, documente componentes ou projete novos padrões.
Uso
/design-system audit # Auditoria completa do sistema
/design-system document [component] # Documentar um componente
/design-system extend [pattern] # Projetar um novo componente ou padrão
Componentes de um Sistema de Design
Design Tokens
Valores atômicos que definem a linguagem visual:
- Cores (marca, semânticas, neutras)
- Tipografia (escala, pesos, alturas de linha)
- Espaçamento (escala, padding de componentes)
- Bordas (raio, espessura)
- Sombras (níveis de elevação)
- Movimento (durações, curvas de easing)
Componentes
Elementos de UI reutilizáveis com variantes definidas:
- Variantes (primário, secundário, ghost)
- Estados (padrão, hover, ativo, desabilitado, carregando, erro)
- Tamanhos (sm, md, lg)
- Comportamento (interações, animações)
- Acessibilidade (ARIA, teclado)
Padrões
Soluções comuns de UI que combinam componentes:
- Formulários (grupos de input, validação, envio)
- Navegação (sidebar, abas, breadcrumbs)
- Exibição de dados (tabelas, cards, listas)
- Feedback (toasts, modais, mensagens inline)
Princípios
- Consistência sobre criatividade — O sistema existe para que os times não reinventem a roda
- Flexibilidade dentro de restrições — Os componentes devem ser compostíveis, não rígidos
- Documente tudo — Se não está documentado, não existe
- Versionamento e migração — Mudanças estruturais precisam de caminhos de migração
Saída — Auditoria
## Auditoria do Sistema de Design
### Resumo
**Componentes revisados:** [X] | **Problemas encontrados:** [X] | **Pontuação:** [X/100]
### Consistência de Nomenclatura
| Problema | Componentes | Recomendação |
|----------|-------------|------------|
| [Nomenclatura inconsistente] | [Lista] | [Padrão a adotar] |
### Cobertura de Tokens
| Categoria | Definidos | Valores Fixos Encontrados |
|-----------|-----------|--------------------------|
| Cores | [X] | [X] instâncias de hex fixo |
| Espaçamento | [X] | [X] instâncias de valores arbitrários |
| Tipografia | [X] | [X] instâncias de fontes/tamanhos personalizados |
### Completude dos Componentes
| Componente | Estados | Variantes | Docs | Pontuação |
|------------|---------|-----------|------|-----------|
| Button | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |
### Ações Prioritárias
1. [Melhoria de maior impacto]
2. [Segunda prioridade]
3. [Terceira prioridade]
Saída — Documentação
## Componente: [Nome]
### Descrição
[Para que serve este componente e quando usá-lo]
### Variantes
| Variante | Use Quando |
|----------|------------|
| [Primário] | [Ações principais] |
| [Secundário] | [Ações de suporte] |
### Props / Propriedades
| Propriedade | Tipo | Padrão | Descrição |
|-------------|------|--------|-------------|
| [prop] | [tipo] | [padrão] | [descrição] |
### Estados
| Estado | Visual | Comportamento |
|--------|--------|--------------|
| Padrão | [descrição] | — |
| Hover | [descrição] | [interação] |
| Ativo | [descrição] | [interação] |
| Desabilitado | [descrição] | Não interativo |
| Carregando | [descrição] | [animação] |
### Acessibilidade
- **Função**: [função ARIA]
- **Teclado**: [comportamento Tab, Enter, Escape]
- **Leitor de tela**: [Anunciado como...]
### O que Fazer e o que Não Fazer
| ✅ Faça | ❌ Não Faça |
|--------|-----------|
| [Melhor prática] | [Anti-padrão] |
### Exemplo de Código
[Trecho de código apropriado ao framework]
Saída — Ampliação
## Novo Componente: [Nome]
### Problema
[Qual necessidade do usuário ou lacuna este componente resolve]
### Padrões Existentes
| Componente Relacionado | Semelhança | Por Que Não é Suficiente |
|------------------------|------------|--------------------------|
| [Componente] | [O que é compartilhado] | [O que está faltando] |
### Proposta de Design
#### API / Props
| Propriedade | Tipo | Padrão | Descrição |
|-------------|------|--------|-------------|
| [prop] | [tipo] | [padrão] | [descrição] |
#### Variantes
| Variante | Use Quando | Visual |
|----------|------------|--------|
| [Variante] | [Cenário] | [Descrição] |
#### Estados
| Estado | Comportamento | Observações |
|--------|--------------|-------------|
| Padrão | [Descrição] | — |
| Hover | [Descrição] | [Interação] |
| Desabilitado | [Descrição] | Não interativo |
| Carregando | [Descrição] | [Animação] |
#### Tokens Usados
- Cores: [Quais tokens]
- Espaçamento: [Quais tokens]
- Tipografia: [Quais tokens]
### Acessibilidade
- **Função**: [função ARIA]
- **Teclado**: [Interações esperadas]
- **Leitor de tela**: [Anunciado como...]
### Perguntas em Aberto
- [Decisão que precisa de revisão de design]
- [Caso de borda a resolver]
Se Conectores Estiverem Disponíveis
Se a ~~ferramenta de design estiver conectada:
- Audite componentes diretamente no Figma — verifique nomenclatura, variantes e uso de tokens
- Extraia propriedades dos componentes e estrutura de camadas para documentação
Se a ~~base de conhecimento estiver conectada:
- Pesquise documentação existente de componentes e diretrizes de uso
- Publique documentação atualizada na sua wiki
Dicas
- Comece com uma auditoria — Saiba onde você está antes de decidir para onde ir.
- Documente enquanto projeta — É mais fácil documentar um componente enquanto o projeta.
- Priorize cobertura sobre perfeição — 80% dos componentes documentados vence 100% de 10 componentes.