core/docs/handoff/BACKLOG-everyday-atoms-grounding-pack.md
Shay 38ef66c2a9 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.
2026-05-29 08:55:08 -07:00

41 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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/<pack_id>/` 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 13 exist, this is an idea, not a pack.