O que Argus faz?
Você conhece as regras de design. Quatro outras coisas dão errado, e esta skill responde a cada uma:
- Você não pode ver o que faz. Portanto, construa, olhe o resultado renderizado, corrija e olhe novamente.
- Sua primeira ideia é a primeira ideia de todos. Portanto, receba informações externas: o que existe, o que o usuário diz, o que ele mostra.
- Você julga melhor do que gera. Portanto, para trabalhos novos, faça alternativas brutas e escolha olhando.
- Você deriva para o médio e para o fino. Portanto, páginas novas recebem uma ideia, um grande movimento e um argumento completo.
1. Olhe o que existe
Antes de qualquer coisa, encontre e declare em uma linha:
- Plataforma: web, ou um aplicativo móvel (iOS, Android, ambos). Leia o projeto; nunca presuma.
- Superfície: Persuadir (marketing, landing, vitrine), Operar (dashboard, ferramenta, admin, tela de app) ou Ler (docs, artigos).
- Sistema existente:
DESIGN.md, arquivos de tema ou tokens, componentes compartilhados, duas ou três telas finalizadas. - O que o usuário forneceu: capturas de tela, links, logotipos, cores da marca, fontes, fotografias.
Implemente com o framework e as convenções que o projeto já utiliza.
2. Siga a única rota que se encaixa
Use a primeira linha da tabela que corresponder. Leia apenas os arquivos que ela nomeia.
| A tarefa | Faça | Leia |
|---|---|---|
| Um ajuste: um componente, uma correção de espaçamento ou cor | Faça a alteração e olhe. Sem perguntas, relatório de uma linha | Nada, ou a parte de craft.md que ele toca |
Um comando nomeado (polish, audit, typeset, colorize, animate, simplify, variants) | Siga o comando | references/commands/<nome>.md e o que ele nomear |
| "Reveja isto" ou "critique isto" | Relate, não altere nada | review.md, laws.md, verify.md |
| "Deixe isso com melhor aparência", "parece genérico", em algo que existe | Descubra o que está realmente errado e corrija dentro da aparência existente | extend.md seção 3, depois commands/polish.md; para uma fraqueza clara, o comando correspondente |
| Nova tela ou componente em um projeto que tem uma aparência | Estenda. Sem trabalho de direção, sem perguntas | extend.md; mais product.md para superfícies Operar, mobile.md para nativo |
| Nova superfície Operar sem nada para corresponder | Pergunte se o briefing está aberto, depois construa | ask.md, product.md, craft.md; mobile.md se for nativo |
| Nova superfície Persuadir ou Ler sem nada para corresponder | Pergunte se o briefing está aberto, depois o fluxo completo | ask.md, create.md (que traz structures.md e ingredients.md), web.md ou mobile.md; photos.md se as imagens vendem ou se fotos foram fornecidas |
| Um redesenho que o usuário pediu explicitamente | Trate como trabalho novo, mantendo conteúdo e comportamento | A linha de trabalho novo correspondente, mais extend.md seção 1 para inventariar o que deve sobreviver |
Toda rota que constrói algo termina no loop abaixo, com slips.md e verify.md. Ajustes precisam apenas de uma olhada.
Alterar a identidade de um produto existente precisa de um pedido explícito. Sem um, "fazer brilhar" significa melhor trabalho dentro da aparência atual.
3. Pergunte (apenas trabalho novo)
Quando o briefing deixar em aberto para quem é, como deve soar ou o que o usuário tem a mostrar, pergunte antes de projetar: uma rodada, no máximo quatro perguntas sobre o produto, cada uma opcional, nenhuma sobre fontes ou cores. Para uma página nova, pergunte também em torno do que a primeira tela deve ser construída (três abordagens que você propõe para este assunto) e quantas direções eles querem ver lado a lado (1, 3 ou 5; 3 é recomendado). ask.md as contém. Pule perguntas que o briefing ou DESIGN.md já respondem.
Se ninguém estiver lá para responder, declare cada suposição e siga em frente. Nunca espere em um loop.
4. O loop
- Construa a primeira versão real.
- Olhe. Renderize e capture em 320, 390 e 1440 de largura (para nativo, em um simulador ou dispositivo do tamanho de um telefone). Antes de ler o código novamente, anote o que está visível.
- Verifique contra
slips.md. Execute os scripts que se aplicam (vejaverify.md). - Use. Pressione o botão principal, preencha o formulário, navegue por Tab, encontre a navegação na largura de telefone.
- Corrija o que encontrou e olhe novamente. Duas rodadas, depois relate o que restou.
Se nada puder ser renderizado, diga isso, verifique a fonte e não chame o trabalho de verificado. Para trabalho substancial (uma página ou tela inteira) quando houver subagentes, entregue as capturas de tela a um revisor novo que não tenha visto seu raciocínio; suas correções contam como uma das duas rodadas.
Regras que sempre valem
- De quem é a palavra final: uma instrução explícita do usuário; depois o sistema existente; depois as respostas e referências do usuário; depois a direção que você escreveu; depois os números e listas desta skill. Mínimos de acessibilidade não são sobrepostos por gosto, seu ou desta skill. Algo que o usuário pediu nunca é relatado como defeito.
- Conteúdo honesto. Sem lorem ipsum e sem provas inventadas: depoimentos, clientes, logotipos, avaliações, números de uso. Fatos que uma página precisa (um preço, termos de teste) podem ser substitutos plausíveis, marcados em um comentário de código e listados no relatório. Dados de amostra em uma demonstração, catálogo ou dashboard são bem-vindos quando específicos e são rotulados como amostra uma vez na tela.
- Reformulação nunca muda comportamento. Mantenha nomes de campos, IDs, links, manipuladores, ações de formulário, hooks de teste e atributos de acessibilidade.
- Construa os estados que podem acontecer, e todos eles. Pressionado e desabilitado sempre; hover e foco de teclado onde houver um ponteiro ou um teclado. Carregando, vazio e erro onde algo real carrega, pode estar vazio ou pode falhar. Nunca construa uma chamada de rede apenas para ter um estado de carregamento.
- Mínimos de acessibilidade: contraste de texto 4,5:1; foco de teclado visível; controles com pelo menos 24px e 44pt / 48dp em telas sensíveis ao toque; um caminho de movimento reduzido; nada perdido quando o texto é ampliado.
craft.mdtem os números elaws.mdo padrão exato. - Verificado significa olhado.
Relatório
Encontrado: plataforma, superfície, sistema existente, o que o usuário forneceu
Direção: uma frase (trabalho novo), ou o que foi reutilizado e o que foi adicionado (extensão)
Olhado: o que foi renderizado, em quais larguras, o que foi usado manualmente
Corrigido: o que o loop capturou
Suposto: fatos substitutos e dados de amostra, por tipo, ou "nenhum"
Aberto: o que não está feito ou não foi verificado, e qualquer coisa que um guia mande sinalizar
Mantenha-se nestas linhas. Um ajuste recebe uma linha.
Arquivos
| Arquivo | Contém |
|---|---|
ask.md | A rodada de perguntas |
create.md | Trabalho novo de Persuadir e Ler: a ideia, o grande movimento, alternativas brutas, a direção |
structures.md | Estruturas de página para escolher, para que as alternativas difiram na forma e não apenas na cor |
ingredients.md | Os papéis de token que toda direção preenche, e as opções de cor, tipo, forma e espaço |
extend.md | Trabalhar dentro de uma aparência existente |
product.md | Superfícies Operar: dashboards, ferramentas, telas de app |
photos.md | Páginas lideradas por fotografias |
web.md, mobile.md | O que vai onde em uma página web ou tela de telefone |
slips.md | Erros realmente cometidos, por superfície. Verificado a cada olhada |
verify.md | Como capturar, verificar e revisar; os scripts auxiliares |
craft.md | Todos os números: tipo, cor, espaço, movimento, alvos |
laws.md | O que as leis de UX justificam e não justificam; mitos |
tells.md | Padrões comuns de design gerado |
review.md, design-md.md | Formato de crítica; registro de decisões |
Todos estão em references/.
Todo caminho nesta skill (references/..., scripts/..., assets/...) é relativo à pasta que contém este arquivo, não ao projeto do usuário. No Claude Code, essa pasta é ${CLAUDE_SKILL_DIR}. Ao executar um script, use seu caminho completo, por exemplo node "<pasta desta skill>/scripts/lint.js" <alvo>.