ClaudeForge: Deja de Copiar y Pegar tu CLAUDE.md (Existe una Mejor Manera)

Claude Code
, , , ,
1

ClaudeForge: Deja de Copiar y Pegar tu CLAUDE.md (Existe una Mejor Manera)

Por Devy · yoDEV.dev

Si ya estás usando Claude Code en tus proyectos, probablemente conoces el ritual: abres un proyecto nuevo, copias el CLAUDE.md del proyecto anterior, lo editas durante media hora para adaptarlo al nuevo stack, y aún así terminas repitiendo las mismas instrucciones a Claude sesión tras sesión.

Hay una herramienta open source que resuelve exactamente esto. Se llama ClaudeForge.

¿Qué es CLAUDE.md y por qué importa?

Antes de hablar de ClaudeForge, un contexto rápido: el archivo CLAUDE.md es el archivo de instrucciones persistente que Claude Code lee al inicio de cada sesión. Le dice cómo trabajar en tu proyecto específico: qué stack usas, tus convenciones de código, qué herramientas tienes disponibles, cómo correr los tests, etc.

Un buen CLAUDE.md hace que Claude Code sea significativamente más útil. Un CLAUDE.md desactualizado o mal estructurado, en cambio, confunde al modelo o simplemente es ignorado.

El problema más común: los archivos crecen sin control (algunos desarrolladores terminan con 600+ líneas), se vuelven difíciles de mantener, y no reflejan los cambios reales del proyecto con el tiempo.

Qué es ClaudeForge

ClaudeForge es un toolkit open source, con licencia MIT, creado por Alireza Rezvani (CTO de una startup HealthTech en Berlín). Su propósito es automatizar la creación, análisis y mantenimiento de archivos CLAUDE.md.

No es un simple generador de templates. Son tres componentes integrados:

1. Skill: claudeforge-skill

El núcleo inteligente. Analiza tu repositorio, puntúa tu CLAUDE.md actual de 0 a 100, identifica secciones faltantes y genera archivos optimizados adaptados a tu stack tecnológico real.

2. Slash Command: /enhance-claude-md

La interfaz interactiva. Simplemente ejecutas este comando dentro de Claude Code y el sistema hace el resto: explora tu proyecto, detecta el contexto, y te muestra lo que encontró antes de hacer cualquier cambio.

3. Guardian Agent: claude-md-guardian

El componente más interesante. Es un agente en segundo plano que detecta cambios en tu codebase (nuevas dependencias, nuevos directorios, nuevas variables de entorno) y actualiza el CLAUDE.md automáticamente. Usa el modelo Haiku por eficiencia, así que no consume contexto innecesariamente.

Cómo funciona en la práctica

Cuando ejecutas /enhance-claude-md en un proyecto nuevo, ClaudeForge explora tu repositorio y te presenta un resumen antes de tocar 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?"

Si ya tienes un CLAUDE.md, el análisis luce así:

"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?"

La puntuación de calidad evalúa cinco dimensiones: longitud apropiada, completitud de secciones, calidad del formato, especificidad del contenido, y organización modular.

Arquitectura modular: el concepto más útil

Una de las ideas más valiosas de ClaudeForge es la estructura jerárquica de archivos:

  • CLAUDE.md raíz (50–100 líneas): Actúa como índice de navegación con principios universales del proyecto
  • backend/CLAUDE.md (~150 líneas): Guías específicas de la API
  • frontend/CLAUDE.md (~175 líneas): Patrones de componentes, estado, performance
  • database/CLAUDE.md: Convenciones de migraciones, queries, índices

¿Por qué importa esto? Cuando Claude Code trabaja en el directorio frontend/, carga las guías de frontend. Cuando está en backend/, carga las de backend. El modelo no procesa instrucciones irrelevantes, lo que mejora la precisión de las respuestas.

Instalación: 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

Después de instalar, reinicia Claude Code y ejecuta:

/enhance-claude-md

Listo. El comando te guía desde ahí.

Requisitos: Claude Code 2.0 o superior, Git recomendado, compatible con macOS, Linux y Windows.

¿Vale la pena probarlo?

ClaudeForge está en v1.0.0 estable, tiene licencia MIT, y ya aparece en las listas curadas de herramientas para Claude Code de la comunidad. Siendo honesto, es un proyecto relativamente nuevo (17 commits al momento de este artículo), así que algunas promesas como la reducción de uso de contexto no tienen benchmarks publicados todavía.

Dicho eso, el problema que resuelve es real. Si usas Claude Code regularmente, mantener un CLAUDE.md útil y actualizado es trabajo real. Tener un agente que lo sincronice automáticamente con los cambios de tu proyecto es genuinamente útil.

Para proyectos en fase activa de desarrollo, el Guardian Agent solo ya justifica la instalación.

Repositorio

github.com/alirezarezvani/ClaudeForge

MIT License · Contribuciones bienvenidas

¿Ya usas Claude Code en tus proyectos? ¿Cómo estructuras tu CLAUDE.md hoy? Comparte en los comentarios.