Arquiteto
O Arquiteto faz duas coisas nesta fase: cria a smart-memory com wikilinks Obsidian (grafo visual da marca) e gera o design system completo — tokens, CSS vars e config Tailwind. Tudo em sequência, lendo o mesmo .
Passo 1 — Smart-memory + grafo Obsidian
Cole primeiro. Após rodar, abra o grafo no Obsidian antes de continuar.
/aiox-architect
Leia docs/brand-brief.md.
Crie a estrutura de smart-memory abaixo. Cada arquivo deve ter frontmatter YAML completo e usar wikilinks [[nome-do-arquivo]] para conectar os documentos. Os wikilinks criam as arestas visíveis no grafo do Obsidian.
═══════════════════════════════
ESTRUTURA DE ARQUIVOS A CRIAR:
═══════════════════════════════
docs/smart-memory/
├── INDEX.md
├── shared-context.md
├── project/
│ ├── overview.md
│ └── brand-tokens.md
└── stories/
└── BACKLOG.md
═══════════════════════════════
CONTEÚDO DE CADA ARQUIVO:
═══════════════════════════════
** docs/smart-memory/INDEX.md **
---
title: Índice do Projeto
tipo: índice
atualizado: [data de hoje]
---
# Índice — [nome da pessoa] Design System
## Projeto
- [[project/overview]] — visão geral e objetivo do projeto
- [[project/brand-tokens]] — tokens de marca em linguagem natural
## Stories
- [[stories/BACKLOG]] — próximas histórias de desenvolvimento
---
*Este vault documenta o design system pessoal de [nome]. Navegue pelo grafo para ver as conexões.*
** docs/smart-memory/shared-context.md **
---
title: Contexto Compartilhado
tipo: contexto
---
# Estado Atual do Projeto
- **Pessoa:** [nome] — [área de atuação]
- **Fase atual:** briefing concluído, estrutura de memória inicializada
- **Próxima ação:** criar tokens de design → [[project/brand-tokens]]
- **Referência visual:** [referência citada no brief]
- **Cor principal:** [hex da marca]
→ Ver [[project/overview]] para contexto completo
** docs/smart-memory/project/overview.md **
---
title: Overview do Projeto
tipo: projeto
tags: [brand, design-system, pessoal]
---
# [nome] — Design System Pessoal
## Objetivo
[2-3 frases: o que está sendo construído e por quê]
## Quem é
[síntese da identidade profissional a partir do brief]
## Personalidade da marca
[os 3 adjetivos do brief com 1 frase expandindo cada um]
## Referências visuais
- [referência citada] — [o que atrai]
## Entregáveis deste projeto
- [ ] tokens.md com paleta, tipografia e espaçamentos
- [ ] design-system.css com CSS custom properties
- [ ] tailwind.tokens.js para integração com Tailwind
- [ ] KV no Claude Design
→ Tokens: [[brand-tokens]] · Stories: [[../stories/BACKLOG]]
** docs/smart-memory/project/brand-tokens.md **
---
title: Brand Tokens
tipo: tokens
tags: [cores, tipografia, marca]
---
# Brand Tokens — [nome]
## Cor principal
- **Hex:** [cor convertida para hex]
- **Nome/referência:** [como a pessoa descreveu]
- **Sensação:** [o que essa cor transmite para esta marca]
## Tipografia sugerida
- **Fonte primária:** [sugestão baseada na personalidade]
- **Por quê:** [justificativa em 1 linha]
- **Pesos:** 400 (regular), 600 (semibold), 700 (bold)
## Tom de voz
[adjetivo 1] · [adjetivo 2] · [adjetivo 3]
## Próximo passo
Estes tokens em linguagem natural serão convertidos em tokens técnicos na fase do Designer.
→ [[../stories/BACKLOG]]
** docs/smart-memory/stories/BACKLOG.md **
---
title: Backlog
tipo: stories
status: em construção
---
# Backlog — [nome] Design System
## Em progresso
- [ ] 1.1 — Criar tokens técnicos completos (cores, tipografia, espaçamentos)
- [ ] 1.2 — Gerar design-system.css com CSS custom properties
- [ ] 1.3 — Gerar tailwind.tokens.js para integração Tailwind
## Próximas
- [ ] 2.1 — Criar componentes no Claude Design (botão, card, input)
- [ ] 2.2 — Aplicar design system num projeto real
→ Contexto: [[../project/overview]] · Tokens: [[../project/brand-tokens]]5 arquivos criados
Índice do vault com links para todos os documentos
Estado atual — o que foi feito e qual é a próxima ação
Quem é a pessoa, o que está sendo construído e por quê
Tokens de marca em linguagem natural (cor, tipografia, tom)
Stories de desenvolvimento com links para os tokens
Após rodar — abra o grafo
- 1No Obsidian, pressione Ctrl/Cmd + G para abrir a visualização de grafo.
- 2Você verá os 5 nós conectados pelas arestas dos wikilinks.
- 3Clique num nó para navegar até o arquivo.
- 4O grafo vai crescer nas próximas fases conforme novos arquivos são criados.
Passo 2 — Design system completo
Após ver o grafo no Obsidian, rode este segundo prompt no mesmo Claude Code.
/aiox-architect
Leia:
- docs/brand-brief.md
- docs/smart-memory/project/brand-tokens.md
Com base nesses arquivos, crie o design system técnico completo em 3 arquivos:
═══════════════════════════════
ARQUIVO 1: docs/design-system/tokens.md
═══════════════════════════════
---
title: Design Tokens
tipo: tokens-técnicos
tags: [cores, tipografia, espaçamentos]
---
# Design Tokens — [nome]
## Paleta de cores
### Primária
| Token | Hex | Uso |
|---|---|---|
| --color-primary | [hex da marca] | CTAs, destaques, links ativos |
| --color-primary-hover | [versão 10% mais escura] | Estado hover do CTA |
| --color-primary-subtle | [hex com 10% opacidade] | Fundos de destaque suaves |
### Neutra
| Token | Hex | Uso |
|---|---|---|
| --color-bg | #0a0a0a | Fundo principal |
| --color-surface | #141414 | Cards, painéis elevados |
| --color-border | rgba(255,255,255,0.08) | Bordas sutis |
| --color-text | #ffffff | Texto principal |
| --color-text-muted | rgba(255,255,255,0.55) | Texto secundário |
### Semântica
| Token | Hex | Uso |
|---|---|---|
| --color-success | #22c55e | Confirmações, status OK |
| --color-warning | #f59e0b | Alertas, pendências |
| --color-error | #ef4444 | Erros, destrutivo |
## Tipografia
### Fonte primária
- **Família:** [sugestão baseada na personalidade — ex: Inter, Plus Jakarta Sans]
- **Google Fonts:** [link de importação]
- **Pesos:** 400, 600, 700
### Escala
| Token | Valor | Uso |
|---|---|---|
| --text-xs | 0.75rem / 12px | Labels, badges, meta |
| --text-sm | 0.875rem / 14px | Body secundário, notas |
| --text-base | 1rem / 16px | Body principal |
| --text-lg | 1.125rem / 18px | Lead text, subtítulos |
| --text-xl | 1.25rem / 20px | H3, títulos de card |
| --text-2xl | 1.5rem / 24px | H2, seção |
| --text-3xl | 1.875rem / 30px | H1 mobile |
| --text-4xl | 2.25rem / 36px | H1 desktop |
## Espaçamentos
| Token | Valor |
|---|---|
| --space-1 | 0.25rem |
| --space-2 | 0.5rem |
| --space-3 | 0.75rem |
| --space-4 | 1rem |
| --space-6 | 1.5rem |
| --space-8 | 2rem |
| --space-12 | 3rem |
| --space-16 | 4rem |
## Border-radius
| Token | Valor | Uso |
|---|---|---|
| --radius-sm | 4px | Badges, inputs |
| --radius-md | 8px | Cards, botões |
| --radius-lg | 16px | Modais, painéis |
| --radius-full | 9999px | Pills, avatares |
## Sombras
| Token | Valor | Uso |
|---|---|---|
| --shadow-sm | 0 1px 3px rgba(0,0,0,0.3) | Elevação mínima |
| --shadow-md | 0 4px 16px rgba(0,0,0,0.4) | Cards elevados |
| --shadow-lg | 0 8px 32px rgba(0,0,0,0.5) | Modais, dropdowns |
→ Tokens técnicos derivados de: [[../smart-memory/project/brand-tokens]]
═══════════════════════════════
ARQUIVO 2: docs/design-system/design-system.css
═══════════════════════════════
/* Design System — [nome] */
/* Gerado a partir de docs/smart-memory/project/brand-tokens.md */
:root {
/* Cores primárias */
--color-primary: [hex da marca];
--color-primary-hover: [10% mais escuro];
--color-primary-subtle: [hex com 10% opacidade];
/* Neutra */
--color-bg: #0a0a0a;
--color-surface: #141414;
--color-border: rgba(255,255,255,0.08);
--color-text: #ffffff;
--color-text-muted: rgba(255,255,255,0.55);
/* Semântica */
--color-success: #22c55e;
--color-warning: #f59e0b;
--color-error: #ef4444;
/* Tipografia */
--font-primary: '[fonte escolhida]', system-ui, sans-serif;
--text-xs: 0.75rem;
--text-sm: 0.875rem;
--text-base: 1rem;
--text-lg: 1.125rem;
--text-xl: 1.25rem;
--text-2xl: 1.5rem;
--text-3xl: 1.875rem;
--text-4xl: 2.25rem;
/* Espaçamentos */
--space-1: 0.25rem;
--space-2: 0.5rem;
--space-3: 0.75rem;
--space-4: 1rem;
--space-6: 1.5rem;
--space-8: 2rem;
--space-12: 3rem;
--space-16: 4rem;
/* Border-radius */
--radius-sm: 4px;
--radius-md: 8px;
--radius-lg: 16px;
--radius-full: 9999px;
/* Sombras */
--shadow-sm: 0 1px 3px rgba(0,0,0,0.3);
--shadow-md: 0 4px 16px rgba(0,0,0,0.4);
--shadow-lg: 0 8px 32px rgba(0,0,0,0.5);
}
═══════════════════════════════
ARQUIVO 3: docs/design-system/tailwind.tokens.js
═══════════════════════════════
/** @type {import('tailwindcss').Config} */
module.exports = {
theme: {
extend: {
colors: {
primary: 'var(--color-primary)',
'primary-hover': 'var(--color-primary-hover)',
'primary-subtle': 'var(--color-primary-subtle)',
surface: 'var(--color-surface)',
border: 'var(--color-border)',
'text-muted': 'var(--color-text-muted)',
success: 'var(--color-success)',
warning: 'var(--color-warning)',
error: 'var(--color-error)',
},
fontFamily: {
primary: 'var(--font-primary)',
},
fontSize: {
xs: 'var(--text-xs)',
sm: 'var(--text-sm)',
base: 'var(--text-base)',
lg: 'var(--text-lg)',
xl: 'var(--text-xl)',
'2xl': 'var(--text-2xl)',
'3xl': 'var(--text-3xl)',
'4xl': 'var(--text-4xl)',
},
spacing: {
1: 'var(--space-1)',
2: 'var(--space-2)',
3: 'var(--space-3)',
4: 'var(--space-4)',
6: 'var(--space-6)',
8: 'var(--space-8)',
12: 'var(--space-12)',
16: 'var(--space-16)',
},
borderRadius: {
sm: 'var(--radius-sm)',
md: 'var(--radius-md)',
lg: 'var(--radius-lg)',
full: 'var(--radius-full)',
},
boxShadow: {
sm: 'var(--shadow-sm)',
md: 'var(--shadow-md)',
lg: 'var(--shadow-lg)',
},
},
},
};
═══════════════════════════════
APÓS CRIAR OS 3 ARQUIVOS:
═══════════════════════════════
Registre em docs/smart-memory/shared-context.md:
- Design system técnico criado
- Arquivos: tokens.md, design-system.css, tailwind.tokens.js
- Pronto para handoff ao Claude DesignArquivos de design system gerados
Paleta completa (primária, secundária, neutros, semânticas), tipografia com link Google Fonts, escala xs→4xl, espaçamentos, border-radius, sombras — cada decisão justificada.
CSS custom properties semânticas no :root. Cole em qualquer projeto para ativar o sistema inteiro.
Extensão do tailwind.config.js. Referencia as CSS vars — não duplica valores.