Curso – Claude
EN

nombre: claude-md descripción: Crear o actualizar archivos CLAUDE.md siguiendo las mejores prácticas para el agente de IA óptimo a bordo

Entrada del usuario

$ARGUMENTS

Tú Debe considerar la entrada del usuario antes de proceder (si no está vacía). El usuario puede especificar: - create - Crear un nuevo CLAUDE.md desde cero - update - Mejorar el CLAUDE.md existente audit - Analizar e informar sobre la calidad actual de CLAUDE.md - Una ruta específica para crear/actualizar (por ejemplo, src/api/CLAUDE.md para instrucciones específicas del directorio)

Principios básicos

Los LLM son apátridas: CLAUDE.md es el archivo principal del proyecto cargado en cada conversación (al lado de la memoria automática y las reglas sin alcance). Sirve como el documento principal para los agentes de IA en su base de código.

Las reglas de oro

  1. Menos es Más: Frontier LLMs puede seguir instrucciones ~150-200. El sistema de Claude Code prompt ya utiliza ~50. Mantenga su CLAUDE.md enfocado y conciso.

  2. Aplicabilidad universal: Sólo incluya información relevante para CADA sesión. Las instrucciones específicas de cada tarea pertenecen a archivos separados.

  3. No uses a Claude como un Linter: Guías de estilo bloat context y degradar instrucción-seguimiento. Utilice herramientas deterministas (más bonito, eslint, etc.) en su lugar.

  4. Nunca generar automáticamente: CLAUDE.md es el punto de apalancamiento más alto del arnés de la IA.

Flujo de ejecución

1. Análisis de proyectos

Primero, analice el estado actual del proyecto:

  1. Comprobar si existen archivos CLAUDE.md:
  2. Nivel de la raíz: ./CLAUDE.md o .claude/CLAUDE.md
  3. Específico del directorio: **/CLAUDE.md

  4. Configuración de usuario global: ~/.claude/CLAUDE.md

  5. Identificar la estructura del proyecto:

  6. Apilador de tecnología (idiomas, marcos)
  7. Tipo de proyecto (monorepo, aplicación única, biblioteca)

  8. Herramientas de desarrollo (administrador de paquetes, sistema de construcción, corredor de pruebas)

  9. Revisar la documentación existente:

  10. README.md
  11. CONTRIBUTING.md
  12. paquete.json, pyproject.toml, Cargo.toml, etc.

2. Estrategia de contenido (QUÉ, POR QUÉ, CÓMO)

Estructura CLAUDE.md alrededor de tres dimensiones:

QUÉ - Tecnología y Estructura

  • Resumen de la pila de tecnología
  • Organización del proyecto (especialmente importante para los monorrepos)
  • Directorios clave y sus propósitos

POR QUÉ - Propósito y contexto

  • Lo que hace el proyecto
  • Por qué se tomaron ciertas decisiones arquitectónicas
  • ¿De qué es responsable cada uno de los componentes principales?

CÓMO - Flujo de trabajo y convenciones

  • Flujo de trabajo de desarrollo (bun vs nodo, pip vs uv, etc.)
  • Procedimientos y órdenes de ensayo
  • Métodos de verificación y construcción
  • Requisitos críticos de "gotchas" o no obvios

3. Estrategia de divulgación progresiva

Para proyectos más grandes, recomienda crear un agent_docs/ carpeta:

agent_docs/
  |- building_the_project.md
  |- running_tests.md
  |- code_conventions.md
  |- architecture_decisions.md

En CLAUDE.md, consulte estos archivos con instrucciones como:

For detailed build instructions, refer to `agent_docs/building_the_project.md`

Importante: Usar file:line referencias en lugar de fragmentos de código para evitar contextos obsoletos.

4. Limitaciones de la calidad

Al crear o actualizar CLAUDE.md:

  1. Longitud del objetivo: Mantenerlo bajo 200 líneas; más corto es mejor
  2. Sin reglas de estilo: Quitar cualquier instrucción de tinte / formateo
  3. No hay instrucciones específicas de la tarea: Mover a archivos separados
  4. Sin fragmentos de código: Usar referencias de archivos en su lugar
  5. No hay información redundante: No repita lo que hay en package.json o README

5. Secciones esenciales

Un CLAUDE.md bien estructurado debe incluir:

# Project Name

Brief one-line description.

## Tech Stack
- Primary language and version
- Key frameworks/libraries
- Database/storage (if any)

## Project Structure
[Only for monorepos or complex structures]
- `apps/` - Application entry points
- `packages/` - Shared libraries

## Development Commands
- Install: `command`
- Test: `command`
- Build: `command`

## Critical Conventions
[Only non-obvious, high-impact conventions]
- Convention 1 with brief explanation
- Convention 2 with brief explanation

## Known Issues / Gotchas
[Things that consistently trip up developers]
- Issue 1
- Issue 2

6. Anti-patrones para evitar

NO incluya: - Guías de estilo de código (usar linters) - Documentación sobre cómo usar Claude - Explicaciones largas de patrones obvios - Ejemplos de códigos pegados a copia - Buenas prácticas genéricas ("escribe código limpio") - Instrucciones para tareas específicas - Contenido generado automáticamente - Amplias listas TODO

7. Lista de verificación de validación

Antes de finalizar, verificar:

  • [ ] Mantenido bajo 200 líneas; más corto es mejor
  • [ ] Cada línea se aplica a TODAS las sesiones
  • [ ] No hay reglas de estilo/formateo
  • [ ] No hay fragmentos de código (utilizar referencias de archivos)
  • [ ] Las órdenes se verifican para funcionar
  • [ ] Divulgación progresiva utilizada para proyectos complejos
  • [ ] Las gotchas críticas están documentadas
  • [ ] No hay redundancia con README.md

Formato de salida

Por create o predeterminado:

  1. Analizar el proyecto
  2. Borra un CLAUDE.md siguiendo la estructura anterior
  3. Presentar el proyecto para su examen
  4. Escribir en el lugar apropiado después de la aprobación

Por update:

  1. Leer CLAUDE.md existente
  2. Auditoría de las mejores prácticas
  3. Identificar:
  4. Contenido a eliminar (reglas de estilo, fragmentos de código, tareas específicas)
  5. Contenido a condensar
  6. Falta información esencial
  7. Cambios actuales que deben examinarse
  8. Aplicar cambios después de la aprobación

Por audit:

  1. Leer CLAUDE.md existente
  2. Generar un informe con:
  3. Conteo de línea actual vs destino
  4. Porcentaje de contenido universalmente aplicable
  5. Lista de antipatrones encontrados
  6. Recomendaciones para mejorar
  7. NO modifique el archivo, sólo informe

Manejo de AGENTS.md

Si el usuario solicita creación/actualización de AGENTS.md:

Desde el v2.1.277, Claude Code dice AGENTS.md directamente como instrucciones del proyecto — pero sólo cuando el directorio de trabajo y todos los directorios anteriores contengan CLAUDE.md, .claude/CLAUDE.mdo bien CLAUDE.local.md. ~/.claude/CLAUDE.md, manejado CLAUDE.md, y .claude/rules/ no cuente para esa comprobación y siga cargando junto. ¿Qué archivos se leen es controlado por Instrucciones del proyecto en /config: claude-md-or-agents-md (por defecto), claude-md-and-agents-md, claude-mdo bien managed-only. Cuando la lectura directa no está disponible — versiones antes de v2.1.277 (antes de v2.1.281 en Bedrock/Vertex/Foundry, pasarelas LLM, o con telemetría desactivada), o la primera sesión después de la actualización — volver a importarlo de CLAUDE.md con @AGENTS.md, o enlace simbólico CLAUDE.md A ella.

AGENTS.md es un archivo de contexto de proyecto de herramientas cruzadas, el mismo Categoría de documento como CLAUDE.md, no un formato de definición de agente. Existe por lo que varios agentes de codificación pueden compartir un conjunto de convenciones de proyecto: - Comandos de construcción, prueba y pelusa - Estilo de código y convenciones arquitectónicas - Diseño de repositorio y donde viven las cosas

Los subagentes se definen por separado, en .claude/agents/*.md — no en AGENTS.md.

Aplicar principios similares: - Mantener enfocado y conciso - Usar divulgación progresiva - Referencia documentos externos en lugar de incrustar contenido

Notas

  • Verifique siempre el funcionamiento de los comandos antes de incluirlos
  • En caso de duda, déjelo fuera - menos es más
  • El recordatorio del sistema le dice a Claude que CLAUDE.md "puede o no ser relevante" - cuanto más ruido, más se ignora
  • Monorepos se beneficia más de la estructura clara QUÉ/QUÉ/CÓMO
  • Los archivos CLAUDE.md específicos para directorios deberían estar aún más enfocados

Última actualización: 18 de octubre de 2026 Versión de Claude Code: 2.1.302 Fuentes: - https://code.claude.com/docs/en/skills - https://code.claude.com/docs/en/memory#agents-md - https://code.claude.com/docs/en/memory#when-agents-md-support-is-unavailable - https://code.claude.com/docs/en/memory Modelos compatibles: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5

← Anterior
Ejemplos de tono de voz de la marca
Siguiente →
Habilidad de revisión del código

Versión en español de Cris Severin. Basado en Claude How To de luongnv89, bajo licencia MIT. Proyecto original