Bundle Structure
July 31, 2026 · View on GitHub
OKF (§3) defines a bundle as a directory tree of markdown files. There is no manifest, index database, or required tooling — the filesystem is the structure.
Distribution
A bundle MAY be distributed as:
- a git repository (recommended — you get diffs, blame, and PR review for free);
- an archive (tar/zip); or
- a subdirectory of a larger repository.
This repository uses the subdirectory form: the bundle is knowledge/ inside a repo that will
also hold the portable skills.
Organization
The internal organization is domain-independent. Producers arrange concepts into whatever directory hierarchy suits the domain; OKF does not mandate any particular folders. Directories can carry index files to support progressive disclosure, and concepts link freely across directories via cross-links, making the bundle graph-shaped rather than strictly tree-shaped.
The only filename constraints are the two reserved filenames.