IA não adivinha: por que contexto de marca é o insumo mais importante

A IA não adivinha o que a sua marca quer dizer. Ela executa rápido em cima do que você entrega de contexto, e quando o que você entrega é vago, o que volta é rápido e vago também. Em um projeto recente, comprovei na prática que o insumo mais importante no desenvolvimento não é a ferramenta, e sim o conhecimento sobre o que fazer, documentado. E isso vale além da IA: é a marca sabendo dizer, com clareza, o que ela é.

Vi isso de perto num projeto para um movimento de reaproveitamento de resíduos têxteis que estava repensando a própria presença digital. A primeira versão do site eu construí estudando a marca por conta própria: site antigo, logo, cores, o objetivo que ela comunicava. Cheguei perto, e a cliente já estava encantada com o projeto antes mesmo de qualquer revisão de branding.

O ponto de virada foi quando chegou o manual estratégico completo que a assessoria de branding, contratada pela cliente, havia produzido. Tudo documentado em um workspace do Notion, com todas as informações detalhadas de posicionamento, branding, palavras a usar e evitar, tom, objetivos e muito mais. Ler aquilo confirmou o quanto eu tinha acertado no feeling, e ao mesmo tempo me deu o que faltava: sair do feeling e passar a trabalhar com regra documentada. A partir daquele momento a marca tinha um discurso articulado sobre si mesma, e a diferença nas entregas foi enorme.

A IA amplifica o que já existe. Quando o posicionamento é claro e o objetivo está definido, ela produz com velocidade e no alvo. Quando esse contexto não existe, ela produz com a mesma rapidez, só que entrega o que não serve, e o resultado é desperdício de tempo, créditos e energia revisando algo que nunca esteve alinhado. Nesse projeto o contexto existia, e existia bem feito: a marca tinha investido num trabalho de branding sério, com posicionamento, propósito e tom documentados com cuidado. Foi essa organização que deu à IA um alvo claro pra mirar, e é ela que explica o salto de qualidade nas entregas.

Do Notion ao código: o fluxo que usei

O workspace da marca no Notion reunia 16 documentos estratégicos: origem da empresa, DNA e narrativa da fundadora, propósito e valores, produtos e soluções, desafios estratégicos, identidade visual, estratégia de blog e muito mais.

Material rico, mas escrito pra humano ler, não pra IA consumir. Um manual de marca tem páginas de contexto que a pessoa da assessoria precisa pra defender uma decisão. O Claude Code não precisa do argumento, precisa da regra. Então o trabalho do Claude Cowork não foi copiar o Notion, foi destilar: ler cada subpágina e reduzir a diretrizes curtas e acionáveis.

Vale explicar como o Cowork faz isso. Ele não tem o conteúdo do Notion por padrão, quem dá esse acesso é um conector, um plugin que liga a ferramenta ao workspace e deixa ele navegar pelas páginas como se tivesse a permissão que eu tenho. A partir daí ele trabalha em etapas: abre uma subpágina, lê, resume no formato que eu pedi, passa pra próxima, e vai encadeando isso sozinho até cobrir tudo. O resultado ele não devolve só na tela, ele escreve direto em arquivos no computador. E aqui tem um detalhe importante de controle: o Cowork opera dentro de uma pasta que eu defino, então ele só lê e grava ali, sem passear pelo resto da máquina.

Foi nessa pasta que os .md destilados foram nascendo. Os 16 documentos do Notion viraram mais de vinte arquivos, porque alguns rendiam mais de uma diretriz que fazia sentido separar.

Na prática, o manual descrevia o tom como "claro, educativo, humano e inspirador", com a comunicação sempre "direta, sem complexidade técnica desnecessária". Destilando isso, virou uma regra clara o suficiente pra saber se um título de seção ou uma chamada de post está no tom da marca ou não:

# Tom de voz
- Educativo e acessível: ensina conceito de forma simples, sem jargão técnico.
- Humano e inspirador: tem história e bastidores, mostra que a transformação é real.
- Consciente, sem sensacionalismo: foca na solução, não no alarme.

## Palavras que usamos
reaproveitamento, transformação, economia circular, impacto positivo,
consciência, real, autêntico, recomeço

## Palavras que evitamos
"ecológico", "verde" como adjetivo de marca, "lixo" (usar "resíduo têxtil"),
jargão técnico sem explicação, promessa exagerada, greenwashing

O mesmo pra posicionamento e persona, cada um num arquivo:

# Posicionamento
A Teciklar não vende reciclagem, transforma resíduos têxteis em soluções
sustentáveis usando a economia circular como ferramenta de conscientização.
Território próprio: sustentabilidade prática + educação acessível + humanização.
Big idea: "Nada é lixo quando você aprende a enxergar valor."

# Persona: consumidor consciente
Busca coerência entre discurso e prática, autenticidade e bastidores visíveis.
Rejeita greenwashing e sustentabilidade de fachada. Aberto à mudança, mas
ainda em transição, precisa de solução prática, não de discurso.

Esses arquivos ficaram numa pasta docs/ versionada junto do projeto, e viraram a base que eu e o Claude Code consultávamos durante o desenvolvimento. Foi uma decisão deliberada manter o contexto como .md versionado no repo, e não preso ao Notion ou colado no prompt a cada sessão. Assim o Claude Code lê como arquivo local, sem depender do conector toda vez, e o contexto de marca evolui com diff rastreável igual ao resto do código.

A destilação não saiu pronta de primeira. O Cowork trazia um primeiro corte de cada documento, e eu revisava o que tinha virado regra: cortava o que era contexto de bastidor, ajustava o que ele resumia demais e conferia se cada diretriz ainda batia com o que a assessoria quis dizer. No fim foi mais curadoria do que exportação automática. O valor está em fazer esse trabalho uma vez e reaproveitar o resultado em tudo que veio depois.

A diferença aparece na entrega. Um mesmo trecho de site, antes e depois de carregar esse contexto:

# Antes (sem contexto, tom genérico)
"Recicle seus resíduos e ajude o planeta"

# Depois (com o contexto carregado)
"Nada é lixo quando você aprende a enxergar valor"

O "depois" é a big idea da marca, e respeita as regras de não usar "lixo" como descarte e de convidar em vez de cobrar. A IA chegou nesse texto porque a regra já estava escrita no contexto, não porque adivinhou.

Um contexto, várias entregas

O escopo do projeto não parou no site. Passei a produzir também vídeos de conteúdo pra redes sociais, usando React com Remotion, biblioteca que monta vídeo programaticamente a partir de componentes React.

O mesmo contexto extraído do Notion foi reaproveitado aqui. O fluxo combinou o Claude Code pros componentes, uma Skill do Remotion pra orientar boas práticas de animação e exportação, e o contexto de marca pra garantir aderência ao DNA dela. Produzi dois vídeos nesse formato, com o mesmo tom, identidade e posicionamento do site.

Isso mostra como um contexto estratégico centralizado num único lugar vira um ativo reutilizável. Desenvolvimento web, produção audiovisual, tanto faz: a consistência de marca se mantém em todos os pontos de contato porque a referência é sempre a mesma.

Cada entrega partiu das mesmas referências. Isso garante consistência entre os pontos de contato sem retrabalho, e é o tipo de ativo que qualquer empresa pode construir, seja num Notion, num documento de marca ou em qualquer repositório acessível.

O próximo passo que estou estudando é levar essa mesma lógica pro código: com a identidade visual e as regras da marca já documentadas, dá pra construir um design system de componentes que traduz esse contexto em botões, cards e tipografia reutilizáveis. Aí a consistência deixa de depender de eu lembrar da regra a cada tela e passa a estar embutida na própria base do projeto, que é o que vai me permitir evoluir o projeto sem retrabalhar o visual do zero toda vez. Ainda não cheguei lá, é aprendizado em curso, mas o contexto estruturado é justamente o que torna esse caminho viável.

O que continua sendo decisão humana

A IA foi parceira de reflexão e de execução, mas todas as decisões foram minhas. Estratégia de arquitetura, escolha da stack, estrutura das páginas, hierarquia do conteúdo, o que manter do site anterior e o que descartar: cada uma dessas definições passou por análise minha antes de virar código. O lado técnico dessas escolhas, WordPress headless com Nuxt, composables e convenção de campos, eu contei em detalhe no artigo sobre a construção desse mesmo site.

O conteúdo do site também não foi presumido nem gerado do nada. Foi levantado em reuniões reais com a cliente, onde discutimos o que ela já tinha, o que queria preservar, o que precisava mudar e quais eram as expectativas dela pro novo site. Questões técnicas e decisões de escopo foram tratadas direto nessas conversas. Esse material, documentado, virou contexto pro Claude Code, e acelerou a execução sem abrir mão da qualidade ou do alinhamento com a realidade do projeto.

O modelo que ficou, no fim:

• Reuniões com a cliente pra levantar contexto
• Decisões técnicas e estratégicas tomadas por mim
• IA como ferramenta de execução rápida sobre esse contexto

Conclusão

O aprendizado que fica do projeto é direto: quanto mais claro e estruturado o contexto de marca, melhor e mais preciso o que a IA devolve. Posicionamento articulado, propósito documentado e tom de voz definido foram o que separou entrega genérica de entrega no alvo, e isso valeu igual pro site, pros vídeos e pro conteúdo.

Por isso vejo esse contexto menos como documento de marca e mais como ativo estratégico. Quem investe em defini-lo bem uma vez multiplica a qualidade e a velocidade de tudo que passa a usar IA depois. A ferramenta acelera, mas quem dá direção é o contexto que você tem pra colocar na frente dela.

Leituras relacionadas

• WordPress Headless com Nuxt: quando faz sentido e como estruturar
• O Papel da IA no Frontend: ameaça ou multiplicador de habilidade?
• Prêmio Nuvini AI 2026: o que dois dias na Oracle confirmaram
• Claude Code em Ação: do Prompt ao Código