docs: reconcile layered-memory contracts and docs index #110

Merged
clawdie merged 1 commit from docs/layered-memory-reconcile into main 2026-10-06 12:41:47 +02:00
Owner

Follow-up to #109 (docs/layered-memory-authority-lifecycle, merged). The new
contract is accurate, but it landed unwired: its system_ops record-class
list disagreed with layered-memory-fabric.md, and none of the newer plans were
discoverable from the docs index.

Changes

  • docs/README.md — replace the false “every document in this folder” claim
    with an accurate curated-index description, and add the five missing plan rows
    (COLIBRI-SIMPLIFICATION, JEV-DECISION-GATE,
    LAYERED-MEMORY-AUTHORITY-LIFECYCLE, PATH-ENV-IDENTITY-UNIFICATION,
    SYSTEM1-WIKI-INVENTORY).
  • layered-memory-fabric.md — align the system_ops bullet to the canonical
    six record classes in the lifecycle contract (was a divergent
    “freshness, approvals, conflicts, …” list) and link it.
  • LAYERED-MEMORY-AUTHORITY-LIFECYCLE.md — add an explicit scope note that
    system_brain authority is out of scope and remains governed by
    shared-memory-architecture; record co-verification.
  • abbreviations.md — document the system_skills / system_brain /
    system_ops memory planes.
  • quality-gates.md — document okf semantics and clarify that stale_after
    and decision_state are informational annotations (no gate enforces them).

Gates (on the branch)

  • check-format.sh — pass
  • wiki-lint --strict — clean (761 pass / 0 fail; +10 from the new terms/links)
  • check-dates.sh --strict — clean
  • check-okf.sh — advisory exit 0

Targeted last_verified refresh on the five edited files only — no bulk
refresh
(cf. open #105, which is such a bulk refresh).

Closes nothing; prepares the ground for the #104/#105 disposition discussion.

Follow-up to #109 (`docs/layered-memory-authority-lifecycle`, merged). The new contract is accurate, but it landed **unwired**: its `system_ops` record-class list disagreed with `layered-memory-fabric.md`, and none of the newer plans were discoverable from the docs index. ### Changes - **docs/README.md** — replace the false *“every document in this folder”* claim with an accurate curated-index description, and add the five missing plan rows (`COLIBRI-SIMPLIFICATION`, `JEV-DECISION-GATE`, `LAYERED-MEMORY-AUTHORITY-LIFECYCLE`, `PATH-ENV-IDENTITY-UNIFICATION`, `SYSTEM1-WIKI-INVENTORY`). - **layered-memory-fabric.md** — align the `system_ops` bullet to the canonical six record classes in the lifecycle contract (was a divergent “freshness, approvals, conflicts, …” list) and link it. - **LAYERED-MEMORY-AUTHORITY-LIFECYCLE.md** — add an explicit scope note that `system_brain` authority is *out of scope* and remains governed by `shared-memory-architecture`; record co-verification. - **abbreviations.md** — document the `system_skills` / `system_brain` / `system_ops` memory planes. - **quality-gates.md** — document `okf` semantics and clarify that `stale_after` and `decision_state` are informational annotations (no gate enforces them). ### Gates (on the branch) - `check-format.sh` — pass - `wiki-lint --strict` — clean (761 pass / 0 fail; +10 from the new terms/links) - `check-dates.sh --strict` — clean - `check-okf.sh` — advisory exit 0 Targeted `last_verified` refresh on the five edited files only — **no bulk refresh** (cf. open #105, which is such a bulk refresh). Closes nothing; prepares the ground for the #104/#105 disposition discussion.
docs: reconcile layered-memory contracts and docs index
Some checks failed
CI / markdown (pull_request) Successful in 8s
CI / port (pull_request) Successful in 1s
CI / agent-jail-pkgs (pull_request) Successful in 1s
CI / python-tests (pull_request) Successful in 13s
CI / go (pull_request) Successful in 5s
format-check / prettier (pull_request) Successful in 5s
leak-guard / guard (pull_request) Successful in 2s
ci-gate / gate (pull_request) Has been cancelled
16eedfeb2b
- docs/README.md: replace the false "every document in this folder"
  claim with an accurate curated-index description, and list the five
  newer plans (COLIBRI-SIMPLIFICATION, JEV-DECISION-GATE,
  LAYERED-MEMORY-AUTHORITY-LIFECYCLE, PATH-ENV-IDENTITY-UNIFICATION,
  SYSTEM1-WIKI-INVENTORY) so the contracts are discoverable.
- layered-memory-fabric.md: align the system_ops bullet to the six
  record classes in LAYERED-MEMORY-AUTHORITY-LIFECYCLE.md and link that
  contract, replacing the divergent "freshness, approvals, ..." list.
- LAYERED-MEMORY-AUTHORITY-LIFECYCLE.md: add an explicit scope note that
  system_brain authority is out of scope and remains governed by
  shared-memory-architecture.
- abbreviations.md: document the system_skills/system_brain/system_ops
  memory planes.
- quality-gates.md: document okf/stale_after/decision_state semantics;
  stale_after and decision_state are informational, not gate-enforced.

Targeted okf last_verified refresh on the five edited files only (no
bulk refresh). Gates: check-format pass, wiki-lint --strict clean
(761/0), check-dates --strict clean, check-okf advisory exit 0.
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
clawdie/colibri!110
No description provided.