Aprendizado@joaoguirunas

Brandbook com Claude Design

Fluxo completo em 5 fases — entrevista de marca, design system, KV visual, handoff automático e app React interativo. Os prompts exatos.

O que é

Brandbook com Claude Design

O fluxo tem 5 fases: brief por entrevista, design system técnico, KV visual no Claude Design, handoff automático Design→Code e brandbook React interativo. Claude Code e Claude Design trabalham em sequência — o output de um alimenta o outro.

O momento decisivo é o handoff: o Claude Design gera uma URL com todo o KV empacotado. O Claude Code recebe essa URL e implementa os componentes automaticamente — sem copiar CSS, sem reexplicar nada. É aí que o sistema fecha.

Usei esse processo para refundar a identidade visual da GrowthSales.ai. Em 1 dia: brand-brief estruturado, design system completo, KV com logo + tipografia + motion, handoff implementado e brandbook React rodando no browser.

Como funciona

Principais recursos

Fase 1 — Brief por entrevista

8 perguntas em sequência — personalidade, público, diferencial, cor, referências. O Analista escreve brand-brief.md ao final.

Fase 2 — Design system técnico

O Arquiteto lê o brief e gera tokens.md, design-system.css e tailwind.tokens.js. Smart-memory com grafo Obsidian.

Fase 3 — KV visual no Claude Design

Abre a pasta no Claude Design. Um prompt gera logo, tipografia, componentes com estados, motion tokens e hero mock.

Handoff automático Design → Code

Um clique no botão Share gera uma URL. O Claude Code busca o arquivo e implementa os componentes sem instrução manual.

Fase 4 — LP antes e depois

UX agent cria a LP V1 com tokens livres, depois reconstrói com os componentes reais do handoff. A comparação é o argumento.

Fase 5 — Brandbook React interativo

Claude Code monta o app final com tipografia trocando ao vivo, paleta com copy de hex, motion demos e do/don't.

Tutorial completo

5 fases, 1 dia, prompts exatos

Claude Code e Claude Design trabalham em sequência. O output de cada fase alimenta a próxima. Substitua os campos entre colchetes pela sua marca.

Claude CodeBrief + Tokens
Claude DesignKV Visual
Handoff URLautomático
Claude CodeImplementa
BrandbookReact App

Pré-requisitos

Claude Code instalado (npm install -g @anthropic-ai/claude-code)
Claude Pro ou acesso à API Anthropic
Claude Design habilitado em claude.ai/design
Pasta local para o projeto (ex: ~/Desktop/meu-brandbook)
Obsidian instalado para visualizar a smart-memory (opcional)
1

Brief estruturado — entrevista de marca

Claude Code~10 min

Cole o prompt abaixo no Claude Code. O agente Analista faz 8 perguntas em sequência — uma por vez — e escreve o brand-brief.md ao final. Responda com suas palavras reais: quanto mais específico, mais preciso o resultado.

claude code — analista
/aiox-analyst

Você é um especialista em branding e estratégia de posicionamento. Conduza uma entrevista de marca pessoal com profundidade e gere um brand-brief.md completo.

Faça exatamente 8 perguntas, uma de cada vez, aguardando minha resposta antes de prosseguir.

1. Qual é o seu nome completo e como prefere ser chamado profissionalmente?

2. Qual é sua área de atuação e o que exatamente você entrega? Seja específico — não "designer", mas "designer de produto que transforma fluxos complexos em interfaces simples para startups B2B".

3. Quem é o seu público-alvo ideal? Setor, tamanho da empresa, momento, dores principais.

4. Qual é o seu principal diferencial? O que te faz diferente de outras pessoas na mesma área?

5. Escolha 3 adjetivos que descrevem a sensação que sua marca deve transmitir.

6. Como você quer soar? Escolha um ponto: muito formal ←→ muito informal / muito técnico ←→ muito acessível.

7. Qual é a sua cor favorita ou a cor que mais te representa? Hex, nome ou descrição.

8. Cite uma marca, designer ou site cujo estilo visual te inspira — e diga o que especificamente te atrai.

═══════════════════════════════
APÓS AS 8 RESPOSTAS — CRIE: docs/brand-brief.md
═══════════════════════════════

Estruture com frontmatter YAML e seções:
- Identidade (nome, área, entrega)
- Público-alvo
- Diferencial
- Personalidade da marca (3 adjetivos expandidos)
- Tom de voz (posição no espectro + como se manifesta)
- Cor principal (hex + nome evocativo + sensação)
- Referência visual (o que atrai + como aplicar)
- Posicionamento (parágrafo síntese)
- Copy de base:
  · Headline do hero (até 8 palavras)
  · Subtítulo (até 15 palavras)
  · Tagline (3-5 palavras)
  · CTA principal (2-4 palavras)
docs/brand-brief.md com identidade, personalidade, tom de voz e copy de base
Headline, subtítulo, tagline e CTA já escritos — usados em todas as fases seguintes
Por que entrevista e não formulárioCada resposta informa a próxima pergunta. Uma resposta como "quero parecer confiável mas não corporativo" produz adjetivos muito mais acionáveis do que um formulário de 10 campos.
2

Design system técnico + smart-memory

Claude Code~15 min

O Arquiteto faz duas coisas em sequência: cria a smart-memory com wikilinks Obsidian (grafo visual da marca) e gera o design system completo. Rode os dois prompts em ordem.

Passo 2A — Smart-memory + grafo Obsidian

claude code — arquiteto, passo 1
/aiox-architect

Leia docs/brand-brief.md.

Crie a smart-memory com wikilinks Obsidian. Cada arquivo precisa de frontmatter YAML e usar [[wikilinks]] para conectar os documentos — essas são as arestas visíveis no grafo.

Crie a seguinte estrutura:

docs/smart-memory/
├── INDEX.md            — índice com links para todos os documentos
├── shared-context.md   — estado atual do projeto e próxima ação
└── project/
    ├── overview.md     — quem é, o que está sendo construído e por quê
    ├── brand-tokens.md — tokens em linguagem natural (cor, tipografia, tom)
    └── stories/
        └── BACKLOG.md  — stories iniciais com links para os tokens

Regras:
- Todos os links internos como [[nome-do-arquivo]]
- shared-context.md sempre termina com "→ Próxima ação: [o que vem a seguir]"
- brand-tokens.md em linguagem natural — não técnico ainda
- BACKLOG.md com as 3 primeiras stories numeradas (1.1, 1.2, 1.3)
docs/smart-memory/ com 5 arquivos conectados por wikilinks
Abra o Obsidian agora (Cmd+G) — o grafo já tem 5 nós com arestas visíveis

Passo 2B — Design system técnico

claude code — arquiteto, passo 2
/aiox-architect

Leia:
- docs/brand-brief.md
- docs/smart-memory/project/brand-tokens.md

Crie o design system técnico completo em 3 arquivos:

═══════════════════════════
1. docs/design-system/tokens.md
═══════════════════════════
Tabelas com todos os tokens:
- Paleta (primária em 5 tons, neutras, semânticas success/warning/error)
- Tipografia (fonte sugerida + link Google Fonts, escala xs→4xl, pesos)
- Espaçamentos --space-1 até --space-16
- Border-radius: sm · md · lg · full
- Sombras: sm · md · lg
Cada token com coluna Hex/Valor e coluna Uso — justificado pelos adjetivos do brief.

═══════════════════════════
2. docs/design-system/design-system.css
═══════════════════════════
CSS custom properties semânticas no :root.
Nomenclatura: --color-primary, --color-surface, --color-border, etc.
Zero valores hardcoded no HTML — só vars.

═══════════════════════════
3. docs/design-system/tailwind.tokens.js
═══════════════════════════
Extensão do tailwind.config.js referenciando as CSS vars.
Não duplica valores — mapeia token → var().

Após criar os 3 arquivos, registre em docs/smart-memory/shared-context.md:
- Design system técnico criado
- Próxima ação: handoff ao Claude Design → [[project/kv-design]]
docs/design-system/tokens.md — paleta completa, tipografia, espaçamentos, radius, sombras
docs/design-system/design-system.css — CSS custom properties no :root
docs/design-system/tailwind.tokens.js — extensão do tailwind.config.js com as vars
Tokens semânticos--color-primary em vez de --color-orange-500. Se a cor mudar amanhã, troca um valor e propaga em tudo. O Claude Design e o Claude Code leem as mesmas vars — é aí que o sistema fecha.
3

KV visual — logo, tipografia, componentes, motion

Claude Design~10 min

Abra o Claude Design em claude.ai/design. Clique em Open Folder e selecione a pasta do projeto — ele lê brand-brief.md, tokens.md e design-system.css automaticamente.

1
Abrir pastaClique em Open Folder → selecione a pasta do projeto.
2
Criar o KVCole o prompt abaixo. Ele pede o máximo — gradiente de assinatura, noise texture, componentes com estados, motion tokens, hero mock.
claude design — KV visual
Tenho os arquivos do meu design system nesta pasta. Leia com atenção:
- docs/design-system/tokens.md
- docs/design-system/design-system.css
- docs/brand-brief.md

Com base nesses arquivos, crie um KV (key visual) com caráter — não um style guide genérico.

═══════════════════════════
01 — FUNDAÇÃO VISUAL
═══════════════════════════

PALETA
- Swatches da cor primária em 5 luminosidades (100 → 900)
- Gradiente de assinatura: linear 135° entre a primária e versão mais quente/fria
- Neutros completos: fundo, superfície, borda, texto muted, branco

TEXTURA DE FUNDO
- SVG de ruído sutil (feTurbulence baseFrequency="0.65" numOctaves="3")
- Overlay no fundo escuro com opacidade 3-5%

TIPOGRAFIA COM CARÁTER
- Fonte primária em tamanhos xs → 4xl com preview de texto real
- Fonte de display derivada dos adjetivos do brief:
  Marca ousada → peso 800-900, tracking tight
  Marca sofisticada → 300 light italic, tracking wide
- Pair tipográfico: heading + body juntos em bloco real
- Número/stat em 4xl na cor primária (ex: "12+", "100%")

═══════════════════════════
02 — COMPONENTES COM VIDA
═══════════════════════════

BOTÃO PRIMÁRIO — 3 estados + variações
- Default: background gradiente de assinatura (não cor sólida)
- Hover: shift de 8° no gradiente + translateY(-2px) + shadow elevada
- Disabled: 40% opacidade, cursor not-allowed
- Variação ghost: border 1.5px solid primária, background transparente

CARD — sistema de elevação
- Nível 0 (flat): border sutil, sem shadow
- Nível 1 (raised): shadow-sm, hover → shadow-md + translateY(-4px)
- Nível 2 (floating): shadow-lg, glow com box-shadow duplo
- Micro-animação de entrada: fade-in + slide-up 0.3s ease-out

INPUT — estados completos
- Default · Focus (glow ring primária) · Error · Success

BADGE — com dot animado
- Default · Success · Warning · Error
- Variação "live": dot verde pulsante (animation: pulse 2s infinite)

═══════════════════════════
03 — EFEITOS DE IDENTIDADE
═══════════════════════════

HERO MOCK
- Heading grande + subtítulo muted + botão primário
- Gradiente de assinatura como overlay sutil no fundo
- Prova que tipografia + cor + espaçamento funcionam juntos

MOTION TOKENS
- --ease-out: cubic-bezier(0.16, 1, 0.3, 1)
- --ease-in-out: cubic-bezier(0.45, 0, 0.55, 1)
- --duration-fast: 150ms · --duration-base: 250ms · --duration-slow: 400ms
- Demo de cada easing com elemento se movendo

DO / DON'T
- 2 exemplos corretos com ✓ em verde
- 2 exemplos incorretos com ✗ em vermelho

O KV deve sentir-se como a marca — não como template.
Paleta em 5 luminosidades + gradiente de assinatura da marca
Textura noise SVG como overlay de fundo (3-5% opacidade)
Tipografia com peso/tracking derivados dos adjetivos — não template
Botão com gradiente + hover state + variação ghost e disabled
Cards em 3 níveis de elevação com micro-animação de entrada
Input com estados focus/error/success + glow ring
Badges com dot pulsante, hero mock, motion tokens, do/don't
3
RefinarApós o KV gerado, rode o prompt de refinamento para calibrar ao caráter da marca:
claude design — refinamento
Com base nos adjetivos de personalidade do brief (docs/brand-brief.md), refine o sistema visual:

1. TIPOGRAFIA: heading com peso e tracking corretos para a personalidade?
   Ousada → weight 800+, tracking tight
   Sofisticada → weight 300 light italic, tracking wide
   Técnica → monospace para labels e badges

2. BOTÃO: o gradiente captura a energia da marca?
   Ajuste o ângulo (90°, 135°, 180°) e a segunda cor.

3. CARD: nível de elevação alinhado com a seriedade da marca?
   Minimalista → só border, sem glow
   Expressiva → glow na primária + shadow dupla

4. NOISE TEXTURE: o ruído está em 2-4% de opacidade?

5. HERO MOCK: já parece um site real desta marca?

Mostre versões antes/depois dos componentes modificados.
Por que o prompt do KV é longoUm prompt vago entrega swatches + botão genérico. Este prompt especifica o que diferencia uma marca: gradiente de assinatura (não cor sólida), noise de fundo (profundidade sem peso), motion tokens (o sistema sabe como se mover), hero mock (prova que funciona em contexto real).
Handoff — WOW

Claude Design → Claude Code

No Claude Design, clique no botão Share / Handoff to Claude Code. Ele gera uma URL no formato api.anthropic.com/v1/design/h/[ID]. Copie essa URL — ela empacota o KV completo com um README de implementação.

1
Gerar URLNo Claude Design → Share → Handoff to Claude Code. URL copiada para o clipboard.
2
ImplementarVolte ao Claude Code. Substitua a URL no prompt abaixo e cole.
claude code — handoff
Fetch this design file, read its readme, and implement the relevant aspects of the design.
https://api.anthropic.com/v1/design/h/[COLE-A-URL-DO-CLAUDE-DESIGN-AQUI]

Implement: the designs in this project

═══════════════════════════════
AO FINAL — REGISTRE NA SMART-MEMORY:
═══════════════════════════════

1. Atualize docs/smart-memory/shared-context.md:
   - Handoff implementado — componentes do Claude Design no projeto
   - Próxima ação: UX agent reconstrói LP com componentes reais → [[project/lp-v2]]

2. Crie docs/smart-memory/project/components.md:

---
title: Componentes do Design System
tipo: referência
status: implementado
origem: Claude Design handoff
---

# Componentes — [nome da marca]

## Implementados via handoff
- Botão primário: default · hover · disabled · ghost
- Card: flat · raised · floating
- Input: default · focus · error · success
- Badge: default · success · warning · error · live

## Como usar
Usam exclusivamente as CSS vars do design-system.css.
Não duplique valores — altere só as vars.

→ Tokens: [[brand-tokens]] · CSS: [[design-system]] · LP V2: [[lp-v2]]
CSS dos componentes implementado no projeto usando as CSS vars existentes
HTML semântico de referência para cada componente
docs/smart-memory/project/components.md registrado
Por que funciona sem instruções manuaisA URL não é só um link — aponta para um arquivo com o KV completo, specs dos componentes e um README com instruções de implementação. O Claude Code lê esse arquivo como leria qualquer outro contexto e sabe exatamente o que criar, onde salvar e quais CSS vars usar.
4

LP antes e depois do handoff

Claude Code~20 min

Esta fase é opcional no brandbook — mas é o argumento visual mais forte. O UX agent cria a LP V1 com os tokens livres (sem componentes definidos) e depois reconstrói a V2 com os componentes reais do handoff. A comparação é imediata.

LP V1 — antes do Claude Design

claude code — LP V1
Assuma o papel de especialista sênior em UX e desenvolvimento frontend.

TAREFA: Criar a Versão 1 da landing page de apresentação da marca.
Você ainda não viu o output do Claude Design. Trabalhe apenas com o que existe na pasta.

LEIA ANTES DE COMEÇAR:
- docs/brand-brief.md → use o copy de base já escrito (headline, subtítulo, tagline, CTA)
- docs/design-system/tokens.md → paleta, tipografia, espaçamentos
- docs/design-system/design-system.css → use APENAS essas CSS vars, zero hardcode

ESTRUTURA DA PÁGINA:
NAV fixo (64px) · HERO (100vh) · PROPOSTA DE VALOR (3 cards) · SOBRE (2 colunas) · CTA FINAL · FOOTER

Regras técnicas:
- Zero valores hardcoded — APENAS CSS vars
- HTML semântico: nav, header, main, section, footer
- Google Font do tokens.md: importe via <link>
- Responsivo: breakpoints 768px e 1024px
- Sem frameworks, sem CDN externo além da fonte

SALVE EM: docs/pages/lp-v1.html

Ao final, atualize docs/smart-memory/shared-context.md:
- LP V1 concluída — construída com tokens livres, sem componentes do Claude Design
- Próxima ação: handoff Claude Design → implementar componentes → reconstruir LP V2
docs/pages/lp-v1.html — LP completa: nav, hero, proposta, sobre, CTA, footer
Interpretação livre do UX agent com as CSS vars disponíveis — sem componentes definidos

LP V2 — mesma jornada, vocabulário visual do handoff

claude code — LP V2
Você criou a LP V1 com os tokens livres. Agora chegou o handoff do Claude Design.

TAREFA: Criar a Versão 2 — mesma jornada, vocabulário visual do handoff.

LEIA:
- docs/brand-brief.md → mesmo copy da V1
- docs/pages/lp-v1.html → referência de estrutura e jornada (não de estilo)
- docs/design-system/design-system.css → CSS vars disponíveis

REGRA CENTRAL: mesma estrutura NAV → HERO → PROPOSTA → SOBRE → CTA → FOOTER.
O que muda é o vocabulário visual — use os componentes do handoff:

- NAV: aplique tipografia do KV
- HERO: use o BOTÃO do handoff — não recrie
- PROPOSTA DE VALOR: use o CARD do handoff para os 3 blocos
- CTA: use o BOTÃO do handoff
- Demais seções: aplique tipografia e espaçamentos do KV

Regras técnicas:
- CSS do handoff vem primeiro no <style>, depois design-system.css
- Não duplique variáveis do handoff
- Mesmos breakpoints da V1 (768px, 1024px)

SALVE EM: docs/pages/lp-v2.html

Ao final, crie docs/smart-memory/project/lp-comparison.md com:
- Decisões que mudaram entre V1 e V2
- O que os componentes do Claude Design resolveram
- Screenshot mental: a diferença visual mais marcante
docs/pages/lp-v2.html — mesma estrutura, componentes reais do Claude Design
docs/smart-memory/project/lp-comparison.md com a análise da diferença
5

Brandbook React interativo

Claude Code~10 min

Com os componentes implementados e a smart-memory populada, Claude Code gera o app final. 8 seções interativas — tipografia trocando ao vivo, paleta com copy de hex, motion demos com replay.

claude code — brandbook React
Leia todos os arquivos do projeto:
- docs/brand-brief.md
- docs/design-system/tokens.md
- docs/design-system/design-system.css
- docs/smart-memory/project/components.md (se existir)

Crie o brandbook completo como app React interativo — não um PDF, um sistema vivo.

ESTRUTURA DO APP (8 seções):
1. HERO: nome da marca + adjetivos + fundo na cor de superfície da marca
2. LOGO: variações com tabs (horizontal · vertical · ícone · invertido)
3. PALETA: swatches clicáveis — onClick copia o hex para clipboard com feedback
4. TIPOGRAFIA: escala interativa — botões trocam entre os pares tipográficos ao vivo
5. COMPONENTES: botão · card · input · badge com estados em tabs
6. MOTION: demos de easing, scroll patterns e micro-interações com botão "replay"
7. DIREÇÃO VISUAL: cada princípio com toggle antes/depois
8. DO / DON'T: 4 exemplos com explicação

REQUISITOS TÉCNICOS:
- CSS custom properties para todos os tokens
- React state para troca de tipografia e estados de componente
- IntersectionObserver para animações de entrada nas seções
- Web Clipboard API para copy de hex
- Responsivo: 375px e 1440px
- Sem build step — HTML + React CDN ou arquivo único

SALVE EM: docs/brandbook/index.html
docs/brandbook/index.html — app completo rodando no browser, sem build step
Tipografia interativa: troca entre pares com um clique
Paleta: onClick copia o hex com feedback visual
Componentes com todos os estados em tabs
Motion demos com botão replay
Direção visual: toggle antes/depois em cada princípio
Do / Don't: 4 exemplos com explicação
Não é PDFAgência entrega isso em PowerPoint. O Claude entrega um app que roda no browser — você abre, troca a tipografia em tempo real, vê as animações funcionando, copia o hex de qualquer cor. É um sistema vivo, não uma apresentação.

Resultado real — GrowthSales.ai

Usando exatamente esse processo, em 1 dia:

brand-brief.md com personalidade e copy de base
Design system: tokens + CSS vars + Tailwind config
Logo redesenhado: diamante gradient #FF4400→#FF1A00
Wordmark: Geist 300 + ".ai" em Fraunces itálico
6 princípios de direção visual documentados
6 scroll patterns cinematográficos com vídeo
LP V1 e V2 — antes/depois do handoff
Brandbook React interativo no browser

Custo fixo: a assinatura do Claude. Agência: R$ 100 mil · 4 meses.

Comece agora

Explore o repositório, contribua ou integre na sua operação.