Saltar a contenido

Flat vs nested (estructura del wiki)

Decisión de layout: poner todas las páginas del wiki/ directamente en la raíz (flat) o separarlas por carpetas tipo concepts/, entities/, analysis/ (nested).

Posturas

  • Karpathy: "sometimes I like to keep it really simple and really flat". No organizar de más; la sobre-organización lastima.
  • El autor del video: para el caso research (YouTube transcripts) usó nested porque tenía muchas páginas y las categorías ayudan a navegar; para su second brain personal usó flat.

Heurística

Señal Recomendación
Pocas páginas (<30) Flat
Categorías claras y estables Nested
Dominio mezcla tipos (personas + conceptos + tools) Nested ayuda
Objetivo es scanning humano rápido Flat
Objetivo es consumo por agente externo Cualquiera; el agente sigue wikilinks sin importar layout

Trade-offs

  • Flat reduce fricción al crear páginas nuevas (no decidir carpeta), pero el grafo visual de Obsidian se vuelve denso.
  • Nested da una taxonomía explícita, pero obliga a moverse de carpeta cuando una página no encaja limpiamente en una sola.

En este repo

La plantilla new-project.sh acepta --flat para crear el proyecto plano. Por defecto es nested. La decisión se registra en el CLAUDE.md del proyecto bajo "Decisiones de estructura".

Relaciones