Log Files
July 31, 2026 · View on GitHub
OKF (§9) defines log.md as an optional record of a bundle's (or directory's) change
history. It is the second reserved filename and, like index files,
carries no frontmatter.
Changed from v0.1. This section was §7 in v0.1; it is §9 in v0.2. The format is unchanged.
Rules
- A
log.mdMAY appear at any level of the hierarchy. - It is a flat list of date-grouped entries, newest first.
- Date headings MUST use the ISO 8601
YYYY-MM-DDform. - Log entries are prose; leading bold words such as
**Creation**,**Update**,**Deprecation**are conventional, not required — they make entries scannable and greppable.
Format
# Directory Update Log
## 2026-07-01
* **Creation** — Wrote the spec section.
* **Update** — Revised the frontmatter page after re-reading §4.1.
## 2026-06-30
* **Initialization** — Bootstrapped the bundle.
Relation to the LLM Wiki log
In the LLM Wiki pattern the log is the append-only, chronological ledger
of every agent action — ingests, queries filed
back, and lint passes. Consistent entry prefixes make it parseable with
plain unix tools (e.g. grep "^## " log.md | head). This bundle's log follows the OKF
form. The rule of thumb inherited from the pattern: the log is append-only — never edit or
delete existing entries.