Seu Guia de Estilo É uma Camada de Governança

Algo curioso está acontecendo nas equipes de conteúdo. Redatores UX e designers de conteúdo estão codificando seus guias de estilo em arquivos CLAUDE.md para que o Claude Code siga automaticamente a voz da marca, regras de terminologia e padrões de escrita. Yuval Keshtcher documentou esse fluxo em detalhe --- usando o CLAUDE.md como fonte única de verdade para padrões de conteúdo, executando auditorias em lote e gerando relatórios de consistência.

É um tutorial prático. Funciona. E revela, sem querer, algo muito maior que um truque de produtividade.

Quando uma equipe de conteúdo codifica regras de estilo em um arquivo CLAUDE.md, ela não está configurando uma ferramenta. Está escrevendo governança como código. A distinção importa, porque as implicações vão muito além de operações de conteúdo.

A Descoberta Acidental

Um guia de estilo em PDF é uma sugestão. Um guia de estilo codificado no CLAUDE.md é uma restrição. A diferença é a aplicação.

Quando regras de marca existem como documento, o cumprimento depende de alguém ler o documento, lembrar das regras e escolher segui-las. Quando essas mesmas regras existem como instruções legíveis por máquina no CLAUDE.md, toda ação assistida por IA é filtrada automaticamente. O agente não esquece as regras. Não decide que elas não se aplicam a esta situação específica. Não desvia gradualmente do padrão porque ninguém o lembrou.

Essa é a definição de uma camada de governança: um conjunto de restrições aplicadas de forma consistente, automática e sem intervenção humana no ponto de execução.

No Brasil, esse padrão é especialmente relevante. Equipes brasileiras adotam ferramentas novas rapidamente --- a taxa de adoção de IA generativa no país está entre as mais altas do mundo. Mas a formalização da governança tipicamente acontece depois. A ferramenta entra na segunda-feira; a política sobre como usá-la chega, com sorte, no trimestre seguinte.

O CLAUDE.md inverte essa dinâmica. A governança é embutida na ferramenta desde o primeiro uso.

Por Que Conteúdo Enxerga Primeiro

Quatro propriedades fazem operações de conteúdo o indicador antecipado da adoção de governança como código.

Visibilidade imediata. Inconsistências de conteúdo são voltadas para o cliente. Um parâmetro de API errado pode se esconder na documentação por meses. Uma voz de marca errada em uma notificação do produto é sinalizada no mesmo dia.

Stakeholders não técnicos. Líderes de marketing, gestores de marca e executivos se importam com qualidade de conteúdo. Eles criam pressão por consistência que equipes de engenharia --- cujas inconsistências são invisíveis para não engenheiros --- raramente enfrentam.

Codificação pré-existente. Guias de estilo já existiam. Equipes de conteúdo já tinham feito o trabalho difícil de definir regras, terminologia aprovada, diretrizes de voz e padrões de formatação. Apenas não tinham tornado essas regras legíveis por máquina.

Ciclos de feedback rápidos. Auditorias de conteúdo são rápidas. Você verifica se o texto gerado por IA segue o guia de estilo em minutos. Auditorias de governança de infraestrutura levam semanas.

O resultado: operações de conteúdo é o canário na mina de carvão para lacunas de governança. Se o CLAUDE.md da sua equipe de conteúdo é o artefato de governança mais maduro da sua organização, isso diz algo sobre o quanto os outros domínios estão atrasados.

A Arquitetura que Ninguém Desenhou

Arquivos CLAUDE.md têm uma hierarquia natural. Um arquivo global em ~/.claude/CLAUDE.md se aplica em todo lugar. Um arquivo no nível do projeto se aplica a um codebase específico. Um arquivo local se aplica às preferências de um desenvolvedor individual.

Essa hierarquia não é acidente. Ela espelha a hierarquia de autoridade em qualquer organização: políticas da empresa, padrões da equipe, preferências individuais. É a mesma estrutura que a Anthropic usa na constituição do Claude --- restrições de segurança fixas no topo, comportamento customizável pelo operador no meio, preferências do usuário na base.

O paralelo é arquitetural, não metafórico.

No contexto brasileiro, essa hierarquia ganha uma camada extra de relevância. A LGPD exige que organizações demonstrem controle sobre como dados pessoais são processados. Um arquivo CLAUDE.md no nível da empresa que define regras de tratamento de dados não é apenas boa prática de engenharia --- é evidência documentada de controle, versionada no git, auditável.

Ninguém projetou essa arquitetura de governança. Ela emergiu porque a hierarquia de arquivos do CLAUDE.md mapeia naturalmente a autoridade organizacional. Mas o fato de não ter sido projetada significa que também não é gerenciada. A arquitetura existe. A governança sobre a governança, não.

Além do Conteúdo

O padrão que equipes de conteúdo descobriram se generaliza para todo domínio onde agentes de IA operam.

Padrões de revisão de código. Equipes que querem revisão consistente de código por assistentes de IA codificam seus padrões no CLAUDE.md. Convenções de nomenclatura, padrões arquiteturais, anti-padrões proibidos --- são regras de governança expressas como código.

Diretrizes de design de API. Convenções REST, formatos de resposta de erro, políticas de versionamento. Quando codificadas no CLAUDE.md, tornam-se restrições aplicáveis em vez de páginas wiki que desenvolvedores podem ou não ter lido.

Políticas de tratamento de dados. O que pode ser registrado em log, o que deve ser redigido, como dados pessoais são tratados. Esses são requisitos de conformidade que, quando expressos no CLAUDE.md, são aplicados no ponto de geração de código em vez de detectados na revisão.

Padrões de segurança. Padrões de autenticação, requisitos de validação de entrada, políticas de dependência. Mesmo princípio: codifique o padrão, aplique automaticamente.

O fio comum: todo domínio que tem padrões escritos pode codificar esses padrões em arquivos CLAUDE.md. No momento em que fazem isso, esses padrões se tornam governança como código --- automaticamente aplicados, versionados, auditáveis.

Compare com o ecossistema existente. Open Policy Agent aplica políticas de autorização. Terraform aplica estado de infraestrutura. Sentinel aplica regras de conformidade. CLAUDE.md aplica restrições comportamentais em agentes de IA. É o mesmo conceito aplicado a uma superfície de aplicação diferente --- e possivelmente a de menor fricção disponível, porque não requer infraestrutura, pipeline de deploy, nem ferramentas especializadas. Você escreve um arquivo markdown.

A Pergunta que Ninguém Faz

Aqui é onde equipes de produto precisam prestar atenção.

Agora, arquivos CLAUDE.md são de quem os cria. Na maioria das organizações, isso significa desenvolvedores individuais ou equipes pequenas. Não há propriedade formal, processo de revisão, gestão de mudanças.

Isso é equivalente a cada desenvolvedor escrever sua própria política de segurança.

Quando arquivos CLAUDE.md eram apenas conveniência de desenvolvedor --- “use tabs em vez de espaços,” “rode testes antes de commitar” --- propriedade informal era suficiente. Mas no momento em que esses arquivos contêm regras de governança que afetam consistência de marca, qualidade de código, tratamento de dados ou segurança, propriedade informal se torna um passivo.

Equipes de produto precisam atribuir propriedade explícita em três dimensões.

Governança técnica pertence a líderes de engenharia. Padrões de código, padrões arquiteturais, requisitos de CI/CD. Essas regras afetam como o software é construído.

Governança de marca e conteúdo pertence a líderes de design e conteúdo. Diretrizes de voz, terminologia, padrões de acessibilidade, padrões de UX. Essas regras afetam como produtos são experimentados.

Governança de escopo pertence a gerentes de produto. O que o agente de IA pode e não pode fazer autonomamente, o que requer revisão humana, o que está fora do escopo. Essas regras afetam o que é construído.

A atribuição não precisa ser complexa. Precisa ser explícita. Alguém precisa conseguir responder: “Quem aprovou essa mudança no CLAUDE.md, e essa pessoa tinha autoridade para fazê-la?”

Não é um problema futuro. Está acontecendo agora. Toda organização usando Claude Code já tem arquivos CLAUDE.md que contêm regras de governança. A questão é se essas regras foram escritas deliberadamente por alguém com autoridade apropriada, ou se acumularam organicamente sem ninguém pensar a respeito.

Equipes de conteúdo descobriram isso primeiro porque inconsistência de marca é visível e dolorosa. O mesmo ajuste de contas está chegando para todos os outros domínios.

Fontes

Yuval Keshtcher. “How to Use Claude Code for UX Writing.” UX Writing Hub, 2 de fevereiro de 2026.
Anthropic. “Claude’s Constitution.” anthropic.com, janeiro de 2026.
Open Policy Agent. “Introduction to OPA.” openpolicyagent.org, 2025.
HashiCorp. “Sentinel: Policy as Code.” hashicorp.com, 2025.

O Victorino Group ajuda equipes de produto a projetar as camadas de governança que agentes de IA precisam para operar dentro de limites definidos. Se sua organização está usando assistentes de IA para codificar e ninguém é dono dos arquivos CLAUDE.md, vamos resolver isso.