Knowledge bundle depth scales with folder size, ceiling 5

Folder depth adaptive: flat for tiny, 5 levels for big

Depth scales with folder size, ceiling 5

Decision

Depth tracks the L1 folder’s file count. Apply the deepest tier the folder qualifies for; never exceed 5.

index.md exists at every level and lists only direct children.

Why

A grep / glob / read should pull one concept, not a 30-file category dump. Minimum context = minimum tokens = sharper agent attention.

Forcing 5 levels everywhere (the rejected earlier rule) bloats tiny folders with empty pass-through subdirs. Letting depth float with size keeps the bottom of the tree tight in big areas and flat in small ones. Same property — minimum leaf — without the make-work.

Implementation

• When an L_n grows past ~15 siblings, split into multiple L_n peers. Don’t add a deeper L_{n+1} unless the whole L1 has crossed its next threshold.
• Touch-and-deepen migration: when editing a file, move it to the depth its parent now warrants. No big-bang rewrites.
• The _okf.md table is the source of truth; this file explains why.

Edit on GitHub · Back to index