docs(okf): write overview, architecture, decisions and roadmap

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Noel SabiaandClaude Opus 5.5 committed 2026-10-11 14:18:32 +02:00
1 parent 987a5efba1
commit 557ac1985b
20 files changed
+750 -16

No files matched your search

@@ -0,0 +1,18 @@
---
type: Decision
title: Knowledge bundle lives in knowledge/
description: The OKF bundle sits in a subdirectory, not at the repository root.
tags: [decision, okf]
status: stable
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
---
# Decision
The OKF v0.2 bundle lives in `knowledge/`.
# Why
OKF requires frontmatter in every non-reserved `.md` file in the bundle. The
repo root will hold files like `README.md` and release-please's `CHANGELOG.md`
that have none, which would make a root-level bundle non-conformant.