/claude-md-improver · Diccionario de comandos

Descripción

¿Qué hace? /claude-md-improver escanea todos los archivos CLAUDE.md del proyecto (raíz, overrides locales, específicos de paquete), evalúa cada uno con una rúbrica de calidad y genera un informe detallado con notas A-F por criterio antes de aplicar ningún cambio.

Los criterios de evaluación incluyen: comandos documentados, claridad de arquitectura, patrones no obvios, concisión y actualidad. Solo aplica cambios con tu aprobación explícita, mostrando diffs de lo que propone modificar.

Prompt listo para usar

Copia y pega directamente en Claude Code para obtener mejores resultados con este comando:

/claude-md-improver Actualiza el CLAUDE.md de este proyecto con las mejores prácticas actuales de Claude Code.
Objetivo: dejarlo corto, útil y accionable.

Haz lo siguiente:
1. Revisa el proyecto antes de editar nada.
2. Detecta stack, estructura, comandos habituales, convenciones y restricciones reales del repo.
3. Elimina instrucciones obsoletas, duplicadas, vagas o que no estén respaldadas por el código actual.
4. Conserva solo reglas que ayuden a Claude a trabajar mejor en este proyecto.
5. Organiza el archivo en secciones breves: propósito, stack, estructura, flujo de trabajo, normas de edición y criterios de validación.
6. Si alguna mejora debería ir mejor en archivos separados, propón moverla a `.claude/rules/` o `AGENTS.md`.
7. Mantén el resultado por debajo de 120 líneas, idealmente bastante menos.
8. Devuélveme:
   - el nuevo contenido completo de `CLAUDE.md`
   - un resumen corto de qué cambió
   - las reglas eliminadas y por qué
   - las dudas o huecos que no pudiste confirmar en el repositorio

No inventes tecnologías, comandos ni procesos que no existan en este proyecto.
Prioriza instrucciones específicas y verificables frente a consejos genéricos.

Ejemplos de uso

Auditar el CLAUDE.md del proyecto

Tu proyecto ha crecido mucho desde que escribiste el CLAUDE.md inicial. Con /claude-md-improver obtienes un informe con puntuaciones por criterio ("Comandos documentados: B", "Arquitectura: D", etc.) y sugerencias concretas de qué añadir o actualizar. Tú decides qué cambios aplicas.

/claude-md-improver

Mejorar CLAUDE.md tras incorporar nuevo dev

Cuando un nuevo desarrollador llega al equipo, el CLAUDE.md debería explicarle todo lo que necesita saber sin que nadie se lo cuente. /claude-md-improver identifica los huecos: patrones que el equipo da por supuestos pero no están documentados, comandos específicos del proyecto que faltan, gotchas que solo conocen los veteranos.

/claude-md-improver

Cuándo usarlo

Por qué funciona mejor así

Claude Code rinde mejor cuando el CLAUDE.md es breve, específico y basado en contexto real del repositorio — no en reglas genéricas tipo «haz código limpio». Varios estudios de uso real recomiendan separar reglas estables o temáticas en archivos modulares como .claude/rules/ y mantener el CLAUDE.md principal enfocado y corto.

Recomendación práctica antes de lanzar el prompt

Muchas buenas prácticas actuales favorecen el flujo «planificar primero, ejecutar después» en tareas algo complejas. Por eso conviene pedir primero solo análisis:

«Analiza este proyecto y dime qué partes del CLAUDE.md están desactualizadas, cuáles faltan y qué estructura propones antes de reescribirlo.»

Una vez aprobado el análisis, entonces lanzar el prompt completo de arriba.

Casos típicos de uso

1. Crear tu primer CLAUDE.md
Tienes un repo nuevo y quieres que Claude siga ciertas reglas (stack, estilo, «no hagas X», formato de salida) pero no sabes cómo estructurar el archivo. Le pasas un borrador caótico con tus notas y /claude-md-improver lo convierte en un archivo corto, claro y accionable.
Prompt de ejemplo: /claude-md-improver Este es mi borrador de CLAUDE.md para este repo React + Node. Condénsalo a menos de 40 líneas con secciones claras para stack, prohibiciones y contrato de salida.

2. Podar un CLAUDE.md gigantesco
Llevas meses añadiendo cosas y ya tienes 200+ líneas que mezclan documentación, changelog, TODOs y reglas. Usas /claude-md-improver para que elimine el ruido y deje solo decisiones, restricciones y contratos de calidad.
Prompt de ejemplo: /claude-md-improver Este CLAUDE.md es demasiado largo. Elimina diario, wiki y TODOs; deja solo reglas que cambian el comportamiento de Claude Code. Máx. 50 líneas.

3. Adaptar un CLAUDE.md a diferentes niveles
Tienes un CLAUDE.md global y quieres derivar versiones específicas para un repo o submódulo (por ejemplo, front vs backend).
Prompt de ejemplo: /claude-md-improver Parte este archivo en: 1) reglas personales, 2) reglas del proyecto, 3) reglas solo para /frontend. Devuélveme tres bloques separados.

4. Hacer «linting» de tus reglas
Tu CLAUDE.md se contradice (en una parte dice «usa Remix» y en otra «no uses Remix») o tiene reglas vagas tipo «haz buen código».
Prompt de ejemplo: /claude-md-improver Detecta reglas contradictorias y reescríbelas en formato «cuando pase X, haz Y», eliminando generalidades y duplicados.

5. Ajustar el «contrato de salida» para contenido
Usas Claude Code para generar posts, docs o mails y quieres que siempre respete estructura, tono y restricciones (por ejemplo, sin mencionar competidores ni precios).
Prompt de ejemplo: /claude-md-improver Reescribe la sección de «Output Contract» para que todo el contenido: 1) no mencione competidores, 2) no incluya precios, 3) use humor ligero cuando sea apropiado.

Comandos relacionados

Si /claude-md-improver te resulta útil, estos comandos juegan en el mismo equipo: