| type | Spec Section | |||
|---|---|---|---|---|
| title | OKF §3 — Bundle Structure | |||
| description | A bundle is a directory tree of markdown files, distributable as a git repo, an archive, or a subdirectory; its internal organization is domain-independent. | |||
| tags |
|
|||
| timestamp | 2026-07-01 |
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.
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.
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.