Desenvolvedor de Python põe limites no Claude Code: configuração antirregressão em acesso aberto

Um desenvolvedor da CREATMAN passou várias semanas estudando documentação, discussões no Reddit e setups alheios para montar uma configuração do Claude Code com proteção real contra regressões. O resultado é um repositório aberto com arquivos prontos para uso imediato.

Um Problema que Todos Conhecem

Claude Code funciona com potência, mas sem a configuração adequada atua de forma muito independente. Um cenário típico para um desenvolvedor solo:

• Pediu para adicionar autenticação — o agente reescreveu metade do projeto
• Pediu para consertar uma função — recebeu testes deletados e uma dependência não solicitada
• Montou um protótipo funcional em uma hora — passou três horas limpando as "melhorias" do agente

Para quem trabalha sozinho, isso é duplamente crítico. Não há um engenheiro de QA para pegar regressões após cada prompt. Não há revisor para notar testes deletados. Cada correção não planejada é tempo gasto analisando soluções alheias em vez de trabalhar no produto. O autor dirige a CREATMAN sem time e enfrentou exatamente isso: IA ajuda a construir rápido, mas sem controle cria problemas novos da mesma forma.

Do Que a Configuração é Feita

Após várias semanas de leitura de documentação, discussões em fóruns e análise de outros setups, o autor identificou cinco componentes-chave. Todos estão reunidos no repositório claude-code-antiregression-setup e prontos para uso:

• CLAUDE.md — o arquivo-contrato principal: escopo da tarefa, proibições explícitas sobre soluções independentes, requisitos para descrever mudanças futuras antes de executá-las
• Regras de diretórios — restrições em nível de pasta para o agente não mexer no que não foi explicitamente solicitado
• Checklist obrigatório — antes de qualquer mudança, o agente descreve o plano e o desenvolvedor confirma ou rejeita
• Hooks — scripts automáticos que rodam após cada ação do agente e verificam conformidade com a tarefa
• Modelos de prompts — formatos prontos de requisições que eliminam ambiguidade e reduzem o espaço para interpretação

O importante é que tudo está documentado. O repositório é feito não para estudo, mas para implantação rápida: clone, adapte ao seu projeto, use.

Por Que Contrato Funciona Melhor que Restrição

A ideia-chave é dar ao agente regras claras, não apenas limitá-lo. Claude Code lê CLAUDE.md no início de cada sessão. Se ali está explicitamente escrito "não mexe em testes sem solicitação", "mudanças apenas dentro de arquivos especificados" ou "avise antes de adicionar dependência" — o agente segue isso.

"Preciso que o agente IA me ajude a construir mais rápido, não que

crie novos problemas", explica o autor.

Hooks adicionam um segundo nível. Pequenos scripts rodam após mudanças e verificam se o agente saiu dos limites. Se saiu — mudanças são marcadas para revisão em vez de entrar silenciosamente no codebase.

Modelos de prompts resolvem outro problema. Uma solicitação vaga dá ao agente espaço demais para interpretação — e é aí que começa a ação independente. Formatos prontos com escopo explícito, arquivos e resultado esperado reduzem drasticamente esse espaço.

CLAUDE.md não é apenas um README para o agente, mas um documento vivo do projeto. Nele são fixadas decisões arquiteturais, módulos críticos, convenções de nomeação. O agente usa este arquivo como contexto em cada requisição — e isso torna seu entendimento do projeto mais concreto e "melhorias" aleatórias menos prováveis.

A configuração não é amarrada a uma stack específica. O autor trabalha com backend Python, mas os princípios se aplicam a qualquer projeto onde você precise manter o agente dentro dos limites da tarefa dada.

O Que Isso Significa

Imprevisibilidade é uma das principais barreiras para adotar agentes IA em desenvolvimento solo. Configs abertas como essa reduzem a barreira de entrada: você pega a estrutura, adapta ao seu projeto e consegue uma ferramenta gerenciável em vez de um assistente caótico. Quanto mais desses setups aparecerem em acesso aberto, mais prático fica usar agentes IA sem time de suporte.