index

Reconstruye el index.md de una colección: la hoja generada que lista sus Blueprints para que una persona o un agente puedan navegar sin rastrear el árbol.

Qué hace

Lee las colecciones declaradas por el Framework, recorre el único nivel de subcarpetas de cada una y reescribe entero cada index.md: un enlace markdown por Blueprint con su summary de una línea, agrupado por subcarpeta o en plano.

specs/index.md

# specs

<!-- index: specs (regenerated) -->

## playback
- [Watch a Video](playback/watch-a-video.md) — play a video reliably, signed in or not.
- [Resume Playback](playback/resume-playback.md) — returns a viewer to the exact second they stopped.

Regenera, no escribe

Cada línea es el summary del Blueprint, tal cual. Un Blueprint sin él se señala, nunca se inventa: un índice que en silencio te escribe una línea plausible es un índice en el que ya no puedes confiar.

Cuándo ejecutarla

Después de añadir, renombrar, mover o eliminar Blueprints.

Nada depende de que esté al día: un índice desactualizado es una molestia, no un fallo. Anota en lugar de bloquear, como todo lo derivado en Eidos.

Cómo se ejecuta

Trae un build-index.py que hace el recorrido entero de forma determinista allí donde hay shell disponible, y recurre a hacerlo a mano en un host aislado. En cualquiera de los dos casos la salida es la misma.

Nota

No hay nada escrito a mano en un index.md que preservar. Cualquier cosa que teclees en uno se pierde en la siguiente ejecución, que es la prueba de si algo pertenece siquiera a una hoja generada.

Relacionado

• Hojas generadas: esta y el canvas, juntas.