claude-md-writer

Escribe y optimiza CLAUDE.md siguiendo las mejores prácticas oficiales de Anthropic.

Triggers

Frases que activan el skill
“crear CLAUDE.md”
“mejorar CLAUDE.md”
“actualizar CLAUDE.md”
“revisar CLAUDE.md”
“escribir instrucciones del proyecto”
“optimizar documentación para Claude”

Golden Rule

Para cada línea en CLAUDE.md, preguntá:

“¿Eliminar esto causaría que Claude cometa errores?”

Si no, eliminalo. CLAUDE.md inflados causan que Claude ignore instrucciones.

Modos de uso

Invocación Comportamiento
/claude-md-writer Proceso completo: analizar proyecto → escribir/mejorar
actualiza con la sesión Extraer info de la sesión actual y agregar
agrega regla: [descripción] Agregar una regla específica
revisa y optimiza Auditar, eliminar redundancias, mejorar énfasis
convierte a skill Identificar contenido que debería ser skill

Las tres dimensiones

Todo CLAUDE.md debe cubrir:

Dimensión Pregunta a responder
WHAT ¿Qué es este proyecto? ¿Tech stack? ¿Estructura?
WHY ¿Por qué existe? ¿Qué problema resuelve?
HOW ¿Cómo trabajo en él? ¿Comandos? ¿Workflows?

Qué incluir vs excluir

✅ Incluir ❌ Excluir
Comandos bash que Claude no puede adivinar Lo que Claude puede deducir leyendo código
Reglas de estilo que difieren de defaults Convenciones estándar del lenguaje
Testing instructions API docs detallados (linkear)
Etiqueta del repo (branch naming, PR) Info que cambia frecuentemente
Decisiones arquitectónicas del proyecto Explicaciones largas o tutoriales
Quirks del entorno (env vars) Descripciones file-by-file

Énfasis para reglas críticas 

## Key Development Rules

- **CRITICAL**: NUNCA commitear secrets o API keys
- **IMPORTANT**: Siempre correr tests antes de push
- **YOU MUST**: Seguir el PR template al crear PRs
Keyword Uso
**CRITICAL** Nunca debe violarse
**IMPORTANT** Siempre debe seguirse
**YOU MUST** Acción mandatoria

CLAUDE.md vs Skills

CLAUDE.md Skills
Se carga siempre Se carga on-demand
Reglas universales Domain knowledge específico
< 200 líneas Sin límite práctico
Code style, workflows Workflows especializados

Regla práctica: Si la información solo aplica a ciertos tipos de tareas (“cuando trabajes con X…”, “para tareas de Y…”), probablemente debería ser un skill.

Template recomendado 

# CLAUDE.md

This file provides guidance to Claude Code.

## Repository Overview

[Un párrafo: qué es, tech stack, propósito principal]

## Why This Exists

[Qué problema resuelve, quién lo usa]

## Quick Start & Commands

```bash
npm ci        # Install dependencies
npm start     # Dev server
npm run build # Production build
npm test      # Run tests

Note: [Setup notes importantes]

Architecture Overview

[Patrones clave, estructura de carpetas, conceptos principales]

Key Development Rules

  • CRITICAL: [Regla más importante]
  • IMPORTANT: [Segunda más importante]
  • Otras reglas…

References

  • /docs/ - Documentación detallada
  • README.md - Project readme ```

Anti-patterns

Anti-Pattern Problema Solución
Kitchen sink Muchas instrucciones diluyen efectividad Mantener < 200 líneas
Code snippets Se vuelven obsoletos Usar file:line references
Styling rules LLM es lento para tareas determinísticas Usar linters
No emphasis Reglas críticas tienen mismo peso que menores Usar CRITICAL/IMPORTANT
Domain knowledge Infla cada sesión Mover a skills

Checklist de verificación

  • ¿Menos de 200 líneas?
  • ¿Pasa la Golden Rule? (cada línea previene errores)
  • ¿Tiene secciones WHAT, WHY, HOW?
  • ¿Reglas críticas tienen énfasis?
  • ¿Code snippets reemplazados por file references?
  • ¿Comandos bash tienen descripciones?
  • ¿Contenido específico movido a skills?

Herramientas disponibles

  • Read - Leer CLAUDE.md y proyecto
  • Glob - Buscar estructura
  • Grep - Buscar patrones
  • Write - Crear CLAUDE.md
  • Edit - Modificar CLAUDE.md