Proyectos y bases de conocimiento
En muchas ocasiones tenemos que hacer tareas que están relacionadas. Para gestionarlas tenemos la opción de proyectos, que son entornos con un propósito específico, instrucciones y acceso a carpetas específicas.
Cuándo crear un proyecto
En general te puedes encontrar en dos situaciones:
- Creas una nueva carpeta para gestionar un proyecto real
- Llevas varios chats trabajando en algo específico
Por ejemplo, digamos que tienes en mente un nuevo paper: en este caso es útil crear primero el proyecto. Ahí irán los chats asociados a revisión de la literatura, diseño de protocolos, borradores, código, etc. El segundo caso es para cuando no creamos un proyecto de antemano y por organización queremos agrupar los chats de un mismo tema.
Instrucciones del proyecto
En muchas ocasiones podemos crear un proyecto y empezar a crear chats dentro de él. Esto es válido, pero en muchas otras ocasiones vale la pena pararse un rato a pensar en para qué se crea el proyecto y cómo queremos que se comporten los agentes que van a trabajar dentro de él.
AGENTS.md y CLAUDE.md: el system prompt del proyecto
Cuando el proyecto vive en una carpeta o repositorio y trabajamos con un harness como Codex o Claude Code, podemos guardar instrucciones en un archivo de markdown. Cumple una función parecida a un system prompt del proyecto: se carga al comenzar un chat y evita repetir siempre las mismas reglas.
En Codex y otros agentes compatibles se llama AGENTS.md, mientras que en Claude se llama CLAUDE.md. Persiguen el mismo objetivo (guardar contexto, reglas e instrucciones persistentes), aunque cada harness tiene sus propias convenciones para localizarlos, combinarlos y decidir qué archivo tiene prioridad.
Por ejemplo, en un proyecto de análisis biomédico podríamos escribir:
# Objetivo
Preparar una revisión de literatura sobre [pregunta de investigación].
# Reglas del proyecto
- Trabajar únicamente con fuentes autorizadas.
- No utilizar datos personales ni inferir información que no figure en las fuentes.
- Separar los resultados de los estudios de nuestra interpretación.
- Indicar el archivo y la página que respaldan cada dato extraído.
- Ejecutar las comprobaciones del proyecto antes de dar una tarea por terminada.
Las instrucciones conviene mantenerlas breves, concretas y bajo control de versiones.
Puedes consultar cómo se cargan y combinan en la documentación oficial de AGENTS.md y CLAUDE.md.
Organizar los chats por resultado
Separa tareas diferentes como “criterios de inclusión”, “tabla de extracción”, “borrador del método” y “respuesta a revisores”. Un hilo por tema facilita revisar qué entradas dieron lugar a cada salida. Usa nombres con propósito y fecha; archiva los hilos cerrados.
No conviertas la memoria de la plataforma en el registro oficial, aquí estamos trabajando con proyectos. Suele ser útil pedir a los agentes que vayan documentando una carpeta docs/ las decisiones/tareas que van haciendo.
Registro de ejecución
Si varios chats o agentes trabajan sobre el mismo proyecto, conserva un registro comprensible sin tener que reconstruir todas las conversaciones. Como mínimo debería indicar:
- fecha y objetivo;
- archivos o fuentes utilizados;
- modelo, herramientas y skills empleadas;
- acciones propuestas o realizadas;
- errores y decisiones tomadas;
- revisiones o aprobaciones humanas;
- resultado final y archivos generados.
Este registro puede guardarse en docs/ junto al proyecto. No sustituye al cuaderno de laboratorio ni al sistema institucional, pero permite entender qué hizo el agente, con qué entradas y bajo qué instrucciones.