Documentación

Contexto del proyecto

Gestione los archivos de memoria del repositorio y los documentos, políticas y referencias que los agentes leen antes de trabajar.

Los agentes leen su código y los archivos de instrucciones de su repositorio. Contexto reúne esos archivos de memoria con las notas del proyecto, el contexto generado y las referencias.

Para conocer la razón por la que estos elementos se incluyen aquí, lea Contexto del proyecto en la sección Conceptos. Esta página explica cómo gestionarlo.

Archivos de memoria del repositorio

Abrir Configuración → Conocimiento → Contexto y busque bajo Fuentes del repositorio. Coroid lee estos archivos desde el repositorio conectado:

  • AGENTS.md en la raíz del repositorio: instrucciones generales para agentes
  • CLAUDE.md en la raíz del repositorio: instrucciones para Claude
  • GEMINI.md en la raíz del repositorio: instrucciones para Gemini
  • .cursor/rules: el archivo de reglas de Cursor compatible

Estos archivos suelen llamarse archivos de memoria. Su contenido habilitado se incluye en el contexto del proyecto de los agentes antes de que comiencen a trabajar. Los nombres no los limitan a un modelo específico: las fuentes habilitadas se combinan para los agentes de Coroid.

Los archivos existentes aparecen con un Editar acción, un recuento estimado de tokens y un switch que controla si los agentes los reciben. Las fuentes se habilitan a menos que las deshabilite explícitamente. Si varios archivos se repiten o contradicen entre sí, mantenga habilitadas las fuentes que quiere que sigan los agentes y deshabilite las demás.

Crear indica que el archivo no estaba presente en la copia de trabajo del repositorio de Coroid. Si la lectura falla, la página ofrece Reintentar; un error de acceso no significa que el archivo falte. Compruebe que el archivo esté confirmado en la rama del repositorio conectado. Para la ejecución de tareas, el agente lee la copia de trabajo de la tarea, por lo que los cambios en los archivos de instrucciones de esa rama se aplican a la tarea.

Los archivos de memoria habilitados pueden importar Markdown del repositorio con @path, por ejemplo @AGENTS.md en CLAUDE.md o @docs/conventions.md. Las rutas se resuelven en relación con el archivo que contiene la referencia. Coroid procesa las importaciones anidadas, detiene los ciclos y incluye cada archivo y cada cuerpo de instrucción idéntico solo una vez. Las importaciones dentro de ejemplos de código y direcciones de correo electrónico se dejan sin modificar. Las referencias fuera del repositorio no se cargan, y las importaciones no pueden omitir una fuente del repositorio deshabilitada explícitamente.

Solo las fuentes raíz listadas se detectan automáticamente. Las AGENTS.md y los archivos .cursor/rules/*.mdc individuales se pueden incluir mediante una @ importación; el alcance del directorio no se infiere automáticamente.

Contextos de aplicación

Bajo Contextos de aplicación, guarde las instrucciones y referencias en Coroid. Las notas manuales y el contexto del proyecto generado se pueden habilitar o deshabilitar independientemente de los archivos del repositorio. Utilice estas entradas para información que no pertenece a Git.

Añadir contexto

Seleccione Añadir contexto y agregue una entrada. Cada una tiene un título y un cuerpo, y se puede editar o eliminar más tarde.

Las buenas entradas son breves, específicas y duraderas. Las decisiones de arquitectura, las convenciones de estilo, los contratos de API, los límites de propiedad y las prohibiciones explícitas pertenecen aquí. La narrativa de incorporación y todo lo que ya sea obvio a partir del repositorio no deben incluirse.

Mantenga las entradas separadas y bien nombradas

Una entrada por tema, con un título que indique su contenido. "Convenciones de manejo de errores" y "Módulos congelados" son recuperables; una única entrada llamada "Notas" que contenga ambos no lo es.

Esto es importante porque el contexto se carga selectivamente según el trabajo en curso — consulte Habilidades progresivas. Las entradas bien separadas permiten que se cargue la adecuada para cada tarea.

Referencias

Además de las entradas escritas, puedes adjuntar referencias: enlaces y documentos que apuntan a material almacenado en otros lugares. Úsalos cuando la copia autorizada se encuentre en una wiki o herramienta de diseño y no quieras tener una segunda copia que quede desactualizada.

Contexto por tarea

El contexto del proyecto se aplica a todo lo que contiene. Para el material relevante para una tarea concreta —un ticket, un informe de cliente, un documento de diseño— adjúntalo a esa tarea específica. Una nota específica de tarea incluida en el contexto del proyecto generará ruido en todas las tareas futuras.

Mantenerlo actualizado

Un contexto obsoleto es peor que un contexto ausente, ya que los agentes lo tratan como fuente autorizada. Cuando cambie una convención, actualiza la entrada en la misma modificación que altera el código.

Revisar lo que hay

Lee tu contexto ocasionalmente como si fueras nuevo. Las entradas se acumulan, y las que se redactaron durante una migración finalizada hace un año ahora resultan activamente engañosas.