From 6feaa6d4305f052529602db4d3eff7d0bcf923f2 Mon Sep 17 00:00:00 2001 From: Hyunchul Kim Date: Wed, 26 Aug 2026 02:46:36 +0900 Subject: [PATCH] docs(adapters): surface ROUTER Q4-vs-Q5 preference tie-break in snippets The thin adapter snippets list `30-context` and `40-memory` as separate one-liners but omit the ROUTER "Preference vs memory" tie-break (99-system/ROUTER.md), so a harness reading only the snippet can route a user preference *body* into 40-memory instead of 30-context. Observed in an adapter-compliance test: a Codex session (snippet-only) misrouted a user preference to 40-memory. Adding one line to each snippet (codex, claude-code, custom) makes the existing ROUTER rule visible at the point of use. No behavior change to the core; snippet clarification only. Co-Authored-By: Claude Opus 4.8 (1M context) --- adapters/claude-code/README.md | 1 + adapters/codex/README.md | 1 + adapters/custom/README.md | 1 + 3 files changed, 3 insertions(+) diff --git a/adapters/claude-code/README.md b/adapters/claude-code/README.md index a6718a8..85f4477 100644 --- a/adapters/claude-code/README.md +++ b/adapters/claude-code/README.md @@ -22,6 +22,7 @@ Knowledge system root: `/path/to/akm` (AKM) - When you need knowledge, context, or procedures, first read AKM `99-system/INDEX.md` and all files in `40-memory/` (both are short) - Lookup: INDEX → layer folder (`20-knowledge` knowledge, `30-context` context, `50-procedures` procedures) - Before saving any knowledge, experience, or procedure, follow the classification tree in `99-system/ROUTER.md`. Never save to arbitrary locations +- Preferences/interpretations about a specific user/org/project are a body in `30-context/` (ROUTER Q4). `40-memory/` holds only a one-line pointer, never the full note (Q4-vs-Q5 tie-break: memory is pointers only) - Before marking durable, public, or high-stakes work complete, select and apply the Tier 0–3 checks in `99-system/VERIFICATION.md` - On task failure or repeated mistakes, follow the Learn Back mapping table in `99-system/LOOP.md`: record under `70-evaluation/` and fix the designated layer - Never modify originals in `10-sources/`. Update `99-system/INDEX.md` when adding or removing notes, and append one line to `99-system/LOG.md` for meaningful changes diff --git a/adapters/codex/README.md b/adapters/codex/README.md index 4b16f26..a735ba8 100644 --- a/adapters/codex/README.md +++ b/adapters/codex/README.md @@ -22,6 +22,7 @@ Knowledge system root: `/path/to/akm` (AKM) - When you need knowledge, context, or procedures, first read AKM `99-system/INDEX.md` and all files in `40-memory/` (both are short) - Lookup: INDEX → layer folder (`20-knowledge` knowledge, `30-context` context, `50-procedures` procedures) - Before saving any knowledge, experience, or procedure, follow the classification tree in `99-system/ROUTER.md`. Never save to arbitrary locations +- Preferences/interpretations about a specific user/org/project are a body in `30-context/` (ROUTER Q4). `40-memory/` holds only a one-line pointer, never the full note (Q4-vs-Q5 tie-break: memory is pointers only) - Before marking durable, public, or high-stakes work complete, select and apply the Tier 0–3 checks in `99-system/VERIFICATION.md` - On task failure or repeated mistakes, follow the Learn Back mapping table in `99-system/LOOP.md`: record under `70-evaluation/` and fix the designated layer - Never modify originals in `10-sources/`. Update `99-system/INDEX.md` when adding or removing notes, and append one line to `99-system/LOG.md` for meaningful changes diff --git a/adapters/custom/README.md b/adapters/custom/README.md index ad1936a..739693f 100644 --- a/adapters/custom/README.md +++ b/adapters/custom/README.md @@ -25,6 +25,7 @@ Knowledge system root: `/path/to/akm` (AKM) - When you need knowledge, context, or procedures, first read AKM `99-system/INDEX.md` and all files in `40-memory/` (both are short) - Lookup: INDEX → layer folder (`20-knowledge` knowledge, `30-context` context, `50-procedures` procedures) - Before saving any knowledge, experience, or procedure, follow the classification tree in `99-system/ROUTER.md`. Never save to arbitrary locations +- Preferences/interpretations about a specific user/org/project are a body in `30-context/` (ROUTER Q4). `40-memory/` holds only a one-line pointer, never the full note (Q4-vs-Q5 tie-break: memory is pointers only) - Before marking durable, public, or high-stakes work complete, select and apply the Tier 0–3 checks in `99-system/VERIFICATION.md` - On task failure or repeated mistakes, follow the Learn Back mapping table in `99-system/LOOP.md`: record under `70-evaluation/` and fix the designated layer - Never modify originals in `10-sources/`. Update `99-system/INDEX.md` when adding or removing notes, and append one line to `99-system/LOG.md` for meaningful changes