Hojas generadas
Eidos tiene exactamente dos vistas derivadas. Comparten tres propiedades, y las propiedades importan más que las salidas:
- Se regeneran enteras. Nunca se fusionan, nunca se parchean.
- No hay nada escrito a mano que preservar. Cualquier cosa que teclees en una se pierde.
- Anotan, nunca bloquean. Una hoja desactualizada es una molestia, no un fallo.
El índice
Sección titulada «El índice»Cada colección lleva un index.md generado en su carpeta, que lista sus
Blueprints para que una persona o un agente puedan navegar sin rastrear el árbol.
# specs
<!-- index: specs (regenerated) -->
## playback- [Watch a Video](playback/watch-a-video.md) — play a video reliably, signed in or not, adapting to the connection.- [Resume Playback](playback/resume-playback.md) — returns a viewer to the exact second they stopped.
## channels- [Subscribe to a Channel](channels/subscribe-to-a-channel.md) — follow a channel and get its new uploads.Agrupado por subcarpetas cuando la colección las tiene, en plano cuando no. Los
enlaces son relativos a la carpeta de la colección. Lo reconstruye la skill
index.
Lo que hace que summary merezca más atención de la que su tamaño sugiere. Es lo
único que la mayoría de lectores verá de la mayoría de Blueprints: una línea
llana que dice qué es esto. Escríbela como una destilación de la sección de
apertura, no como el título repetido.
Cuándo reconstruirlo
Sección titulada «Cuándo reconstruirlo»Después de añadir, renombrar, mover o eliminar Blueprints. La skill index
recorre las colecciones declaradas por el Framework, lee cada subcarpeta de un
nivel y reescribe entero cada index.md.
Trae un build-index.py que hace el recorrido de forma determinista allí donde
hay shell disponible, y recurre a hacerlo a mano en un host aislado.
El mapa de Blueprints
Sección titulada «El mapa de Blueprints»La contraparte espacial: un archivo .canvas de Obsidian (JSON Canvas
1.0), generado por la skill canvas.
Cada colección se dibuja como declara su Framework, en - **Canvas:**:
| Declaración | Se dibuja como |
|---|---|
file |
Un nodo de archivo completo, para prosa pensada para leerse entera, como un frame. |
card |
Un nodo que incrusta el Blueprint. |
card from ## Section |
Un nodo que incrusta solo esa sección. |
| (ausente) | Una tarjeta simple. |
Estructuralmente: cada colección es su propio grupo, y una colección agrupada anida un grupo por subcarpeta. Los directorios se convierten en nodos de grupo anidados.
Aristas
Sección titulada «Aristas»Los enlaces connects_to de cada Blueprint se convierten en aristas
dirigidas: este → destino. Ese es el mapa intencional: qué afirmas que se
relaciona con qué.
depends_on está desactivado por defecto y puede superponerse en un color
distinto. Es otra pregunta (dependencia de implementación en lugar de conexión
conceptual) y mezclar las dos produce un diagrama que no significa nada.
La distinción →
Tú eliges qué colecciones incluir. Los documentos de nivel superior no se mapean.
Es el mapa de Blueprints
Sección titulada «Es el mapa de Blueprints»Dibuja Blueprints y las aristas entre ellos. El Framework es lo único que nunca dibuja, que es para lo que sirve el nombre.
El .canvas generado es a su vez un documento de nivel superior, así que
regístralo en ## Top-Level en Framework.md. El nombre de archivo por defecto
sigue la convención de nombres: blueprint-map.canvas en kebab-case.
Ninguna de las dos bloquea
Sección titulada «Ninguna de las dos bloquea»Las dos hojas anotan. Un índice desactualizado o un canvas ausente nunca es un error que detenga nada, en consonancia con la portabilidad antes que prescripción del estándar.
También son las dos baratas de regenerar y seguras de borrar, que es la prueba de si algo pertenece siquiera a esta categoría. Si no puede reconstruirse a partir de los Blueprints, no es una hoja: es contenido, y pertenece a un archivo que alguien posee.