Esta semana Claude Code ha actualizado la estructura de proyecto
Esta semana Claude Code ha actualizado la estructura de proyecto que recomienda usar. Puede sonar técnico, pero la idea de fondo es bastante simple.
¿Qué hay de nuevo?
1. Claude Code ya reconoce AGENTS.md. Hasta ahora solo leía su propio archivo de instrucciones, CLAUDE.md. A partir de este cambio, si un proyecto no tiene ese archivo, Claude buscará AGENTS.md, que es el mismo formato que utilizan herramientas como Codex, Cursor y Copilot. Para los equipos que combinan varias IAs en su flujo de trabajo, esto elimina la necesidad de mantener las mismas reglas duplicadas en archivos diferentes.
2. Las skills sustituyen a los comandos. Antes, las instrucciones reutilizables se almacenaban en la carpeta commands/. Ahora la recomendación es usar skills/, una carpeta que además tiene la ventaja de activarse automáticamente cuando la tarea lo necesita, aunque también se pueden invocar manualmente con /. La carpeta commands/ sigue siendo compatible, pero todo lo nuevo debería ir en skills/.
Un repaso rápido a cada elemento de la estructura:
settings.json: gestiona los permisos del proyecto. Aquí se configuran las herramientas, el modelo y los plugins. Lo que es personal o local va en settings.local.json.
rules/: reglas organizadas por temática. Lo ideal es crear un archivo por cada área: estilo de código, pruebas, API, etc.
skills/ (novedad): las “recetas” reutilizables del proyecto. Cualquier tarea que repitas con frecuencia puede convertirse en una skill. Se activan solas o mediante /.
agents/: subagentes con un rol concreto, como revisor de código o auditor de seguridad.
hooks/: automatizaciones. Permite configurar validaciones, aplicar formato o bloquear acciones que puedan resultar peligrosas.
worktrees/: copias paralelas del proyecto. Conviene añadirla al .gitignore.Claude Code actualiza su estructura de proyecto: AGENTS.md y la carpeta skills/ reemplazan convenciones anteriores
Resumen técnico
Claude Code introduce dos cambios estructurales en su configuración de proyectos. Primero, el agente ahora lee AGENTS.md como fallback cuando no existe CLAUDE.md, unificando el archivo de instrucciones con el que ya usan Codex, Cursor y Copilot. Segundo, la carpeta commands/ queda deprecada en favor de skills/, que permite activación automática contextual además del llamado explícito con /. El resto del árbol de directorios —settings.json, rules/, agents/, hooks/ y worktrees/— mantiene su función pero queda formalizado como estructura recomendada oficial.
Análisis de implicaciones
La compatibilidad con AGENTS.md elimina la duplicación de reglas en equipos que operan con múltiples agentes simultáneamente. Un único archivo de instrucciones puede gobernar Claude Code, Copilot y Cursor sin sincronización manual. La activación automática de skills/ implica que el agente infiere cuándo aplicar una rutina sin intervención explícita del desarrollador, lo que reduce fricción pero exige definir skills con criterios de activación bien delimitados para evitar ejecuciones no deseadas.
Aplicación práctica
En un proyecto con Cursor y Claude Code activos, basta un único AGENTS.md en la raíz con las reglas de estilo, pruebas y convenciones de API. Las tareas repetitivas —generación de tests, formateo de commits, validación de esquemas— se trasladan a archivos individuales dentro de skills/. Los hooks/ gestionan validaciones automáticas antes de cada escritura. El archivo settings.local.json queda fuera del control de versiones para configuración personal. La carpeta worktrees/ se añade explícitamente al .gitignore.
Contexto del sector
La convergencia hacia AGENTS.md como estándar compartido refleja una tendencia real: los equipos ya no trabajan con un único agente de IA, sino con varios en paralelo. La fragmentación de configuraciones ha sido un coste operativo concreto. Que Anthropic adopte el mismo archivo que OpenAI Codex y Microsoft Copilot sugiere un movimiento hacia interoperabilidad de configuraciones, no solo de modelos.
Artículo relacionado