# Repositorio de conocimiento con IA: convierte tu negocio en consultable por Claude
Un estudio de arquitectura con cuatro socios y nueve colaboradores, doce años de proyectos y normativas urbanísticas de distintos municipios, cada una con sus matices. Los documentos estaban todos ahí. El problema era encontrarlos.
Cuando alguien preguntaba si en cierto municipio se podía retranquear un metro más, la respuesta siempre era la misma: «Creo que sí… estaba en un PDF… espera que lo busco.» Quince minutos después, alguien reenviaba un archivo por WhatsApp.
Claude podía leer documentos. Pero cada vez que querían usarlo, el trabajo previo era idéntico: localizar qué PDFs pasarle, comprobar que fueran los correctos y explicar de nuevo el contexto. El día que entendieron que el problema no era Claude sino su casa de archivos, todo cambió.
Por qué tu IA necesita una estructura clara
Claude no «sabe» dónde están tus cosas. Lee lo que le das y navega lo que le señalas. Si tu repositorio es caótico, Claude no lo va a arreglar con inteligencia. Va a reproducir el caos.
Un repositorio de conocimiento IA no es uno con muchos documentos. Es uno donde cualquiera —Claude incluido— puede entender qué hay y dónde en pocos minutos.
La diferencia es radical. En un repositorio desordenado, cada consulta requiere preparación manual. En uno bien estructurado, Claude puede operar de forma autónoma porque el contexto ya está accesible.
Carpeta plana vs. estructura con sentido
El error más común es la carpeta plana: cientos de archivos en el mismo nivel, nombres parecidos, versiones duplicadas. Eso funciona mientras recuerdas todo de memoria. Cuando delegas en una IA, deja de funcionar.
La alternativa no es complicar. Es jerarquizar con criterio:
– Una carpeta por dominio. Agrupa lo que pertenece al mismo tema.
– Subcarpetas por variante estable. Solo cuando el contenido lo justifica.
– Archivos solo cuando el contenido lo merece. No crees niveles vacíos.
Menos niveles, pero con significado. La estructura debe ser tan simple que puedas explicarla en treinta segundos, y tan clara que Claude pueda navegarla sin preguntar.
Convenciones de nombres: legibles por humanos y máquinas
El estudio de arquitectura adoptó reglas muy simples que funcionan igual para personas que para IAs:
– Minúsculas siempre.
– Snake_case (guiones bajos como separadores).
– Sin tildes ni espacios.
– Fechas solo cuando importan.
Ejemplos:
– `normativa_madrid_2023.pdf`
– `ordenanza_alturas_barcelona.md`
– `indice_normativas.md`
No es estética. Es previsibilidad. Cuando el nombre dice lo que hay dentro, Claude no tiene que adivinar. Y tú tampoco.
Las convenciones de nombres no son un capricho organizativo. Son el primer filtro de eficiencia. Un archivo llamado `documento_final_v2_DEFINITIVO.pdf` no dice nada. Uno llamado `normativa_madrid_2023.pdf` dice exactamente lo que contiene.
INDEX.md: el portero del edificio
El archivo más importante de tu repositorio no es un PDF. Es el índice.
Un INDEX.md no contiene los documentos. Contiene el mapa: qué carpetas existen, qué tipo de información hay en cada una, qué archivo consultar según la pregunta.
Antes de leer cien PDFs, Claude puede leer un índice de una página. Eso ahorra tiempo, tokens y errores. Es la diferencia entre preguntar «¿dónde está la normativa de Madrid?» y tener que escanear todo el disco.
El índice debe ser conciso, actualizado y enlazar directamente a los recursos relevantes. No es una narración: es una referencia rápida que permite a cualquier consulta llegar al documento correcto en el menor número de pasos posible.
Cómo migrar sin volverte loco
El estudio no paró una semana para ordenar todo. Empezó por una sola cosa: la carpeta que más usaban. Crearon su INDEX.md, renombraron diez archivos mal llamados. Nada más.
La semana siguiente, otra carpeta.
Ordenar no es un proyecto heroico. Es un hábito progresivo.
La trampa habitual es querer reorganizar todo el disco duro en un fin de semana. El resultado suele ser peor que el desorden original: nombres nuevos que no recuerdas, estructura que no entiendes, y la sensación de haber perdido un día entero.
Mejor: elige una carpeta profesional que uses a menudo. Lista su contenido. Pídele a Claude que detecte nombres confusos, posibles duplicados y proponga una estructura más clara. Genera un INDEX.md que explique qué hay. Aplica solo los cambios que entiendas y aceptarías.
Un repositorio útil hoy vale más que uno perfecto dentro de seis meses. La clave es empezar por donde el retorno es inmediato: esa carpeta que consultas tres veces al día y que siempre te hace perder cinco minutos buscando el documento correcto.
El resultado: un negocio consultable
Cuando tu repositorio está bien estructurado, Claude deja de ser un asistente que necesita instrucciones constantes y se convierte en un consultor que encuentra respuestas por sí mismo.
Las consultas pasan de «busca en estos veinte PDFs que te adjunto» a «revisa el repositorio y responde con la normativa aplicable». El salto de eficiencia es enorme. Ya no necesitas actuar de intermediario entre tus archivos y la IA. Claude puede navegar directamente.
Además, un repositorio bien organizado no solo beneficia a Claude. Beneficia a todo tu equipo. Cuando un compañero nuevo necesita encontrar información, el INDEX.md le sirve de mapa. Cuando tú mismo vuelves a un proyecto después de meses, la estructura te ahorra horas de orientación.
Tu repositorio de conocimiento con IA no es un proyecto de fin de semana. Es una inversión progresiva que paga dividendos cada vez que Claude encuentra lo que necesita sin preguntarte. Empieza por una carpeta, hazlo bien, y el hábito se extenderá naturalmente.
📖 El Empleado Digital — La guía práctica para automatizar tu trabajo y multiplicar tu productividad con IA.
👉 Disponible en Amazon