Structuring a bundle

A bundle is a folder of Markdown files published as one versioned unit. Three conventions keep it navigable.

The root index

index.md is the front door. List every concept with a one-line summary, as a Markdown link list. Agents land here first; a complete index means retrieval never misses a concept that exists.

The log

log.md records what changed and why, newest first. Because revisions are immutable snapshots, the log is how readers understand motion between revisions without diffing by hand.

Links and paths

• Use relative links between files in the bundle. They survive re-publishing.
• Keep paths stable across revisions; citations break when files rename.
• One directory of concepts plus reserved files beats deep nesting for almost every team-sized corpus.

Sizing

Small wins. A bundle of five to fifteen single-concept files retrieves faster, cites more precisely, and reviews more easily than a monolith. Split when a file answers two different questions.