Communitygithub.com

Umby Discover: Brief Cirúrgico e Direção Criativa

Realiza descoberta criativa e de produto cirúrgica e de alto impacto antes de construir ou redesenhar um site ou aplicação web. Elimina o 'slop' genérico de IA resolvendo direção de marca ausente, ceticismo do comprador, prioridade de conversão, tensão estética e ativos de prova reais com 4 a 5 perguntas precisas, e então trava um Contrato Criativo e Funcional concreto. Use no início de qualquer construção greenfield de site/app, rebranding ou requisição de UI subespecificada.

O que é Umby Discover: Brief Cirúrgico e Direção Criativa?

O Umby Discover é uma skill para agentes de IA (como Claude Code, Cursor, Codex) que impõe uma fase rigorosa de descoberta de produto e criativa antes de qualquer código de UI ser escrito. Em vez de gerar saídas genéricas ('slop') baseadas em médias estatísticas da internet, a skill guia o agente a auditar o repositório existente, separar fatos observáveis de intenções faltantes e fazer de 3 a 5 perguntas cirúrgicas com contrastes concretos (usando um banco de perguntas referenciado). O resultado é um Contrato de Design e Produto compacto (salvo em `.umby/DESIGN_BRIEF.md`) que cobre público-alvo, ceticismo, ação primária, arquétipo estético, pares tipográficos, paleta de cores OKLCH, sequência de seções e antigoals — tudo pronto para ser passado para outras skills como `umby-architect` e `umby-craft`. As plataformas suportadas incluem qualquer ambiente onde agentes de IA operam sobre repositórios de código (CLI, IDE, etc.), e o fluxo é ativado no início de qualquer projeto greenfield ou rebranding. A skill é útil porque elimina suposições, garante direção de marca consistente e evita iterações caras de 'tentar algo e ver se cola'.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Umbylicus/umby-beast-code/tree/HEAD/skills/umby-discover

Perguntar na sua IA favorita

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

Documentação

O que Umby Discover: Brief Cirúrgico e Direção Criativa faz?

Regras permanentes se aplicam. Antes de alterar qualquer coisa, leia ../umby-beast-code/references/standing-rules.md: portões de aprovação, sem deploy ou merge sem um 'go' explícito, branch de recurso com preview, código protegido, manter ou redirecionar cada URL, apenas prova real e o registro de trabalho.

Prompts genéricos forçam agentes a adivinhar, e o palpite de um LLM é a média estatística da internet. Seu trabalho aqui é travar uma identidade visual e de produto específica, opinativa e líder de categoria antes de escrever uma linha de código de componente — sem submeter o usuário a uma pesquisa tediosa de 20 perguntas.


Etapa 1: Separe Fatos Observáveis de Intenções Ausentes

  1. Verifique primeiro os arquivos do workspace (package.json, tokens CSS existentes, ativos de marca, README.md, rotas existentes). Nunca faça uma pergunta que o repositório já responde.
  2. Audite a solicitação do usuário contra os Cinco Pilares de um Brief Não-Slop:
    • Pilar 1 — Trabalho e Ação Primária: Quem chega aqui, que ceticismo eles carregam e qual é a única ação que queremos que eles completem?
    • Pilar 2 — Arquétipo Estético e Tensão: Onde isso se situa visualmente? (Leia references/aesthetic-archetypes.md para os 12 arquétipos não-AI.)
    • Pilar 3 — Prova e Realidade de Conteúdo: Temos dados reais de produto, métricas, fotografia ou mecânicas interativas ao vivo — ou devemos construir uma simulação interativa honesta em vez de um enchimento falso "10.000+ clientes"?
    • Pilar 4 — Escopo de Superfície e Stack: Quais páginas/fluxos pertencem ao Passo 1, e quais restrições de stack se aplicam (velocidade estática Astro vs. app interativo Next.js vs. Shopify headless)?
    • Pilar 5 — Restrições de Brownfield (Apenas Atualizações): Quais URLs, logotipos, hexes de marca ou contratos de checkout/auth são sagrados?

Etapa 2: Execute o Portão de 4 a 5 Perguntas

Se 2 ou mais pilares acima estiverem genuinamente ausentes (e o usuário não solicitou execução autônoma imediata), pause antes de escrever código de UI e faça 3 a 5 perguntas cirúrgicas selecionadas de references/question-bank.md.

Regras para Fazer Boas Perguntas de Descoberta

  • Use a UI de Pergunta do Host Quando Disponível: Se seu ambiente fornecer uma ferramenta estruturada de múltipla escolha (ex.: ask_question), use-a com 3 a 4 opções concretas e contrastantes por pergunta e coloque sua escolha recomendada primeiro, prefixada com (Recomendado). Caso contrário, apresente uma lista numérica limpa em texto simples.
  • Ofereça Contrastes Concretos, Não Tarefas Abertas: Nunca pergunte "Quais cores e fontes você gosta?" Em vez disso, ofereça direcionamentos nítidos: ex.: "(Recomendado) Monólito Escuro de Precisão (calibre Linear / Raycast: obsidiana #0b0c0e, bordas finas e nítidas, único acento elétrico, palco de produto interativo)" vs. "Claro Editorial de Alto Contraste (calibre Stripe Press / Mercury: alabastro quente #faf9f6, display serifado editorial + corpo grotesco limpo, espaçamento generoso diurno)".
  • Limite a no Máximo 5 Perguntas: Uma rodada de perguntas precisas é revigorante; três rodadas de picuinhas parecem quebradas.

Etapa 3: Trave o Contrato Criativo e Funcional

Assim que o usuário responder (ou imediatamente usando sua melhor correspondência de arquétipo se estiver executando sob uma concessão autônoma explícita), escreva o Contrato de Design e Produto compacto (ou inline em 12 a 15 linhas ou salvo em .umby/DESIGN_BRIEF.md em projetos com múltiplas rotas):

  1. Público e Ceticismo: Uma frase nomeando quem visita e a dúvida exata que a página deve superar em 5 segundos.
  2. Ação Primária da Viewport: Exatamente uma frase verbal de CTA primário (ex.: "Iniciar sandbox interativo", "Adicionar saco de 250g · $24").
  3. Arquétipo Escolhido e 3 Referências de Ofício: Arquétipo nomeado de references/aesthetic-archetypes.md + 3 produtos do mundo real cujo padrão de qualidade (nunca IP/ativos copiados) ancora a construção.
  4. Par Tipográfico e Escala: Família de Display + Família de Corpo + Família Mono, com pesos explícitos e regras de tracking.
  5. Âncora da Paleta OKLCH: Luminosidade/base da superfície, tinta primária, alfa de linhas finas e a única cor de acento de alta convicção.
  6. Sequência de Ritmo de Seções: Lista ordenada de 5 a 8 batidas de página onde nenhuma duas seções adjacentes compartilham a mesma geometria de grid.
  7. Antigoals (Exclusões Explícitas): 3 clichês específicos banidos para este projeto (ex.: "Sem brilho SaaS roxo-azulado, sem fileira de 3 colunas com ícone Lucide, sem fotos de clientes não verificadas").

Entregue este contrato travado diretamente para ../umby-architect/SKILL.md e ../umby-craft/SKILL.md.

Habilidades Relacionadas