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.md MAY 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-DD form.
  • 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.

Citations

  1. OKF Specification (SPEC.md)