The repository root is the OKF bundle root; any other markdown file there needs frontmatter to stay conformant.
decision
okf
stable
by
at
claude-code/claude-opus-5-5
2026-10-11T12:15:30Z
by
at
human:noel
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.