O que Agência de Um Só faz?
Por que isso existe
Quando se pede um site a um modelo, ele produz o site mais provável. Banir esse visual apenas o desloca para o próximo mais provável (creme + serifa + clay, preto + verde ácido, sobrancelhas EM CAIXA ALTA, → em links: os 'tells' de segunda onda). E 'ser criativo' também não resolve: um site empresarial precisa parecer que uma agência excepcional o fez, crível e polido, onde tudo se encaixa.
Ordem de prioridade: 1) bonito e certo para o cliente, 2) claro e crível, 3) distinto (sem parecer de IA). Evitar 'tells' de IA é necessário mas não suficiente: uma página que é distinta mas simples ou fora da marca falhou.
Portanto, esta habilidade parte da marca que o cliente já tem, remove as escolhas mais arriscadas do construtor e impõe um padrão de acabamento e beleza de nível mundial:
- A marca e os ativos do cliente primeiro, depois a estratégia: cores do logotipo, fotos reais, referências, posicionamento, provas, ideia de marca.
- Aleatoriedade real, cor bloqueada pela marca: um script sorteia as alavancas (composição, dispositivo de marca, estratégia de paleta, estratégia tipográfica). A cor vem do logotipo do cliente quando existe; caso contrário, de uma biblioteca de paletas curadas e com contraste verificado, nunca do gosto do modelo.
- Um crítico independente avalia cinco direções quanto à tipicidade e força; um script escolhe entre as que são atípicas e fortes.
- Um padrão de ofício (
craft.md) e uma peça central heróica construída isoladamente primeiro. - Verificações inquestionáveis: lint a cada edição, medição renderizada, diff entre planejado e renderizado, memória entre projetos, verificações de beleza renderizadas e um revisor cego que pontua conveniência e adequação à marca primeiro, depois ofício e distinção.
Quando as regras colidem, esta ordem vence: briefing do cliente e ativos de marca > beleza (craft.md Prioridade, §2b) > paleta e cartas sorteadas > lista de 'tells'. Uma carta ou uma regra de evitar 'tells' nunca justifica algo mais feio ou fora da marca.
$S = a pasta desta habilidade: o diretório base que o Claude Code mostra quando a habilidade carrega (${CLAUDE_PLUGIN_ROOT}/skills/agency-of-one como plugin; .claude/skills/agency-of-one ou ~/.claude/skills/agency-of-one como drop-in). Execute scripts a partir da raiz do repositório: node $S/scripts/<nome>.mjs. O hook da sessão imprime o caminho absoluto dos scripts; passe esse caminho absoluto para cada subagente (eles não conseguem resolver $S sozinhos). Nunca abra references/decks.json. As cartas vêm apenas do script.
Modo
- Agência (padrão): voltado para negócios, profissional, polido. Leia
references/agency.md. - Expressivo (
--mode expressive): apenas quando o briefing pedir algo experimental, artístico, editorial, de campanha ou de evento. Usa mídias de referência e restrições não-web; leiareferences/process-notes.md.
Portão
DESIGN.mdexiste → siga exatamente; vá para a Fase 3. Proponha emendas; nunca se desvie silenciosamente. Se não tiver o marcador<!-- agency-of-one design v1.1 -->é anterior à cor bloqueada pela marca: executebrand-extract.mjs; se a paleta conflitar com os ativos de marca (o plan-diff relata o conflito), proponha uma emenda de cor §4 ao usuário antes de construir em cima dela.- O briefing define uma direção ou guia de marca → o briefing vence, mesmo que nomeie um 'tell' conhecido. Registre-o (e suas exceções no §9); vá para a Fase 3.
- Caso contrário → Fases 1–2, mesmo para páginas "pequenas".
Configuração única por repositório: npm i -D playwright && npx playwright install chromium (como devDependency, para que npm i posterior não o remova).
Fase 1: Ativos, marca, estratégia (DESIGN.md §1)
- Ativos reais: pergunte primeiro (agency.md Passo 0). Logotipo, fotos das pessoas, dados biográficos, nomes de clientes ou um estudo de caso, detalhes de contato e legais, números reais, capturas de tela do produto. Em revisões cegas, credibilidade e imagens estagnam em cerca de 6/10 sem eles, por melhor que seja o design. Os que faltam tornam-se espaços reservados profissionais (agency.md Passo 5), e seu relatório começa com o que fornecer.
- A marca que você já tem (agency.md Passo 0a). Se houver logotipo, brasão, site existente ou fotos de pessoas, execute
node $S/scripts/brand-extract.mjs(autodescoberta, ou passe caminhos). Ele escreve.design-review/brand.json; a partir de então,draw.mjsfica bloqueado pela marca automaticamente e o plan-diff reprova qualquer paleta que perca a cor do logotipo. Atendido: confirme a cor extraída da marca com o usuário em uma linha. Nunca lute contra as próprias cores da marca. - Referências (atendido): peça 2–3 sites que o cliente ache bonitos (qualquer indústria). Salve capturas de tela em
design-references/. O revisor compara com elas. Elas definem o padrão de qualidade, não o visual. - Gosto humano (apenas atendido): pergunte uma vez, "2–3 marcas ou objetos que você admira, e um site concorrente que você não quer que se pareça."
- Estratégia (modo agência, agency.md Passo 1): frase de posicionamento, a única crença, 5 códigos de categoria marcados como manter/quebrar (quebrar ≥ 2), ideia de marca, personalidade com "mas não", inventário de provas (nunca invente provas).
- Inventário de assunto: 8+ artefatos reais, lugares, materiais e vernáculo do mundo do cliente (12+ no modo expressivo). No modo agência, alimentam a direção das imagens, o dispositivo de marca e o texto, não o figurino.
- Esboce a frase heróica e o rótulo da ação principal na voz da marca. Você pode refiná-los após o sorteio.
Fase 2: Sorteio → linha de base → divergir → crítico → escolher → comprometer
2a. Sorteio. node $S/scripts/draw.mjs --project "<nome>" (modo agência por padrão) distribui uma referência de qualidade, sistema de composição, dispositivo de marca, estratégia de paleta e estratégia tipográfica. A cor fica bloqueada pela marca automaticamente quando .design-review/brand.json existe (substitua apenas com --no-brand "<motivo>", por exemplo, um rebranding solicitado pelo cliente); caso contrário, vem de uma biblioteca de paletas curadas e com contraste verificado: pontos de partida bonitos, nunca matizes aleatórios crus. Cole em DESIGN.md §2. Um veto com motivo escrito: --redraw <slot>. Se uma carta determinar algo na lista de 'tells' (por exemplo, uma grade visível), é permitido como uma exceção determinada pela carta: registre no §9 como card: <motivo> e execute como estrutura, não como decoração.
2b. Linhas de base. Escreva dois gêmeos: o gêmeo IA (o que um modelo faria para este briefing: fontes, hexes, herói, seções) e, no modo agência, o gêmeo clichê de agência (a versão de festival de publicidade). Verifique ambos contra references/tells.md.
2c. Divergir. Escreva 5 direções (A–E) em .design-review/directions.md, junto com um breve resumo do briefing e o inventário do §1. Cada direção recebe uma expressão da ideia de marca, como cada alavanca sorteada é aplicada, a composição heróica (um pequeno wireframe ASCII), classes de face (não faces específicas ainda), um esboço de paleta e o dispositivo de marca. Não as pontue você mesmo. Pelo menos 3 devem diferir na arquitetura da página, não apenas na aparência.
2d. Crítico independente. Execute o subagente direction-critic (agency-of-one:direction-critic como plugin) e forneça apenas o caminho. Ele retorna tipicidade t e força s para cada direção, além de um PICK_ARG.
2e. Escolher. node $S/scripts/draw.mjs --pick "<PICK_ARG>". No modo agência, pega as direções mais fortes (s ≥ 8, dentro de 0.5 da melhor), excluindo apenas as claramente genéricas (t ≥ 0.7). No modo expressivo, favorece as atípicas. Código de saída 3 significa que nenhuma se qualifica: escreva 3 novas direções (incorpore a STRONGEST_IDEA_TO_STEAL do crítico) e reexecute o crítico. Construa o que o script escolher. Atendido: mostre a escolhida e a vice-campeã em uma linha cada e deixe o usuário substituir.
2e′. Composições heróicas (o portão da beleza). Antes de comprometer, construa o herói (dobra + primeira rolagem, desktop e mobile) para a escolhida e a vice-campeã como duas composições estáticas rápidas com ativos reais. Capture ambas (screenshot.mjs --file comp-a.html comp-b.html), depois forneça a um design-reviewer novato apenas as duas imagens da dobra e da dobra mobile, sem rótulos, e peça uma escolha forçada: de qual o cliente se orgulharia mais de enviar, e por quê? Construa a vencedora. Se o revisor considerar ambas comuns ou fora da marca, redesenhe em vez de polir.
2f. Diff. Preencha a tabela DESIGN.md §3 contra ambos os gêmeos. Qualquer eixo correspondente deve mudar, a menos que o briefing o exija. Teste de troca: o nome de um concorrente caberia? Se sim, extraia mais do §1.
2g. Comprometer tokens. Complete templates/DESIGN.md → DESIGN.md, incluindo o bloco tokens legível por máquina que o plan-diff lê.
- Tipo:
references/typography.md. Renderize sua lista restrita comnode $S/scripts/type-specimen.mjse escolha olhando. Use uma escala de proporção; marque tamanhos de exibição fluidos comofluid. - Cor: comece da proposta do brand.json (ou da paleta curada): marca verbatim, brandForText para texto em fundos claros, matizes escuros / claros, neutros tingidos e tinta (craft.md §4). Teste AA. Mantenha a cor do logotipo reconhecível.
- Verificação de repetição:
node $S/scripts/designlog.mjs check --project "<nome>" [--brand-locked] --display … --body … --ground … --accent … --layout … --medium "<composição ou mídia primária>". Se relatar REPEAT, altere os eixos repetidos.
Fase 3: Construir para o padrão de ofício
3a. Peça central heróica primeiro, isoladamente. Construa apenas o herói (modo agência: a composição sorteada executada com perfeição; modo expressivo: o mecanismo de assinatura). Capture a tela (screenshot.mjs, com --state para estados interativos) e itere até que atinja ≥ 8 em cada eixo de ofício relevante em references/craft.md. Só então construa o resto.
3b. Construa a página apenas a partir de tokens (variáveis CSS / @theme do Tailwind v4), seguindo a arquitetura do agency.md Passo 3 ou o esqueleto expressivo. shadcn/Radix fornecem apenas comportamento; reestilize cada primitiva. O texto é específico, em letras minúsculas (exceto inícios de frase) e na voz da marca; a prova é real ou reservada. O hook de lint sinaliza 'tells' a cada edição, então corrija-os à medida que surgirem.
3c. Passagem de acabamento. Percorra references/craft.md §1–10 linha por linha: detalhes tipográficos, auditoria de grade, ritmo, cor e contraste, imagens e espaços reservados, movimento e estados, composição responsiva em 1440/1024/768/390, edição de texto (−30%), acabamento técnico. Esta passagem é de onde vem o "feito por agência". Não a pule.
Fase 4: Verificar (máximo 3 rodadas, mantenha a melhor)
- Instantâneo primeiro: comprometa (ou copie) o estado atual antes de cada rodada para que uma revisão pior possa ser desfeita.
node $S/scripts/slop-lint.mjs: zero erros; todo aviso corrigido ou justificado no §9 +slop-lint.config.json.node $S/scripts/screenshot.mjs --url <url de dev> --routes / /about …(ou--file index.html about.html …para estático; todas as páginas, não apenas a inicial)--state <nome>=click:<sel>|hash:<#id>|scroll:<sel>|hover:<sel>para cada estado de assinatura. Observe a dobra, dobra mobile, scroll50 e capturas de estado.node $S/scripts/plan-diff.mjs: a cor do logotipo está na paleta, faces planejadas carregadas, paleta renderizada, escala aplicada, sem fundos fora do plano, e as verificações de beleza em desktop e 390px: sem conteúdo invisível por animações ou oculto sem JS, sem avatares de iniciais, grupos de fotos consistentes (corte, tamanho, fundo), sem texto centralizado em várias linhas, sem rótulos em caixa alta, sem barras divisórias, um cabeçalho de página projetado em cada página.- Revisão cega: o subagente
design-reviewer(agency-of-one:design-reviewer) recebe apenas a URL ou arquivo, rotas e.design-review/. Ele pontua conveniência e adequação à marca primeiro, depois ofício e distinção, comparando comdesign-references/se presente. SHIP requer conveniência, adequação à marca e cada eixo de ofício ≥ 8. O veredito de um site de várias páginas é o de sua página mais fraca. - Corrija e re-renderize. Mantenha uma revisão apenas se o revisor a pontuar mais alto que a melhor anterior. Pare após 3 rodadas e relate o que ainda está aberto.
- Espelho: remova uma decoração que não sirva à ideia de marca; anote no DESIGN.md §11.
- Registre:
node $S/scripts/designlog.mjs add --project "…" …mesmas flags que check… --media "<resumo do sorteio>" --signature "<dispositivo / peça central>"(--log <caminho>para manter o log no repositório). - Relatório: direção (uma linha), ideia de marca, peça central, resultados de lint/plan-diff/revisão com pontuações de ofício, exceções abertas, cada espaço reservado e suposição que o cliente deve preencher ou confirmar.
Arquivos de referência
| Arquivo | Quando |
|---|---|
references/agency.md | Modo agência: estratégia, sistema de identidade, arquitetura de negócios, espaços reservados, credibilidade |
references/craft.md | 3a, 3c, Fase 4: padrão de acabamento, alinhamento, sistema de fotos, cabeçalhos de página, pontuação |
references/patterns.md | 3b: receitas comprovadas para grades de pessoas, cabeçalhos de página, faixas de prova, eventos, doações, formulários |
references/palettes.json | Biblioteca de paletas curadas (lida por draw.mjs; você pode navegar) |
references/tells.md | 2b, 2f, Fase 4: 'tells' de IA (geração 1–3) com assinaturas e fontes |
references/typography.md | 2g: procedimento de fontes, fontes, licenças, escala |
references/process-notes.md | Modo expressivo: interpretação de cartas; exemplos trabalhados |
templates/DESIGN.md | 2g |