Communitygithub.com

Agência de Um Só

Instrui um agente a atuar como uma agência de design completa, produzindo um logotipo e uma pequena ficha de marca. O processo segue a metodologia 'Agência de Um Só', explicando sua existência, modo de uso. Utilize quando uma nova tarefa exigir este ofício.

O que é Agência de Um Só?

Esta habilidade transforma um agente de IA em uma 'agência de um só' — um estúdio de design completo autônomo — capaz de criar uma identidade visual profissional e um pequeno guia de marca, culminando em um logotipo e uma ficha de marca. Diferente de gerar designs genéricos com 'jeito de IA', a habilidade prioriza a beleza artesanal e a adequação à marca do cliente antes de qualquer estratégia. Ela funciona através de um processo estruturado em fases: coleta de ativos reais do cliente, extração de cores da marca, uso de scripts para gerar combinações visuais verdadeiramente aleatórias (mas restritas à paleta de cores da marca), e um crítico independente que avalia as direções de design para garantir que sejam simultaneamente fortes e atípicas. O resultado passa por rigorosas verificações de qualidade, linting visual, revisão cega por pares e diffs entre o planejado e o renderizado, assegurando um padrão de acabamento de nível mundial. A habilidade suporta dois modos: 'Agência' (padrão, profissional) e 'Expressivo' (experimental, artístico).

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sam-pop/agency-of-one/tree/HEAD/skills/agency-of-one

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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:

  1. A marca e os ativos do cliente primeiro, depois a estratégia: cores do logotipo, fotos reais, referências, posicionamento, provas, ideia de marca.
  2. 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.
  3. 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.
  4. Um padrão de ofício (craft.md) e uma peça central heróica construída isoladamente primeiro.
  5. 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; leia references/process-notes.md.

Portão

  • DESIGN.md existe → 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: execute brand-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)

  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.
  2. 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.mjs fica 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.
  3. 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.
  4. 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."
  5. 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).
  6. 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.
  7. 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 com node $S/scripts/type-specimen.mjs e escolha olhando. Use uma escala de proporção; marque tamanhos de exibição fluidos como fluid.
  • 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)

  1. Instantâneo primeiro: comprometa (ou copie) o estado atual antes de cada rodada para que uma revisão pior possa ser desfeita.
  2. node $S/scripts/slop-lint.mjs: zero erros; todo aviso corrigido ou justificado no §9 + slop-lint.config.json.
  3. 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.
  4. 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.
  5. 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 com design-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.
  6. 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.
  7. Espelho: remova uma decoração que não sirva à ideia de marca; anote no DESIGN.md §11.
  8. 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).
  9. 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

ArquivoQuando
references/agency.mdModo agência: estratégia, sistema de identidade, arquitetura de negócios, espaços reservados, credibilidade
references/craft.md3a, 3c, Fase 4: padrão de acabamento, alinhamento, sistema de fotos, cabeçalhos de página, pontuação
references/patterns.md3b: receitas comprovadas para grades de pessoas, cabeçalhos de página, faixas de prova, eventos, doações, formulários
references/palettes.jsonBiblioteca de paletas curadas (lida por draw.mjs; você pode navegar)
references/tells.md2b, 2f, Fase 4: 'tells' de IA (geração 1–3) com assinaturas e fontes
references/typography.md2g: procedimento de fontes, fontes, licenças, escala
references/process-notes.mdModo expressivo: interpretação de cartas; exemplos trabalhados
templates/DESIGN.md2g

Habilidades Relacionadas