Serie · Parte 4 de 6: Cómo montamos el departamento de IA en Twim
Si no has leído las partes anteriores, te recomendamos empezar por el principio: Parte 1 →
La solución no era sofisticada. Era lo contrario.
Después del experimento con Paperclip, teníamos claro que el problema no era la infraestructura de agentes —era el contexto que había debajo—. Y para resolver ese problema, necesitábamos una forma de documentar el conocimiento de la organización que fuera, al mismo tiempo, legible para personas y consumible por cualquier herramienta de IA.
La respuesta fue tres archivos de texto en formato Markdown. Markdown es un formato de escritura muy sencillo: texto plano con algunas marcas simples para indicar títulos, listas o negritas. No requiere software especial para leerlo — se puede abrir con cualquier editor de texto o incluso con el bloc de notas — y cualquier herramienta de IA del mercado puede procesarlo directamente.
Tres archivos. Un nombre fijo para cada uno. El mismo esquema para toda la organización.
CONTEXTO.md
Este archivo responde a la pregunta: ¿qué es esto y cómo funciona?
Contiene la descripción de la unidad —puede ser la empresa entera, un departamento, un proyecto—, su propósito, las herramientas que utiliza, sus restricciones y su estado actual. Es el documento que le darías a alguien que llega nuevo y necesita entender dónde está en diez minutos.
Una IA que lee CONTEXTO.md sabe en qué entorno está operando antes de hacer cualquier cosa. Sabe que está trabajando para una empresa de tecnología con clientes en el sector industrial, no para una clínica o una agencia de publicidad.
INSTRUCCIONES.md
Este archivo responde a la pregunta: ¿cómo se trabaja aquí?
Contiene las reglas del juego: el tono de comunicación, los procesos establecidos, las decisiones ya tomadas que no hay que volver a debatir, las cosas que se hacen siempre de una determinada manera y las que nunca se hacen. Es el manual de estilo y el manual de operaciones al mismo tiempo.
Una IA que lee INSTRUCCIONES.md sabe cómo actuar, no solo qué hacer. Sabe que en esta empresa los presupuestos los aprueba siempre el CEO, o que los correos a clientes nunca usan un tono informal, o que las reuniones de proyecto tienen siempre un acta con decisiones y próximos pasos.
MEMORIA.md
Este archivo responde a la pregunta: ¿qué ha pasado hasta ahora?
Contiene el historial relevante: decisiones tomadas y el motivo detrás de ellas, problemas que surgieron y cómo se resolvieron, cambios de dirección y por qué se hicieron, estado de los temas pendientes. Es la memoria institucional que normalmente vive en la cabeza de las personas o dispersa en conversaciones de chat que nadie puede recuperar cuando las necesita.
Una IA que lee MEMORIA.md no empieza desde cero. Sabe lo que ya se intentó, lo que funcionó y lo que no.
Por qué funciona
La razón por la que este sistema funciona es simple: cualquier herramienta de IA del mercado puede leer texto plano. No hay lock-in —dependencia forzosa de un único proveedor—. Si mañana aparece un modelo más potente o más económico que el que usas hoy, lo cambias. El contexto ya está documentado en archivos que cualquier IA puede leer. No tienes que empezar de cero.
Y si mañana se incorpora una persona nueva al equipo, puede leer exactamente los mismos tres archivos. El conocimiento no vive en ninguna cabeza. Vive en la organización.
Lo que no es
Este sistema no es un software de gestión del conocimiento, ni una plataforma cara, ni algo que requiera formación específica.
Son tres archivos de texto que cualquier persona puede abrir con el programa que prefiera, leer en diez minutos y actualizar sin ayuda técnica.
La potencia no está en la tecnología. Está en la disciplina de mantenerlos actualizados.
Siguiente en la serie: De la organización al departamento →