LLM Wiki

Starter kit Codex-first para construir una wiki markdown persistente a partir de fuentes raw, con compatibilidad con Obsidian y un flujo human-in-the-loop.

Este repositorio publica solo la capa operativa del sistema:

esquema del repo
reglas de mantenimiento en AGENTS.md
scripts de automatizacion
configuracion de la vault
plantillas base

Las fuentes reales en raw/ y el contenido de dominio generado en wiki/ quedan fuera del repo publico.

Que Hace

organiza una vault en capas separadas para raw/, wiki/ y archivos operativos
automatiza extraccion, borradores y sugerencias para nuevas fuentes
permite correr una ingesta completa en un solo comando
mantiene index.md y log.md como archivos operativos regenerables
funciona como markdown comun y tambien como vault de Obsidian

Flujo

agregar una fuente a raw/
correr la ingesta mecanica o la ingesta completa
dejar que Codex cure e integre la fuente
regenerar indice, actualizar log y seguir expandiendo la wiki

Comandos Principales

Bootstrap

python scripts/bootstrap.py

Crea la estructura minima del repo si faltan directorios o archivos operativos.

Extraccion

python scripts/extract_source.py raw/mi-fuente.pdf

Extrae texto y metadatos basicos y deja artefactos en ops/ingest/.

Draft de Ingesta

python scripts/ingest_source.py raw/mi-fuente.pdf

Genera:

una source page draft en wiki/sources/
un artefacto de sugerencias para paginas relacionadas, conceptos y entidades

Ingesta Completa

python scripts/run_ingest.py raw/mi-fuente.pdf

Orquesta el pipeline completo:

extraccion
generacion de draft
invocacion de codex exec para curacion e integracion
resumen final en ops/ingest/<slug>-codex-summary.txt

Opciones utiles:

--prepare-only: corre solo la parte mecanica
--overwrite: rehace un draft existente
--model <modelo>: elige el modelo para codex exec

Rebuild Del Indice

python scripts/rebuild_index.py

Append Al Log

python scripts/append_log.py --type ingest --title "Mi Fuente" --path "wiki/sources/mi-fuente.md"

Lint

python scripts/lint_wiki.py

Estructura

raw/
  assets/
wiki/
  analyses/
  concepts/
  entities/
  sources/
  index.md
  log.md
ops/
  ingest/
templates/
scripts/
.obsidian/
AGENTS.md
HOME.md
README.md

Politica De Idioma

El sistema separa dos capas:

capa operativa: castellano por defecto
capa de conocimiento: mismo idioma de las fuentes por defecto

Eso permite tener configuracion y navegacion en español sin forzar traducciones automaticas del contenido derivado.

Obsidian

El repo esta preparado para abrirse como vault:

adjuntos en raw/assets/
templates en templates/
configuracion local de workspace excluida del versionado

Publicacion Del Starter Kit

Este repo esta pensado como plantilla operativa. Por eso, al versionarlo publicamente, conviene subir:

AGENTS.md
README.md
HOME.md
scripts/
templates/
.obsidian/ sin workspace.json
estructura vacia de raw/, wiki/ y ops/

Y dejar fuera:

PDFs u otras fuentes reales
artefactos de extraccion
paginas del dominio investigado

Siguiente Paso

Una vez estabilizado el pipeline, la expansion natural es montar una UI local sobre estos mismos comandos para disparar la ingesta con drag-and-drop y revisar jobs sin salir de la vault.

llm-wiki