--- kind: slashhuman-agent-field-manual version: 1 title: Dame un mundo, no una carpeta de documentos slug: dame-un-mundo-no-una-carpeta-de-documentos source_slug: give-me-a-world-not-a-folder-of-documents locale: es summary: Establece una ontología, una taxonomía y un canon vinculados a sus fuentes antes de realizar trabajo cuyo significado esté repartido por todo un sistema. human_keeps: La autoridad para definir qué existe, elegir el lenguaje del sistema, declarar qué rige y resolver ambigüedades con consecuencias reales. agent_takes: Extraer estructuras candidatas, vincular evidencia, exponer conflictos, rastrear consecuencias y mantener el mundo declarado durante el trabajo. --- # Manual de campo para agentes: Dame un mundo, no una carpeta de documentos Usa este manual cuando una tarea atraviese documentos, repositorios, equipos, políticas o límites del sistema. Tu objetivo no es resumir el corpus. Tu objetivo es heredar la realidad declarada del sistema sin inventarla en silencio. ## Objetivo Construye el modelo mínimo suficiente, validado por la persona responsable, de: - **Ontología:** las entidades, estados, relaciones, fronteras de responsabilidad e invariantes que el sistema considera reales. - **Taxonomía:** los términos preferidos, alias, clases y distinciones que sirven para nombrar y recorrer esa realidad. - **Canon:** las definiciones, reglas, decisiones, ejemplos y fuentes que tienen autoridad ahora, incluido aquello que reemplazan. Los documentos siguen siendo evidencia. Estas tres capas determinan cómo debe interpretarse y aplicarse esa evidencia. ## Protocolo 1. Limita el mundo a la tarea. Identifica las decisiones que la tarea puede afectar y los límites del sistema que atraviesa. No modeles territorio que no interviene. 2. Extrae de la evidencia las entidades, estados, relaciones, reglas y términos candidatos. Conserva una referencia a la fuente de cada afirmación importante. 3. No normalices nada en silencio. Crea un registro de ambigüedades: sinónimos, términos sobrecargados, responsabilidades disputadas, reglas en conflicto, relaciones ausentes y fuentes obsoletas. 4. Bosqueja la ontología. Da a cada entidad duradera un identificador estable, definición, tipo, responsable, relaciones, invariantes, fuente y estado de certeza o disputa. 5. Bosqueja la taxonomía. Registra la etiqueta preferida, los alias, las clases más amplias o específicas y los términos parecidos que deben permanecer separados. 6. Trabaja en el idioma de la persona sin traducir identificadores ni vocabulario del sistema por comodidad. Si el código, la interfaz o los documentos autorizados usan un término en inglés, conserva un mapa explícito entre ambos idiomas y pregunta cuando la traducción pueda cambiar el significado. 7. Bosqueja el canon. Marca la definición o decisión autorizada, su responsable, estado, fecha de vigencia, evidencia, motivo cuando se conozca y cualquier fuente a la que reemplace. 8. Pide intervención humana solo para ambigüedades con consecuencias. Presenta las interpretaciones posibles, su evidencia y el efecto posterior de cada elección. No conviertas una inferencia en canon por tu cuenta. 9. Traza el trabajo solicitado sobre el modelo validado. Antes de ejecutar, muestra las entidades afectadas, rutas de dependencia, fronteras de autoridad e invariantes en riesgo. 10. Ejecuta contra ese modelo. Actualízalo únicamente con cambios confirmados, conserva la procedencia y deja visibles las preguntas aún abiertas. ## Rechaza estos atajos - No trates un árbol de carpetas, un esquema de base de datos, un grafo de código o un grafo de conocimiento extraído automáticamente como la ontología por defecto. - No supongas que la similitud semántica demuestra identidad, dependencia o autoridad. - No unas términos solo porque en el habla cotidiana parecen sinónimos útiles. - No conviertas el documento más nuevo, largo o recuperado con mayor frecuencia en canon sin evidencia de autoridad. - No descartes las fuentes después de extraer la estructura. Un mapa sin procedencia no es más que una opinión segura de sí misma. - No construyas más infraestructura de la que exige el problema. Un archivo Markdown mantenido puede bastar; una plataforma de grafos abandonada no. ## Evidencia de finalización La ontología relevante está explícita y vinculada a sus fuentes. Su taxonomía hace estables los nombres y las distinciones. Su canon identifica qué rige ahora y qué ha sido reemplazado. La persona responsable resolvió las ambigüedades importantes, o estas siguen marcadas con claridad. El trabajo terminado conserva los invariantes declarados y el próximo agente puede heredar el modelo sin reconstruir el sistema desde cero. Ensayo canónico en español: https://slashhuman.blog/es/posts/dame-un-mundo-no-una-carpeta-de-documentos/ Original en inglés: https://slashhuman.blog/posts/give-me-a-world-not-a-folder-of-documents/