O que design-handoff faz?
Se você encontrar placeholders desconhecidos ou precisar verificar quais ferramentas estão conectadas, consulte CONNECTORS.md.
Gere documentação abrangente de handoff para desenvolvedores a partir de um design.
Uso
/design-handoff $ARGUMENTOS
Gerar especificações de handoff para: @$1
Se uma URL do Figma for fornecida, extraia o design do Figma. Caso contrário, trabalhe a partir da descrição ou captura de tela fornecida.
O Que Incluir
Especificações Visuais
- Medidas exatas (padding, margens, larguras)
- Referências a design tokens (cores, tipografia, espaçamento)
- Breakpoints responsivos e comportamento
- Variantes de componentes e estados
Especificações de Interação
- Comportamento de clique/toque
- Estados de hover
- Transições e animações (duração, easing)
- Suporte a gestos (deslizar, pinçar, pressionar longo)
Especificações de Conteúdo
- Limites de caracteres
- Comportamento de truncamento
- Estados vazios
- Estados de carregamento
- Estados de erro
Casos de Borda
- Conteúdo mínimo/máximo
- Texto internacional (strings longas)
- Conexões lentas
- Dados ausentes
Acessibilidade
- Ordem de foco
- Rótulos e funções ARIA
- Interações por teclado
- Anúncios para leitores de tela
Princípios
- Não suponha: Se não estiver especificado, o desenvolvedor vai adivinhar. Especifique tudo.
- Use tokens, não valores: Referencie
spacing-mdnão16px. - Mostre todos os estados: Padrão, hover, ativo, desabilitado, carregando, erro, vazio.
- Descreva o porquê: "Isso recolhe no mobile porque os usuários usam principalmente com uma mão" ajuda os desenvolvedores a tomar boas decisões.
Saída
## Especificação de Handoff: [Nome da Funcionalidade/Tela]
### Visão Geral
[O que esta tela/funcionalidade faz, contexto do usuário]
### Layout
[Sistema de grid, breakpoints, comportamento responsivo]
### Design Tokens Utilizados
| Token | Valor | Uso |
|-------|-------|-----|
| `color-primary` | #[hex] | Botões CTA, links |
| `spacing-md` | [X]px | Entre seções |
| `font-heading-lg` | [tamanho/peso/família] | Título da página |
### Componentes
| Componente | Variante | Props | Notas |
|------------|----------|-------|-------|
| [Componente] | [Variante] | [Props] | [Comportamento especial] |
### Estados e Interações
| Elemento | Estado | Comportamento |
|----------|--------|---------------|
| [Botão CTA] | Hover | [Fundo escurece 10%] |
| [Botão CTA] | Carregando | [Spinner, desabilitado] |
| [Formulário] | Erro | [Borda vermelha, mensagem de erro abaixo] |
### Comportamento Responsivo
| Breakpoint | Mudanças |
|------------|----------|
| Desktop (>1024px) | [Layout padrão] |
| Tablet (768-1024px) | [O que muda] |
| Mobile (<768px) | [O que muda] |
### Casos de Borda
- **Estado vazio**: [O que mostrar quando não há dados]
- **Texto longo**: [Regras de truncamento]
- **Carregando**: [Skeleton ou spinner]
- **Erro**: [Aparência do estado de erro]
### Animação / Movimento
| Elemento | Gatilho | Animação | Duração | Easing |
|----------|---------|----------|---------|--------|
| [Elemento] | [Gatilho] | [Descrição] | [ms] | [easing] |
### Notas de Acessibilidade
- [Ordem de foco]
- [Rótulos ARIA necessários]
- [Interações por teclado]
Se Conectores Estiverem Disponíveis
Se ~~ferramenta de design estiver conectada:
- Extraia medidas exatas, tokens e especificações de componentes do Figma
- Exporte ativos e gere uma folha de especificações completa
Se ~~gerenciador de projetos estiver conectado:
- Vincule o handoff ao ticket de implementação
- Crie subtarefas para cada seção da especificação
Dicas
- Compartilhe o link do Figma: Posso extrair medidas exatas, tokens e informações de componentes.
- Mencione casos de borda: "O que acontece com 100 itens?" me ajuda a especificar condições de contorno.
- Especifique a stack tecnológica: "Usamos React + Tailwind" me ajuda a dar notas de implementação relevantes.