--- type: Decision title: Knowledge bundle lives at the repository root description: The repository root is the OKF bundle root; any other markdown file there needs frontmatter to stay conformant. tags: [decision, okf] status: stable generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z } verified: { by: human:noel, at: 2026-10-11T12:15:30Z } --- # Decision The OKF v0.2 bundle root is the repository root. # Consequence OKF requires frontmatter with a `type` in every non-reserved `.md` file in the bundle. Any other markdown at the root breaks conformance unless it carries frontmatter, for example: - `README.md`: give it frontmatter (`type: Readme`) or skip it; `index.md` already does its job. - `CHANGELOG.md` from release-please: release-please writes it without frontmatter. Options: point release-please's `changelog-path` at a non-`.md` file, or accept that one file is non-conformant.