Saltar a contenido

Patrón index + log

Dos archivos obligatorios en todo wiki bajo el concepts/llm-wiki-method: index.md (navegación) y log.md (historial append-only).

index.md

Punto de entrada canónico. Categoriza todas las páginas del wiki por tipo. Categorías típicas observadas:

  • Tools (herramientas: software, CLIs, servicios).
  • Techniques (métodos, patterns).
  • Concepts (ideas abstractas: frameworks, teorías).
  • Sources (uno por documento crudo ingerido).
  • People / Entities (individuos, orgs, productos).
  • Comparisons (páginas que contrastan dos o más cosas).

El agente siempre lee index.md primero — ver concepts/qa-phase. Debe mantenerse actualizado en cada ingest.

log.md

Historial append-only de operaciones sobre el wiki:

  • Cada ingest: fecha, source procesado, páginas creadas/actualizadas.
  • Cada lint: fecha, qué detectó, qué cambió.
  • Notas manuales si el usuario edita directamente.

Sirve para: auditabilidad, detectar patrones (qué se ingirió mucho de un tema), saber cuándo fue el último health check.

Por qué estos dos

  • index.md es la "tabla de contenidos" que el agente necesita para Q&A eficiente.
  • log.md es la trazabilidad: hace que el wiki sea reversible y explicable.

Sin estos dos, el wiki degrada a una carpeta de markdowns sueltos sin semántica operacional.

Relaciones