La carpeta de tu empresa

Tu empresa vive en una carpeta de archivos de texto sencillo: tu rumbo, tus ofertas, tu voz, tus reglas, y los objetivos y las habilidades de cada departamento. Tu IA la lee para conocer tu negocio, y escribe en ella mientras trabaja.

Qué hay en la carpeta

direction.md, company.json, brand.json y AGENTS.md: quién eres y cómo funciona tu oficina.
rules/: tu voz, tus ofertas, los datos de tu empresa y tus normas de la casa.
departments/: la página de cada departamento, sus objetivos y sus papeles.
skills/: las formas escritas de hacer cada trabajo, con sus páginas de consulta. Estas páginas de ayuda también están ahí, en skills/get-help/references/.

Leer

read recibe una de estas cosas: path, list o search. offset y version solo van con un path.

Escribir un archivo

Las rutas terminan en .md o .json. Solo templates/ puede tener también archivos .html.
Una ruta usa solo letras, cifras y . _ - /, con hasta 200 caracteres, sin .. y sin //.
El texto de un archivo tiene de 1 a 200.000 caracteres.
write necesita las cuatro cosas: path, body, base_version y note.
base_version es la versión que te dio read, o 0 para un archivo nuevo. Si alguien cambió el archivo mientras tanto, una versión antigua se rechaza, y la respuesta te da la actual. Léelo otra vez y vuelve a hacer el cambio.

Los archivos clave necesitan un sí

Algunos archivos dan forma a toda la empresa, así que solo cambian con el sí del propietario: tu IA propone el cambio (propose con kind file_change) y tú dices que sí. Los archivos clave son AGENTS.md, company.json, direction.md, brand.json, todo lo que hay en rules/, templates/ y connectors/, y cada departments/<id>/goals.md.

Lo que nunca va en la carpeta

Los archivos de la web: los archivos de sites/ solo cambian con deploy_site.
Los correos o los teléfonos de tus clientes. Las personas van en tu lista de personas, y los demás datos van en registros.
Claves, contraseñas o cualquier cosa que lo parezca.

Registros

Los registros guardan los datos de tu negocio en módulos, como pagos, reservas o páginas, para que tu panel pueda mostrarlos.

Un registro guarda hasta 20.000 caracteres de datos.
La primera vez que un módulo recibe un registro, tu IA dice a qué departamento pertenece.
Para cambiar un registro hace falta la versión que leíste. Una versión antigua se rechaza.
Un módulo guarda como mucho 5.000 registros.
Tu IA solo puede borrar registros que escribieron los agentes, mientras tiene una tarea en el departamento de ese módulo. Para cualquier otra cosa, como una reserva, un miembro o lo que escribió una persona, pide borrarlo con una propuesta record_delete para tu sí.