# Reglas del proyecto

> Escribe en AGENTS.md o en OSIRIS.md cómo se trabaja en tu proyecto; la app lee esos dos archivos, desde la raíz del proyecto hasta la carpeta en la que trabajas.

Crear software · Actualizado: 2026-11-02 · versión 2.0.164 · https://nobreiniers.com/ayuda/project-rules/

Las reglas del proyecto son instrucciones que tus agentes leen antes de trabajar en una carpeta: cómo se compila, qué estilo se usa, qué no se toca. Viven en archivos de texto dentro del proyecto.

## Crear las reglas

1. Abre un chat en tu proyecto.
2. En el compositor escribe `/init` y envía. El agente lee el código y escribe el `AGENTS.md` del proyecto.
3. Abre el archivo y corrígelo: es tuyo, y lo que diga es lo que harán tus agentes.

## Instrucciones que escribes en la app

Abre los ajustes del proyecto y escribe en «¿Cómo deben trabajar los agentes en este proyecto?». Se guarda en la app, no en tu carpeta, y todos los chats del proyecto lo siguen. Se guarda al salir del cuadro. Si es demasiado largo se rechaza y no se guarda nada; nunca se corta.

En «Material de referencia de este proyecto» agregas archivos (libros, PDF, notas) que solo leen los chats de este proyecto.

## Qué se lee, y cuándo

| Archivo | Cuándo llega al agente |
|---|---|
| `AGENTS.md` u `OSIRIS.md` en la raíz del proyecto (la carpeta con `.git`) | Al empezar el chat. |
| Los mismos archivos en cada carpeta desde la raíz hasta la carpeta en la que trabaja el chat | Al empezar el chat. Cuanto más cerca de tu carpeta, más tarde llega el archivo, porque es el más específico. |
| `AGENTS.md` u `OSIRIS.md` en una subcarpeta en la que el chat no trabaja | Cuando el agente lee un archivo de esa subcarpeta, con la herramienta de leer archivos o con un comando que lo muestra, como `cat`, `head` o `grep`. |

Tus propias reglas, las que valen para todos los proyectos, son el `AGENTS.md` u `OSIRIS.md` de la carpeta de tu perfil y, en un negocio, su propio `AGENTS.md`. Llegan primero y siempre conservan su espacio.

## Las reglas escritas para otra herramienta no se leen

Los archivos de reglas que otras herramientas de programación guardan en un proyecto, o en tu carpeta personal, están escritos para los modelos de esas herramientas. NoBreiniers no los lee, así que una instrucción pensada para otro modelo nunca llega a los que usas aquí. Para conservar algo de ellos, cópialo en tu `AGENTS.md`.

## La carpeta personal no es un proyecto

Un chat que trabaja en tu carpeta personal no tiene proyecto, así que no lee reglas de proyecto: la carpeta personal, las carpetas por encima de ella y las carpetas ocultas dentro de ella nunca son un proyecto.

## Lo que la app cuida

- **Cada archivo de reglas llega entero a tus agentes.** Diga lo que diga un archivo de reglas, el app se lo da a tus agentes tal como está, sin retener nada. El archivo propio de un proyecto (uno que puede traer un proyecto descargado) va marcado como texto de ese proyecto, para que tus agentes sepan que no es tuyo. Tus propias reglas llegan como las escribiste.
- **Nada se pierde en silencio.** Todas las reglas comparten 64 KiB, que se llenan desde la carpeta más cercana hacia fuera para que las más específicas siempre quepan. Lo que no cabe se nombra.
- **Sin repetir.** Si `AGENTS.md` y `OSIRIS.md` son enlaces a un mismo archivo, se da una sola vez.
- **Sin salir de la carpeta.** Un enlace que sale de la carpeta del proyecto no se sigue.
- **Después de compactar.** En una conversación larga, las reglas que trajo una lectura vuelven con la siguiente lectura.

> **Nota:** En una [revisión a fondo](https://nobreiniers.com/ayuda/code-review/), las reglas se leen de la versión anterior al cambio.
