From 38ef66c2a92eff7e2068c998597e5e8d3ee0882e Mon Sep 17 00:00:00 2001 From: Shay Date: Fri, 29 May 2026 08:55:08 -0700 Subject: [PATCH] docs(backlog): capture everyday-atoms grounding pack idea (closed #449) #449 shipped an inert, duplicated, unvalidated pack off-brief; closed it but kept the on-thesis idea (ground the nouns GSM8K problems use) with the real scope it would need to be beneficial. --- .../BACKLOG-everyday-atoms-grounding-pack.md | 41 +++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 docs/handoff/BACKLOG-everyday-atoms-grounding-pack.md diff --git a/docs/handoff/BACKLOG-everyday-atoms-grounding-pack.md b/docs/handoff/BACKLOG-everyday-atoms-grounding-pack.md new file mode 100644 index 00000000..bbde8817 --- /dev/null +++ b/docs/handoff/BACKLOG-everyday-atoms-grounding-pack.md @@ -0,0 +1,41 @@ +# Backlog: everyday-atoms grounding pack (idea, not yet scoped) + +**Source:** closed PR #449 (`atomic_definitions_everyday_v1`), opened off-brief by +the remote connector during the 2026-05-29 ADR-0179 work. Closed as not-mergeable +(inert, structurally duplicated, unvalidated, disconnected from the active arc), +but the *idea* is worth keeping. + +## The idea + +A compact, curated pack of everyday-object atoms — the concrete nouns GSM8K word +problems actually lean on (apples, baskets, boxes, strawberries, coins, …). This +is on-thesis: it gives the engine "more pieces to the puzzle" so it can comprehend +the entities a problem talks about, rather than only counting their numbers. It is +*finding/comprehending better*, not *storing another found answer*. + +## Why #449 as shipped delivered no benefit + +- **Inert** — nothing in `chat/`, `generate/`, `language_packs/`, or `core/` + referenced it; `default = false`, `status = "draft"`. No runtime effect. +- **Duplicated + mislocated** — shipped the same 9 files twice + (`packs/everyday/` *and* `packs/everyday/atomic_definitions_everyday_v1/`), + neither matching the flat `packs//` convention (cf. `packs/en/`). +- **Unvalidated** — never run through the pack gate (`core pack validate`); all + gates `false`; manifest checksums unverified (must hash the bytes on disk). +- **Disconnected** — the math derivation/reader lane does not consume semantic + packs, so even if loaded it would do nothing for GSM8K today. + +## What would make it beneficial (the real scope when it's time) + +1. **One flat, conventional location**: `packs/atomic_definitions_everyday_v1/`. +2. **Passes the pack gate**: probes green, checksums hashing the written bytes, + `validate_pack_dir`/`lift_from_pack` delegation reviewed at the dynamic-validator + trust boundary. +3. **A consuming grounding path**: an ADR that wires everyday-atom grounding into a + comprehension/reader lane that actually reads it (otherwise it's a parked + artifact). Likely adjacent to the ADR-0178 comprehension-guided composer, not to + ADR-0179 extraction. +4. **Curated, not bulk** — keep it compact (CLAUDE.md: no corpus bulk-ingest into + runtime); grow it deterministically with pack tests. + +Until 1–3 exist, this is an idea, not a pack.