Metodología de proyectos con Claude Code
En una frase: un método para usar Claude Code sin explicarlo todo cada vez.
Claude Code es una IA de Anthropic que trabaja con los archivos de un proyecto. El método la convierte en un sistema de trabajo que se puede reutilizar. Es una propuesta de organización, no algo que Claude Code te exija.
Lo explica Lorena Bordonaba en un vídeo de YouTube. La versión adulta sale de un resumen del vídeo. El vídeo no se ha revisado.
Tema avanzado
Esta ficha cuenta cómo organizar proyectos con una herramienta para programar. Aquí tienes la idea; el detalle está en la versión adulta, enlazada al final.
Cómo se ve
Qué necesitas
- Claude Code, mejor dentro de un editor de código como VS Code.
- Una carpeta distinta para cada proyecto.
- Abrir Claude siempre desde esa carpeta, no desde una que tenga muchos proyectos.
Es como tener un cuaderno por asignatura, en vez de uno para todo.
Qué pasa, paso a paso
- Preparas la carpeta del proyecto con subcarpetas fijas: contexto, plantillas, resultados y otras.
- Escribes un archivo de instrucciones corto, llamado CLAUDE.md. Dice el objetivo, qué leer antes de actuar y cuándo algo está terminado. Si crece mucho, se reparte en reglas o skills.
- Creas ayudantes con una especialidad clara, como revisar o comprobar entregas. Se llaman agentes. Mejor varios especialistas que uno que lo haga todo. Lo que repites a menudo lo guardas como skill.
- Instalas solo las conexiones externas necesarias, llamadas MCP. Antes miras quién las publica y qué permisos piden.
- Defines los permisos en un archivo de ajustes y compruebas las reglas. Un texto en CLAUDE.md no bloquea nada: lo bloquean los permisos. Las reglas deben cubrir también las órdenes por terminal.
- Trabajas cada encargo en las seis fases del dibujo. Primero se pide un análisis sin ejecutar nada, y se revisa el plan. Una sesión por objetivo. Si cambias de tarea, empiezas otra.
Es como cocinar con receta. Primero lees y preparas, luego cocinas por partes y al final pruebas.
Un ejemplo de la vida real
Imagina a una profesora que prepara los apuntes de un curso con Claude Code. Crea una carpeta solo para ese curso. Dentro deja un archivo corto: temario, nivel de la clase y cómo citar fuentes.
Cada día, Claude lo lee al empezar y ella no tiene que repetírselo. Antes de escribir un tema, le pide un plan y lo revisa. Al terminar, le pide que compruebe el tema y resuma lo hecho.
Errores que se repiten
La fuente recoge diez. Los más repetidos:
- Dar una orden enorme sin un plan antes.
- Meterlo todo en el archivo de instrucciones.
- Aprobar todas las órdenes sin mirarlas.
- No pedir que se compruebe el resultado.
- Automatizar algo antes de que funcione bien a mano.
Pruébalo tú
- ¿Por qué conviene una carpeta distinta para cada proyecto?
- Antes de ejecutar un encargo grande, ¿qué dos cosas pide el método?
Respuestas
- Porque el contexto de cada proyecto vive en su carpeta. Así no se mezcla con el de otros proyectos.
- Pedir un análisis sin ejecutar nada y revisar el plan. Solo después se ejecuta, por fases.
Palabras clave
- Claude Code: IA de Anthropic que trabaja con los archivos de un proyecto.
- CLAUDE.md: archivo corto con las instrucciones que Claude lee en cada sesión.
- Agente: ayudante con una especialidad clara, como revisar o comprobar.
- Skill: instrucciones guardadas para una tarea que repites a menudo.
- Sesión: una conversación de trabajo con Claude, de principio a fin.
- Permisos: lo que Claude puede hacer sin preguntarte y lo que no.