pacote-de-referência-de-marca

Pacote de referência de marca

O pacote é contexto, não conteúdo. Ele registra o que a marca já é (público, voz, linguagem visual, tokens e as telas e cópias de onde cada afirmação vem) para que formatos, scripts e decisões de design possam ser feitos a partir dele posteriormente. Sem ganchos, scripts ou séries no pacote. Se uma fonte sugerir um, anote a fonte e deixe a decisão em aberto.

Onde ele se encaixa:

upstream (estratégia) ──→ este skill (marca observada) ──→ downstream (formatos, scripts, reels)
ICP · VOC · voz da marca   o que as superfícies mostram/dizem      script-para-reel, shader-lab

Este skill não estabelece ICP, voz do cliente ou voz da marca. Ele encontra os artefatos upstream, verifica as superfícies em relação a eles e marca cada um como verificado / inferido / ausente (pacote §0). Lacunas retornam upstream; não tente encobri-las aqui.

Arquivos:

• template.md: a estrutura de seções do pacote.
• scripts/: helpers genéricos de captura e renderização.
• apps/<app>/: uma pasta por aplicativo com suas URLs, receita de fluxo, peculiaridades, regras de produção e layout do PDF.
  • Leia apps/<app>/README.md primeiro. Para um novo aplicativo, crie-o durante a coleta.

Comandos abaixo são escritos relativos a esta pasta de skill (.claude/skills/brand-reference-pack/), e os caminhos de saída são relativos aonde você os executa. Execute-os da raiz do projeto e prefixe scripts/ com o caminho do skill. pack_pdf.py resolve sua configuração relativa ao skill.

0. Coleta (uma rodada de AskUserQuestion, apenas para novo aplicativo)

Colete:

• Nome do aplicativo.
• URL do site.
• Contas de redes sociais.
• ID da App Store e país (ID do pacote Play se relevante).
• Como executar o aplicativo: build do simulador, TestFlight, aplicativo web ou emulador.
• Caminho do repositório de código, se houver.
• Documentos existentes de marca, ICP ou pesquisa.
• Qual fluxo é o principal.
• O que é proibido em produção.
• Pasta de saída.

Escreva as respostas em apps/<app>/README.md.

1. Verificação das fundações (ICP, VOC, voz da marca)

Para cada fundação, procure o artefato upstream: uma wiki ou pasta de docs, decks de pesquisa, um livro de marca.

• ICP: um cliente-alvo definido, apoiado por dados ou pesquisa. Anote sua confiança e seu tamanho amostral.
• Voz do cliente: palavras dos próprios clientes de entrevistas, avaliações, suporte ou comunidade. Depoimentos no próprio site da marca contam apenas como evidência fraca: são curados.
• Voz da marca: um guia de voz escrito ou regras de cópia.

Registre cada um na tabela §0 do pacote. Ao longo das etapas 2 a 5, verifique se as superfícies atuais correspondem ao artefato. Divergências vão para Decisões em aberto. Se um artefato estiver ausente, diga e nomeie o trabalho upstream que o preencheria; não invente a fundação a partir das superfícies.

2. Superfícies públicas (paralelo quando possível)

Toda afirmação precisa de um arquivo em refs/.

Site:

node scripts/site.mjs <url> <marca>/refs/web

Isso salva capturas de tela completas e de herói para desktop e mobile, além de site-styles.json com fontes (incluindo nomes reais por trás de IDs de font-host), cores, imagens, links e o texto da página. Divida a captura de tela da página completa em cerca de 4 partes para lê-la.

App Store:

node scripts/store.mjs <id> <marca>/refs/store [país]

Isso salva a listagem (o posicionamento oficial), as capturas de tela da loja e as avaliações como material VOC bruto.

Redes sociais (no navegador integrado):

• Recuse cookies opcionais.
• Grade: colete o src e alt da imagem de cada post, desenhe-os em um canvas, substitua a página por ele e tire uma captura de tela.
• Legendas: fetch de mesma origem de cada página de post → og:description.
• Deslogado, você só obtém cerca de 12 posts. Diga isso e, se os reels forem importantes, peça ao usuário para fazer login ou exportar.
• Se você obtiver os reels, anote seu ritmo, estilo de legenda e áudio.
• Escreva tudo em refs/<plataforma>/.

Documentos existentes: use um subagente Explore para sintetizar público, promessa, terminologia, regras de voz e afirmações, com citações de arquivos.

3. Tokens de código (se houver um repositório)

Use um subagente Explore para encontrar o tema para o framework que o aplicativo usa:

• Flutter ThemeData e constantes de cor
• Config do Tailwind
• Variáveis CSS
• Catálogos de ativos iOS
• colors.xml do Android

Também cubra fontes, raios, convenções de movimento, shaders, arquivos de logotipo e cópias de IU notáveis. Verifique os hexadecimais você mesmo. Escreva tokens.json com papéis de cor, a escala tipográfica (escalada para 1080×1920), forma, movimento e canvas.

Cópia dentro do aplicativo: extraia toda string voltada ao usuário do código da IU, textualmente com arquivo:linha, para o cérebro da persona (etapa 7):

python3 scripts/app_copy.py <raiz src> <persona>/raw/app-copy/app-copy-<data>.md <diretórios/arquivos de IU…>

(Flutter: app/lib com pages widgets constants models enums main.dart; --ext=.tsx etc. para outras stacks.) Ele filtra logs, chaves e ids; ainda assim, examine a saída em busca de algo secreto antes de colocá-lo no cérebro.

4. Caminhada pelo aplicativo ao vivo

A fonte mais rica: é aqui que a gramática visual e verbal real do produto aparece.

• Consentimento primeiro: declare exatamente o que a execução escreve em produção (conta, respostas de avaliação, relatórios gerados, conclusões) e obtenha um sim. O usuário faz todo login e cadastro. Nunca digite credenciais, nunca assine, nunca envie mensagem para um coach de IA.
• Observe e grave: anexe o painel do simulador (mcp__Claude_Code_iOS_Simulator__control attach).
  • Inicie xcrun simctl io <UDID> recordVideo --codec=h264 --force <arquivo> em segundo plano.
  • Pare-o durante o login e inicie um novo depois para que nada precise ser cortado.
  • Pare com pkill -INT -f recordVideo.
• Direcione por labels de acessibilidade, não por coordenadas: UDID=… OUT=<marca>/refs/app scripts/ui.sh tree|shot|label|tap|swipe|hold.
  • Tire uma foto de cada nova tela, nomeada após seu título.
  • Aguarde animações e a cópia do CMS se estabelecerem antes de fotografar; se uma linha não foi renderizada, está "não capturada".
  • Monte uma folha de contato por estágio (PIL, algumas linhas) e leia essa, não cada PNG.
• Siga a receita do aplicativo em apps/<app>/README.md. Adicione quaisquer novas peculiaridades que encontrar de volta a ele.
• Áudio: a gravação do simulador não tem áudio. Se o aplicativo tiver voz ou áudio, peça ao usuário um arquivo de origem.
• Depois:
  • Renumerie as capturas de tela na ordem de captura.
  • Construa refs/app-flow-sheet.jpg.
  • Comprima as gravações: scale=540:-2,fps=30,crf 26.

5. Escreva o pacote

Preencha template.md em <marca>/README.md.

• Citar apenas o que você viu.
• Onde as superfícies discordam, a superfície ao vivo mais recente é o padrão de trabalho e a discordância vai para Decisões em aberto.
• §0 vem da etapa 1.

6. Verifique

Passe para um subagente novo o README e a pasta refs/, não suas conclusões. Peça a ele para verificar cada linha, hexadecimal e afirmação citados em um arquivo, e listar qualquer coisa sem fonte. Corrija ou marque cada item antes da devolução.

7. Saída

• PDF: escreva apps/<app>/pdf.json (copie o GetAhead: capa, fonte, acento, grupos de paleta apontando para tokens.json, linhas de espécime, páginas de captura de tela). Então execute:

  python3 scripts/pack_pdf.py apps/<app>/pdf.json
  

  Verifique o resultado como uma folha de contato pdftoppm -r 40.
• Docs: se o projeto tiver uma wiki ou docs, arquive o pacote lá seguindo suas próprias convenções (página, índice, log, flags de contradição nas páginas que ele substitui).
• Cérebro da persona: se o projeto tiver um (por exemplo, persona/, o cérebro da marca como pessoa a partir do qual a geração de scripts fala), copie as capturas da caminhada do aplicativo para raw/app-run-<data>/ e a cópia do aplicativo para raw/app-copy/ (com o sim do usuário: raw/ é deles), então execute o workflow de ingestão do próprio cérebro (seu CLAUDE.md): páginas de origem, páginas de conceito, reconstrução de cartão com linhas textuais do aplicativo. O pacote registra como a marca se parece; o cérebro registra como ela fala — scripts se baseiam no cérebro.
• Envie: o PDF e o README, com SendUserFile.
• Relatório:
  • o que foi escrito em produção
  • o que não foi capturado
  • o status das fundações
  • as decisões em aberto