Estilo de Legado Herdado

Impede a deriva do estilo de código da IA em projetos legados, escaneando a base de código em busca de convenções implícitas em 4 dimensões de meta-arquitetura, resolvendo conflitos com o usuário um de cada vez e cristalizando o consenso em um .ai-style-rules.md aplicável. Totalmente agnóstico a linguagem e framework.

Quando Ativar

• O usuário digita /inherit-legacy-style
• O usuário menciona a integração de IA em um projeto legado escrito à mão
• O usuário está preocupado com o código gerado por IA "desviando" das convenções existentes do projeto
• O usuário deseja extrair e codificar as regras de codificação implícitas do seu projeto

Quando Usar

Use esta habilidade quando precisar preservar o estilo de projetos legados e evitar a deriva de estilo gerada por IA. Veja Quando Ativar acima para as condições de gatilho.

Pré-requisitos

• Git (recomendado; projetos não-Git recorrem a carimbos de data/hora de arquivos para o modo incremental)
• Acesso de Leitura/Escrita à raiz do projeto (gera .ai-style-rules.md e opcionalmente CLAUDE.md)

Fluxo de Trabalho

Passo 0 — Modo de Detecção Automática

Verifica silenciosamente a existência de .ai-style-rules.md na raiz do projeto:

Anuncia o modo em uma linha e prossegue — nunca peça ao usuário para escolher.

Ramificação A — Primeira Verificação Completa

1. Medir escala, escolher um nível de escaneamento

git ls-files | grep -cE '\.(js|ts|jsx|tsx|vue|py|go|rs|java|kt|rb|php|cs|swift|c|cpp|h)$'

2. Escanear ao longo de 4 dimensões

1. Anatomia do Arquivo — ordem de declaração dentro do arquivo (imports → tipos → lógica principal → auxiliares → exportação)
2. Estado e Fluxo de Controle — convenções de nomenclatura para estado assíncrono, paginação, flags
3. Infraestrutura — onde residem utilitários transversais (interceptadores, formatadores, middleware)
4. Tratamento de Erros — try/catch vs interceptador global vs retorno Result; hábitos de verificação de nulos

3. Aplicar redução de ruído por limiar de sinal

Antes de interromper o usuário, avalie a força do sinal:

• Sinal fraco → suprimir automaticamente: minoria <5% E contagem <10 → maioria vence, minoria vai para DONTs
• Sinal forte → interrogar: divisão quase igual, ou bifurcação semântica em uma dimensão central
• Exceção de projeto pequeno: fontes ≲50, "3 contra 2" NÃO é maioria → interrogar

4. Resolver conflitos um de cada vez (Protocolo de Interrogatório)

Para cada conflito de sinal forte, apresente exatamente UMA pergunta com 4 opções:

Evidência: pathA usa o estilo X, pathB usa o estilo Y AVISO: Risco: misturar ambos fratura o estilo do projeto Escolha: 1 seguir X 2 seguir Y 3 isso é evolução, atualizar regras 4 tenho uma nova regra

Suspender até que o usuário responda, depois prosseguir para o próximo conflito. Nunca empilhe perguntas.

5. Gerar .ai-style-rules.md com três seções obrigatórias:

• [Arquivos Dourados] — caminhos exemplares reais anotados com o que demonstram
• [Regras de Nomenclatura e Controle de Estado] — convenções concretas e verificáveis
• [NÃO FAZER] — antipadrões que não devem se propagar

6. Instalar o hook persistente

Pergunte ao usuário a força de aplicação (use AskUserQuestion):

Ramificação B — Verificação Incremental

1. Ler .ai-style-rules.md existente; se tiver uma impressão digital de commit, git diff <last_hash> HEAD --stat para identificar o delta
2. Ler alterações recentes do Git (git log -3 --stat → inspecionar arquivos suspeitos sob demanda)
3. Para diffs excessivamente grandes (>centenas de arquivos): --stat apenas resumo + amostrar as maiores alterações
4. Comparar novo código com regras registradas → conflitos passam pelo Protocolo de Interrogatório
5. Anexar log de evolução ao final de .ai-style-rules.md (nunca sobrescrever regras antigas)

Aplicação por Turno

Quando .ai-style-rules.md estiver em contexto (carregado via CLAUDE.md), cada tarefa de escrita de código deve começar com uma declaração de conformidade na cadeia de raciocínio, nomeando o exemplar seguido e os DONTs evitados.

Como Funciona

…