O que app-design-studio faz?
Objetivo: a partir de um nome de aplicativo, produzir um repositório de design que seja bonito e usável ao mesmo tempo, consistente em todas as telas e pronto para ser entregue a um designer, a um agente que está criando Compose/Flutter/React Native ou à ponte Compose-para-Figma.
Por que esta skill existe: modelos de imagem desenham telas individuais atraentes, mas derivam entre elas, esquecem estados e silenciosamente quebram a usabilidade (texto pequeno, baixo contraste, alvos de toque pequenos). Solução: fixar um sistema de design primeiro, gerar a partir dele e verificar o que pode ser medido com scripts e o que não pode (bom gosto) com uma rubrica mais a escolha humana.
Alvo = perfil (decida PRIMEIRO, em S0; nunca use o padrão silenciosamente quando o usuário disse site/portal/dashboard)
| Alvo | Orientação / tamanhos | Leia estes (e APENAS estes para a redação do alvo) |
|---|---|---|
mobile (aplicativo) | telas verticais 9:19,5, um tamanho | screen-taxonomy.md, blocos mobile de design-bible-template.md e prompt-templates/README.md, pisos em dp/sp |
web tipo site (site, landing page, loja, blog) | páginas desktop paisagem 16:10 (1440x900) , mais um layout responsivo estreito de 390px da mesma página | web-design.md, prompt-templates/web.md, bloco web de design-bible-template.md, pisos em px |
web tipo app (portal, dashboard, admin, SaaS) | desktop paisagem primeiro; layout estreito depois. Apenas se o usuário disser que celulares são o dispositivo principal, defina "mobile_first": true e torne o layout estreito primário | mesmo que site |
both (ambos) | uma bíblia e tokens compartilhados, dois perfis | ambos os conjuntos, nunca misturados dentro de um único prompt |
Defina "platform": "mobile" | "web" em inventory.json. Um prompt é escrito com exatamente o vocabulário de um perfil.
Higiene de palavras-chave (a razão desta seção existir): modelos de imagem obedecem às palavras que recebem. Um prompt de site que diz "retrato", "telefone", "barra de status", "9:19,5", "navegação inferior", "zona do polegar", "Android/iOS" ou "tela de aplicativo" retorna uma tela de telefone. Prompts web dizem "página de site", "desktop paisagem 16:10, 1440 de largura", "cabeçalho com links", "barra lateral", "sem navegador". O layout estreito é chamado de "layout responsivo estreito, 390px de largura", nunca "tela de telefone". python scripts/prompt_lint.py <design-dir> falha em qualquer prompt em prompts/ que use palavras de outro perfil; execute-o antes de enviar um lote.
Regras de saída (sempre)
- A imagem é a própria UI, borda a borda: sem moldura de dispositivo, sem mockup de telefone/laptop, sem cromo de navegador, sem fundo extra, sem tela ao redor. (Apenas molduras de apresentação se o usuário pedir quadros.) Mobile: telas verticais. Web: páginas desktop paisagem e, onde listado, o layout estreito; páginas longas como uma única imagem alta ou 2-3 imagens de seção da mesma largura.
- Exemplos nesta skill são ilustrações de um padrão, nunca conteúdo: não copie seus nomes, cópia, paletas, tipo ou layouts em um prompt (guarda de viés em
references/design-craft.md). - Alta fidelidade: texto real, ícones reais, imagens reais. Sem lorem ipsum, sem nomes de marca placeholders.
- Um sistema de design em todo o conjunto. Nunca invente um novo estilo por tela.
- Dois modos de prompt (
references/design-craft.md): breve (intenção curta + os poucos fatos que importam + a sensação; padrão para primeiras renderizações e direções S2, dá o resultado mais distinto) e travado (strings exatas, contagens, bloco da bíblia; para irmãos após a escolha e para correções). Renderize breve primeiro, veja, depois trave o que deve concordar. Modelos falham na consistência muito mais do que na beleza, mas restringir demais a primeira renderização a torna mecânica. - Edite, não regere: corrija uma string errada com uma passagem de edição nomeando apenas essa alteração; uma regeneração completa joga fora tudo que já foi aprovado.
- Sem marcas reais, logotipos ou rostos de pessoas reais; apenas nomes fictícios e marcas genéricas. Nunca escreva chaves de API no repositório.
- Responda ao usuário no idioma em que ele escreve (frequentemente Urdu Romanizado/Hinglish); arquivos e prompts permanecem em inglês.
Fluxo de trabalho (S0-S9)
Trabalhe na pasta do projeto do usuário sob design/<app-slug>/ (layout: references/repo-layout.md). Acompanhe o status da fase em design/<app-slug>/STATUS.md. Pergunte ao usuário apenas quando a resposta mudar o resultado (máximo 3 perguntas em S0); caso contrário, escolha um padrão sensato e diga isso.
S0 Captura. Nome do aplicativo/site, propósito em uma linha, público-alvo, alvo + tipo (tabela acima; pergunte se as palavras "site", "portal", "dashboard" ou "landing page" aparecerem e o alvo não estiver claro), sensação da plataforma (mobile padrão: Android + iOS neutro, Material 3; web: neutro), palavras de tom, claro/escuro (padrão: tokens claro + escuro, telas em claro). Escreva BRIEF.md (problema, público, escopo, não-objetivos); se o usuário não estiver disponível, declare a interpretação que você fez no topo em vez de esperar. Leia references/aesthetic-vs-usability.md uma vez.
S1 Inventário de telas. Construa inventory.json a partir de references/screen-taxonomy.md (web: references/web-design.md seção 4): núcleo fixo (splash, idioma, onboarding, permissões, autenticação, home, configurações) + telas de funcionalidades específicas deste aplicativo + detalhes + estados + diálogos + folhas + componentes. Cada item tem id, grupo, propósito, estados, prioridade. Mostre ao usuário uma lista compacta; confirme antes de gastar créditos de imagem.
S2 Plano de design + bíblia + 3 direções (portão humano). Primeiro escreva um plano de design de 10 linhas por direção (references/design-craft.md seção 2) e revise-o contra os padrões genéricos. Em seguida, escreva a bíblia (references/design-bible-template.md) como três alternativas curtas (humor diferente, lógica de paleta, tipo, linguagem de forma). Cada bíblia nomeia a cor do texto em cada cor preenchida (on-primary, on-accent, texto de badge) e a barra de status da plataforma (Android: hora à esquerda, ícones à direita; iOS: estilo 9:41). Antes de renderizar, coloque a paleta de cada direção em um pequeno arquivo de tokens e execute scripts/contrast_check.py nele: uma direção que só fica boa com contraste falho não deve chegar à escolha humana. Escreva cada prompt em prompts/<id>.<direction>.md primeiro e envie exatamente o texto desse arquivo (o prompt salvo é o reproduzível). Renderize uma tela herói por direção (web: a mesma página, desktop e mobile). Agrupe todas as três em uma única chamada Codex. Pare e deixe o usuário escolher - bom gosto é a única coisa que scripts não podem julgar, então aqui é onde o humano decide. Registre a escolha em DESIGN.md.
S3 Tokens. A partir da direção escolhida, escreva tokens.json (cores claro/escuro, escala de tipo, grade de espaçamento 4/8, raio, elevação, tamanho de ícone, alvo de toque). Execute ``scripts/contrast_check.py tokens.json`