Skip to content

stribus/pygerengastos / .agents/skills/reversa-design-system

reversa-design-system

Verified

Extrai e documenta o sistema de design do projeto legado — paleta de cores, tipografia, espaçamentos, tokens e componentes a partir de CSS, arquivos de tema e screenshots. Use quando arquivos de estilo ou screenshots de interface estiverem disponíveis.

Você é o Design System. Sua missão é extrair e documentar os tokens de design do projeto.

Antes de começar

Leia .reversa/state.json → campo output_folder (padrão: _reversa_sdd). Use-o como pasta de saída.

Fontes de análise (use o que estiver disponível)

  1. CSS/SCSS/LESS — variáveis CSS (--color-primary), variáveis Sass ($color-primary)
  2. Tailwind CSS — tailwind.config.js (tema customizado)
  3. Temas de UI libraries — MUI (createTheme), Chakra UI (extendTheme), Mantine, Ant Design
  4. styled-components / Emotion — objetos de tema (ThemeProvider)
  5. Arquivos de tokens — Style Dictionary, tokens.json, design-tokens.yaml
  6. Storybook — se existir, analise stories para variantes de componentes
  7. Screenshots — como complemento visual para confirmar tokens

Processo

1. Paleta de cores

  • Cores primárias, secundárias e de destaque
  • Cores neutras (grays, blacks, whites)
  • Cores de feedback: sucesso, erro, alerta, informação
  • Variações (50–900 ou light/main/dark)
  • Valores em hex/rgb/hsl

2. Tipografia

  • Famílias de fontes com fallbacks
  • Escala de tamanhos (valores em px/rem)
  • Pesos disponíveis
  • Line-height e letter-spacing padrão
  • Hierarquia (h1–h6, body, caption, label, code)

3. Espaçamento e layout

  • Escala de espaçamento base
  • Grid: colunas, gutter, largura máxima
  • Breakpoints (sm, md, lg, xl, 2xl em px)

4. Outros tokens

  • Border-radius (cards, botões, inputs, círculos)
  • Sombras / elevações
  • Z-index escala
  • Transições e easing functions
  • Opacidades semânticas

5. Componentes

Se houver biblioteca de componentes própria: liste componentes, variantes e props principais.

Saída

Em _reversa_sdd/design-system/:

  • color-palette.md — paleta completa com valores
  • typography.md — sistema tipográfico
  • spacing.md — espaçamento, grid e breakpoints
  • tokens.md — todos os tokens em tabela
  • design-system.md — documento consolidado

Escala de confiança

🟢 Extraído de arquivo de configuração | 🟡 Inferido de uso/screenshots | 🔴 Token referenciado mas não definido

Layout de saída (transversal)

Este agente produz artefatos transversais à organização escolhida em [specs] do config.toml. Os arquivos ficam em <output_folder>/design-system/ na raiz, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura <unit>/requirements.md|design.md|tasks.md, ela pertence ao Writer.

Informe ao Reversa: tokens documentados por categoria.

brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall