Archivos, carpetas y nombres¶
Guía de aplicación vigente basada en MILPA 0.1. No prescribe un árbol universal de carpetas.
La estructura ayuda a encontrar conocimiento y saber qué se puede cambiar. Empieza por las funciones que necesitas localizar, no por copiar el árbol de otro proyecto.
Siete funciones, no siete archivos¶
El núcleo de MILPA-R-006 contiene estas funciones. Cada una tiene un lugar identificable; los nombres concretos pertenecen al perfil.
| Función | Qué permite encontrar |
|---|---|
| Manifiesto | Identidad, alcance y responsable del proyecto. |
| Entrada para lectores | Qué es el proyecto y por dónde empezar. |
| Fuentes y vínculos | Origen del conocimiento y relaciones declaradas. |
| Instrucciones para agentes | Reglas aplicables cuando operan agentes. |
| Índice documental | Mapa desde lo general hacia el detalle. |
| Decisiones | Qué se decidió, por quién y sobre qué revisión. |
| Material temporal separado | Borradores y exploración que no se confunden con texto aceptado. |
Un proyecto puede distribuirlas entre varios documentos o reunir algunas en uno. La guía no
convierte README.md, AGENTS.md, SOURCE.md, docs/, plans/ ni .asilo/ en nombres
universales obligatorios.
Ordena de lo general a lo particular¶
Una entrada breve explica propósito, alcance y siguiente paso. El índice dirige a temas; los temas enlazan a decisiones, requisitos y evidencia. Esa ruta evita cargar todo el proyecto para responder una pregunta pequeña.
Como ejercicio, construye una tabla con «función → ubicación real → responsable → revisión». Comprueba que las ubicaciones existen y que el índice no enlaza a un plan como si ya estuviera implementado. La tabla es una ayuda de lectura, no un esquema metodológico aceptado.
Declara los nombres antes de usarlos¶
MILPA-R-005 pide vocabulario reservado declarado y versionado. Un nombre reservado conserva su significado; uno nuevo necesita un cambio registrado en ese vocabulario. Los nombres propios de productos o dominios quedan fuera.
Las listas anteriores y las convenciones de un lenguaje no se convierten por eso en vocabulario universal. El contenido y la versión del vocabulario base requieren concreción; consulta los perfiles en preparación.
Integra sin fusionar¶
Cuando dos proyectos se relacionan, MILPA-R-007 pide declarar en ambos extremos proveedor, consumidor, contrato y versión, datos que cruzan, owner, estado y evidencia. Compartir una carpeta o una marca no demuestra integración. Para una versión publicada, una ruta local no puede ser el único mecanismo de vínculo.
Un cambio de estructura conserva su procedencia y las decisiones que lo justifican. Si hay reglas incompatibles, registra el conflicto según MILPA-R-008; no lo resuelvas sólo renombrando carpetas.
Siguiente: contexto y traspasos · Consultar artefactos
Un mapa de funciones¶
La señalización de un edificio indica dónde ocurre cada actividad. De forma semejante, una estructura permite localizar fuentes y decisiones. Los nombres de las habitaciones pueden cambiar; su función sigue identificable. El mapa no impone permisos.