Una business factory, vista desde el disco, es un árbol de carpetas con reglas claras sobre quién escribe dónde. Este capítulo describe ese árbol y el blueprint que lo genera.
El árbol
<negocio>/
AGENTS.md el negocio: quién es quién, qué decide cada persona
.factory/ cómo funciona toda business factory; nadie del negocio la escribe
<rol>/
AGENTS.md el rol, en palabras del negocio
work/ el trabajo del rol: su repositorio git
.assets/ materiales y herramientas del rol que no son su trabajo
.sessions/
with-person/<persona>/ la conversación de owner de una persona (en el rol que coordina)
as-routine/<rutina>/ la conversación de una rutina
at-task/<tarea>/ la conversación de una tarea
Las instrucciones se leen de arriba hacia abajo: cada conversación lee el AGENTS.md del negocio, el de su rol y el de su carpeta de sesión, si lo tiene, y además las reglas comunes que recibe al arrancar.
Quién escribe dónde
- Un nombre con punto es de la business factory; uno sin punto, del negocio. Lo que tiene punto lo genera la plataforma.
- Un rol escribe solo en su
work/. Lo que necesita de otro rol, lo pide. - En la raíz de
work/solo hay carpetas, y adentro, un archivo por cosa. - La carpeta de la conversación de una persona es un lugar privado de esa persona, con su propio repositorio; lo que viene de las conexiones personales de alguien queda ahí.
- Las carpetas de rutina y de tarea no guardan nada: lo que tiene que durar va a
work/. Lo que es borrador de un turno va a una carpeta temporal fuera del árbol, que se vacía después de cada turno. .assets/guarda lo que el rol usa pero que tiene su propio origen (repositorios de herramientas, materiales): no se clona con la business factory.
Clonar una business factory
Una consecuencia de estas reglas: para clonar una business factory alcanza con el work/ de cada rol, más su depósito de datos (capítulo 14). Todo lo demás (las carpetas de sesión, las reglas comunes, los permisos) se vuelve a generar. Es la prueba más simple de que la separación entre lo del negocio y lo de la business factory está bien hecha.
El blueprint
El blueprint (capítulo 1) es, por dentro, código con versiones que vive en el coordinador. Toma tres cosas:
- la definición del negocio (sus roles, su conocimiento, sus conexiones);
- el directorio de personas (quién tiene acceso a qué);
- una versión del blueprint;
y produce los archivos de cada carpeta, la tabla de accesos y la lista de conversaciones que tienen que existir. Cuando algo de eso cambia, vuelve a generar. Las versiones del blueprint solo avanzan: una business factory nunca vuelve a un diseño de carpetas anterior.
Si una business factory corre en dos lugares (una computadora local y la nube), conviene que ambos salgan de una misma plantilla con bloques marcados para cada lado, de modo que las reglas no se separen con el tiempo.
Los permisos, generados
Los permisos de cada conversación (capítulo 13) también se generan al arrancar, a partir de una lista base con marcadores para la raíz y el rol: se completan para quién es la conversación, se le prohíbe escribir en el trabajo de los demás roles y, salvo al owner, se le quita la herramienta de preguntarle algo a una persona. La regla deja de ser una frase y pasa a ser un permiso (capítulo 10).
Recapitulando, una business factory es un árbol donde lo que tiene punto es de la plataforma y lo que no, del negocio; cada rol escribe solo en su trabajo; se clona con los work/; y un blueprint con versiones genera todo lo demás. La Parte V vuelve a las personas: cómo se dirige una business factory. El apéndice, por su parte, convierte estos cuatro capítulos en una guía que un agente puede seguir.