ClaudeForge: Pare de Copiar e Colar seu CLAUDE.md (Existe uma Maneira Melhor)

Claude Code
, , , ,
1

ClaudeForge: Pare de Copiar e Colar seu CLAUDE.md (Existe uma Forma Melhor)

Por Devy · yoDEV.dev

Se você já está usando Claude Code em seus projetos, provavelmente conhece o ritual: abre um projeto novo, copia o CLAUDE.md do projeto anterior, edita durante meia hora para adaptá-lo ao novo stack, e mesmo assim termina repetindo as mesmas instruções a Claude sessão após sessão.

Existe uma ferramenta open source que resolve exatamente isso. Chama-se ClaudeForge.

O que é CLAUDE.md e por que importa?

Antes de falar sobre ClaudeForge, um contexto rápido: o arquivo CLAUDE.md é o arquivo de instruções persistente que Claude Code lê no início de cada sessão. Ele diz como trabalhar no seu projeto específico: qual stack você usa, suas convenções de código, quais ferramentas tem disponíveis, como rodar os testes, etc.

Um bom CLAUDE.md torna Claude Code significativamente mais útil. Um CLAUDE.md desatualizado ou mal estruturado, por outro lado, confunde o modelo ou simplesmente é ignorado.

O problema mais comum: os arquivos crescem sem controle (alguns desenvolvedores terminam com 600+ linhas), ficam difíceis de manter, e não refletem as mudanças reais do projeto ao longo do tempo.

O que é ClaudeForge

ClaudeForge é um toolkit open source, com licença MIT, criado por Alireza Rezvani (CTO de uma startup HealthTech em Berlim). Seu propósito é automatizar a criação, análise e manutenção de arquivos CLAUDE.md.

Não é um simples gerador de templates. São três componentes integrados:

1. Skill: claudeforge-skill

O núcleo inteligente. Analisa seu repositório, pontua seu CLAUDE.md atual de 0 a 100, identifica seções faltantes e gera arquivos otimizados adaptados ao seu stack tecnológico real.

2. Slash Command: /enhance-claude-md

A interface interativa. Você simplesmente executa este comando dentro de Claude Code e o sistema faz o resto: explora seu projeto, detecta o contexto, e mostra o que encontrou antes de fazer qualquer mudança.

3. Guardian Agent: claude-md-guardian

O componente mais interessante. É um agente em segundo plano que detecta mudanças em sua base de código (novas dependências, novos diretórios, novas variáveis de ambiente) e atualiza o CLAUDE.md automaticamente. Usa o modelo Haiku por eficiência, então não consome contexto desnecessariamente.

Como funciona na prática

Quando você executa /enhance-claude-md em um projeto novo, ClaudeForge explora seu repositório e apresenta um resumo antes de tocar em nada:

"Based on my exploration, here's what I discovered:

  📦 Project Type: Full-Stack Application
  🛠️ Tech Stack: TypeScript, React, Node.js, PostgreSQL, Docker
  👥 Team Size: Small (5 developers)
  🚀 Development Phase: MVP

  📋 Recommended Structure:
  - Root CLAUDE.md (navigation hub, ~100 lines)
  - backend/CLAUDE.md (API guidelines, ~150 lines)
  - frontend/CLAUDE.md (React guidelines, ~175 lines)

  Would you like me to create these files?"

Se você já tem um CLAUDE.md, a análise fica assim:

"Quality Score: 65/100

  Missing Sections:
  - Project Structure (ASCII diagram)
  - Setup & Installation
  - Architecture

  Would you like me to enhance your CLAUDE.md with these sections?"

A pontuação de qualidade avalia cinco dimensões: comprimento apropriado, completude de seções, qualidade da formatação, especificidade do conteúdo, e organização modular.

Arquitetura modular: o conceito mais útil

Uma das ideias mais valiosas do ClaudeForge é a estrutura hierárquica de arquivos:

  • CLAUDE.md raiz (50–100 linhas): Atua como índice de navegação com princípios universais do projeto
  • backend/CLAUDE.md (~150 linhas): Guias específicas da API
  • frontend/CLAUDE.md (~175 linhas): Padrões de componentes, estado, performance
  • database/CLAUDE.md: Convenções de migrações, queries, índices

Por que isso importa? Quando Claude Code trabalha no diretório frontend/, carrega as guias de frontend. Quando está em backend/, carrega as de backend. O modelo não processa instruções irrelevantes, o que melhora a precisão das respostas.

Instalação: menos de 5 minutos

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bash

Windows (PowerShell):

iwr https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.ps1 -useb | iex

Depois de instalar, reinicie Claude Code e execute:

/enhance-claude-md

Pronto. O comando o guia a partir daí.

Requisitos: Claude Code 2.0 ou superior, Git recomendado, compatível com macOS, Linux e Windows.

Vale a pena tentar?

ClaudeForge está na v1.0.0 estável, tem licença MIT, e já aparece nas listas curadas de ferramentas para Claude Code da comunidade. Sendo honesto, é um projeto relativamente novo (17 commits no momento deste artigo), então algumas promessas como a redução de uso de contexto não têm benchmarks publicados ainda.

Dito isso, o problema que resolve é real. Se você usa Claude Code regularmente, manter um CLAUDE.md útil e atualizado é trabalho real. Ter um agente que o sincronize automaticamente com as mudanças do seu projeto é genuinamente útil.

Para projetos em fase ativa de desenvolvimento, o Guardian Agent sozinho já justifica a instalação.

Repositório

github.com/alirezarezvani/ClaudeForge

MIT License · Contribuições bem-vindas

Você já usa Claude Code em seus projetos? Como estrutura seu CLAUDE.md hoje? Compartilhe nos comentários.