/design-system
Se você encontrar placeholders desconhecidos ou precisar verificar quais ferramentas estão conectadas, consulte CONNECTORS.md.
Gerencie seu sistema de design — audite para verificar a consistência, documente componentes ou crie novos padrões.
Uso
/design-system audit # Auditoria completa do sistema
/design-system document [component] # Documentar um componente
/design-system extend [pattern] # Criar um novo componente ou padrão
Componentes de um Sistema de Design
Design Tokens (Tokens de Design)
Valores atômicos que definem a linguagem visual:
- Cores (marca, semântica, neutra)
- Tipografia (escala, pesos, alturas de linha)
- Espaçamento (escala, padding de componentes)
- Bordas (raio, largura)
- Sombras (níveis de elevação)
- Movimento (durações, curvas de easing)
Componentes
Elementos de UI reutilizáveis com:
- 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 (Patterns)
Soluções comuns de UI que combinam componentes:
- Formulários (grupos de input, validação, submissão)
- Navegação (sidebar, abas, breadcrumbs)
- Exibição de dados (tabelas, cards, listas)
- Feedback (toasts, modais, mensagens inline)
Princípios
- Consistência acima da criatividade — O sistema existe para que as equipes não reinventem a roda.
- Flexibilidade dentro de restrições — Os componentes devem ser combináveis, não rígidos.
- Documente tudo — Se não está documentado, não existe.
- Versione e migre — Mudanças radicais precisam de caminhos de migração.
Saída — Auditoria (Audit)
## 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 | Definido | 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 |
|------------|---------|-----------|------|-----------|
| Botão | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |
### Ações Prioritárias
1. [Melhoria de maior impacto]
2. [Segunda prioridade]
3. [Terceira prioridade]
Saída — Documentação (Document)
## Componente: [Nome]
### Descrição
[O que este componente é e quando usá-lo]
### Variantes
| Variante | Use quando |
|----------|------------|
| [Primário] | [Ações principais] |
| [Secundário] | [Ações secundárias] |
### 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
- **Papel (Role)**: [papel ARIA]
- **Teclado**: [comportamento de 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] | [Antipadrão] |
### Exemplo de Código
[Trecho de código adequado ao framework]
Saída — Extensão (Extend)
## Novo Componente: [Nome]
### Problema
[Qual necessidade do usuário ou lacuna este componente atende]
### Padrões Existentes
| Componente Relacionado | Semelhança | Por que não é suficiente |
|------------------------|------------|--------------------------|
| [Componente] | [O que é compartilhado] | [O que está faltando] |
### Design Proposto
#### 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 Utilizados
- Cores: [Quais tokens]
- Espaçamento: [Quais tokens]
- Tipografia: [Quais tokens]
### Acessibilidade
- **Papel (Role)**: [papel ARIA]
- **Teclado**: [Interações esperadas]
- **Leitor de tela**: [anunciado como...]
### Perguntas em Aberto
- [Decisão que precisa de revisão de design]
- [Caso extremo a resolver]
Se Conectores estiverem Disponíveis
Se ~~ferramenta de design estiver conectada:
- Audite componentes diretamente no Figma — verifique nomenclatura, variantes e uso de tokens
- Extraia propriedades dos componentes e a estrutura de camadas para documentação
Se ~~base de conhecimento estiver conectada:
- Pesquise documentação existente de componentes e diretrizes de uso
- Publique documentação atualizada em sua wiki
Dicas
- Comece com uma auditoria — Saiba onde você está antes de decidir para onde ir.
- Documente enquanto constrói — É mais fácil documentar um componente durante seu design.
- Priorize cobertura em vez de perfeição — 80% dos componentes documentados supera 100% de 10 componentes.