From b93af307502b2ad13cf75bf928f46216803f4331 Mon Sep 17 00:00:00 2001 From: Defame1297 Date: Mon, 17 Aug 2026 10:06:26 +0000 Subject: [PATCH] docs: fix a wrong pointer and two stale claims in CONTEXT.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Why: CONTEXT.md is an instructed every-session read, so a wrong assertion in it is cited downstream without being checked. The b9c7762 rewrite introduced one broken pointer and carried over two claims that were already false. Implementation notes: - The Preload tax entry pointed at docs/spec/gates.md for the measurement method. gates.md has no such method — it uses the 23,427-char figure once, in passing, without deriving it. The method and the current figure both live in ADR-0020, which is where a dated measurement belongs: it is superseded there deliberately, and issue #99 tracks its drift. - Dropped the "~5,900 tokens across 39 skills" measurement rather than re-measuring it. It was already wrong three days after being written (~5,340 today) and it was the only live number in the file. Every sibling entry is one definitional sentence plus a pointer fragment; this one now matches, and CONTEXT-FORMAT.md:43 asks for exactly that. - Dropped "Written by the session-handoff skill or directly by the human" from the LESSONS.md entry. No session-handoff skill exists — LESSONS.md:7 records it as planned work. Who writes a file is not its definition. Impact: removes the only rot surface in the file and the only assertion in it that names an artifact the repo does not have. Refs: #99 --- CONTEXT.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/CONTEXT.md b/CONTEXT.md index ba247c5..272dc6c 100644 --- a/CONTEXT.md +++ b/CONTEXT.md @@ -16,8 +16,8 @@ decisions. **Preload tax**: The always-on context cost of every installed skill's `name` and `description`, charged from the -first token of every session whether the skill is invoked or not. Measured 2026-08-14 at ~5,900 -tokens across 39 skills; method in `docs/spec/gates.md`. +first token of every session whether the skill is invoked or not. Measurement method and current +figure: ADR-0020. _Avoid_: context cost, token overhead **Skill context contract**: @@ -114,8 +114,7 @@ content of its own (ADR-0002, ADR-0003). _Avoid_: wrapper, shim, provider file **LESSONS.md**: -The long-loop feedback log for patterns observed across sessions, at the repo root. Written by the -session-handoff skill or directly by the human. +The long-loop feedback log for patterns observed across sessions, at the repo root. _Avoid_: changelog, retro, postmortem **Management Application**: