From 7a6556e8527073d03cff444fc16e8a0c8993cf6c Mon Sep 17 00:00:00 2001 From: Shay Date: Sun, 19 Jul 2026 14:46:47 -0700 Subject: [PATCH] docs(paradigm): retire six competing unratified problem-solving paradigms under ADR-0252 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Archive the six competing, unratified problem-solving-paradigm formulations (semantic-substrate master plan, state-transition blueprint, binding-graph proposal, capability roadmap v2, eight sprint lookbacks, and ADR-0174's deprecated dispatch prescription) to docs/paradigm-archive/, each prefixed with a SUPERSEDED header. ADR-0164 and ADR-0174 stay in place (Accepted, permanent record) with a Superseded-by: ADR-0252 line added. ADR-0252 itself is a decision record only — it records the retirement and reserves the governing paradigm content for a separate, human-led step. No code changes; no behavior changes. --- ...R-0164-incremental-comprehension-reader.md | 1 + .../ADR-0174-held-hypothesis-comprehension.md | 1 + ...-problem-solving-paradigm-consolidation.md | 89 +++++++++++++++++++ .../SEMANTIC-STATE-TRANSITION-BLUEPRINT.md | 2 + ...olving-capability-roadmap-v2-2026-06-17.md | 2 + ...y-paradigm-sprint10-lookback-2026-06-17.md | 2 + ...y-paradigm-sprint11-lookback-2026-06-17.md | 2 + ...y-paradigm-sprint12-lookback-2026-06-17.md | 2 + ...ty-paradigm-sprint5-lookback-2026-06-17.md | 2 + ...ty-paradigm-sprint6-lookback-2026-06-17.md | 2 + ...ty-paradigm-sprint7-lookback-2026-06-17.md | 2 + ...ty-paradigm-sprint8-lookback-2026-06-17.md | 2 + ...ty-paradigm-sprint9-lookback-2026-06-17.md | 2 + ...-problem-solving-master-plan-2026-06-20.md | 2 + ...emantic-symbolic-binding-graph-proposal.md | 2 + 15 files changed, 115 insertions(+) create mode 100644 docs/adr/ADR-0252-problem-solving-paradigm-consolidation.md rename docs/{handoffs => paradigm-archive}/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md (99%) rename docs/{analysis => paradigm-archive}/core-problem-solving-capability-roadmap-v2-2026-06-17.md (98%) rename docs/{analysis => paradigm-archive}/gsm8k-capability-paradigm-sprint10-lookback-2026-06-17.md (98%) rename docs/{analysis => paradigm-archive}/gsm8k-capability-paradigm-sprint11-lookback-2026-06-17.md (99%) rename docs/{analysis => paradigm-archive}/gsm8k-capability-paradigm-sprint12-lookback-2026-06-17.md (99%) rename docs/{analysis => paradigm-archive}/gsm8k-capability-paradigm-sprint5-lookback-2026-06-17.md (98%) rename docs/{analysis => paradigm-archive}/gsm8k-capability-paradigm-sprint6-lookback-2026-06-17.md (98%) rename docs/{analysis => paradigm-archive}/gsm8k-capability-paradigm-sprint7-lookback-2026-06-17.md (98%) rename docs/{analysis => paradigm-archive}/gsm8k-capability-paradigm-sprint8-lookback-2026-06-17.md (98%) rename docs/{analysis => paradigm-archive}/gsm8k-capability-paradigm-sprint9-lookback-2026-06-17.md (98%) rename docs/{analysis => paradigm-archive}/semantic-substrate-problem-solving-master-plan-2026-06-20.md (99%) rename docs/{implementation => paradigm-archive}/semantic-symbolic-binding-graph-proposal.md (99%) diff --git a/docs/adr/ADR-0164-incremental-comprehension-reader.md b/docs/adr/ADR-0164-incremental-comprehension-reader.md index e56ea423..c97cd3d7 100644 --- a/docs/adr/ADR-0164-incremental-comprehension-reader.md +++ b/docs/adr/ADR-0164-incremental-comprehension-reader.md @@ -1,6 +1,7 @@ # ADR-0164 — Incremental Comprehension Reader (replaces regex sentence-template parsing) **Status:** Accepted (ratified by ADR-0207, 2026-06-03) — Phase 1+2 shipped; remainder per ADR-0207 §5 +**Superseded-by:** ADR-0252 (problem-solving paradigm consolidation, 2026-07-19) — this ADR remains Accepted as the permanent record; the six unratified paradigm docs are retired under ADR-0252, not this ADR itself. **Date:** 2026-05-26 **Author:** Shay **Anchor:** [[thesis-decoding-not-generating]] diff --git a/docs/adr/ADR-0174-held-hypothesis-comprehension.md b/docs/adr/ADR-0174-held-hypothesis-comprehension.md index 37749c30..af70f4c5 100644 --- a/docs/adr/ADR-0174-held-hypothesis-comprehension.md +++ b/docs/adr/ADR-0174-held-hypothesis-comprehension.md @@ -1,6 +1,7 @@ # ADR-0174 — Held-Hypothesis Comprehension with Lookback and In-Loop Contemplation **Status:** Accepted (ratified by ADR-0207, 2026-06-03) +**Superseded-by:** ADR-0252 (problem-solving paradigm consolidation, 2026-07-19) — this ADR remains Accepted as the permanent record; the six unratified paradigm docs are retired under ADR-0252, not this ADR itself. **Date:** 2026-05-28 **Author:** Shay **Anchor:** [[thesis-decoding-not-generating]] diff --git a/docs/adr/ADR-0252-problem-solving-paradigm-consolidation.md b/docs/adr/ADR-0252-problem-solving-paradigm-consolidation.md new file mode 100644 index 00000000..34b0f2c2 --- /dev/null +++ b/docs/adr/ADR-0252-problem-solving-paradigm-consolidation.md @@ -0,0 +1,89 @@ +# ADR-0252: Problem-Solving Paradigm Consolidation — Retire Six Competing Unratified Formulations + +**Status**: Accepted — this ADR is a **decision record only**. It records that the six paradigm +formulations below are retired and archived, and that a single governing comprehension-and-solving +paradigm will be authored under this same ADR number as a separate, human-led step. **This ADR does +not itself define that paradigm.** +**Date**: 2026-07-19 +**Deciders**: Joshua Shay (ruling authority) + Claude (consolidation executor, this pass) +**Related**: ADR-0164 (Incremental Comprehension Reader — Accepted, unmoved, annotated +`Superseded-by: ADR-0252` per this decision), ADR-0174 (Held-Hypothesis Comprehension — Accepted, +unmoved, annotated `Superseded-by: ADR-0252` per this decision), ADR-0243/0249/0250/0251 (current, +unaffected — see §3) +**Companion doc**: `docs/research/paradigm-deadcode-audit-2026-07-19.md` (the dead-code audit this +consolidation performed) + +--- + +## 1. Context — six competing, unratified paradigm documents + +Between 2026-06-17 and 2026-06-20 the repository accumulated six distinct, mutually-competing +problem-solving-paradigm formulations, none of which was ever ratified as an ADR. They sat alongside +each other in `docs/analysis/`, `docs/handoffs/`, and `docs/implementation/`, each proposing a +different shape for "how CORE should comprehend and solve a problem": + +1. **Semantic-substrate master plan** — + `docs/analysis/semantic-substrate-problem-solving-master-plan-2026-06-20.md` +2. **Semantic state-transition blueprint** — + `docs/handoffs/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md` +3. **Semantic/symbolic binding-graph proposal** — + `docs/implementation/semantic-symbolic-binding-graph-proposal.md` +4. **Problem-solving capability roadmap v2** — + `docs/analysis/core-problem-solving-capability-roadmap-v2-2026-06-17.md` +5. **GSM8K capability-paradigm sprint lookbacks** (eight dated retrospectives, one formulation + iterated sprint-to-sprint) — + `docs/analysis/gsm8k-capability-paradigm-sprint{5,6,7,8,9,10,11,12}-lookback-2026-06-17.md` +6. **ADR-0174's deprecated in-ADR dispatch prescription** — the per-category injector dispatch table + and legacy-regex-parser fallback that ADR-0174 itself marked `Deprecates:` in its header (see + ADR-0174 §Deprecates). ADR-0174 as a whole remains Accepted; only this specific dispatch + prescription is superseded. + +None of formulations 1–5 was ever promoted to ADR status. They were parallel, competing drafts — +none governing, none ratified, several mutually inconsistent about what "comprehension" and "solving" +should mean architecturally. Carrying six live-looking documents that read as authoritative but were +never ruled on is a standing hazard: a future reader (human or agent) has no way to tell which one, if +any, is load-bearing. + +## 2. Decision + +Retire all six formulations. Move documents 1–5 (ten files total, including the eight sprint +lookbacks) to `docs/paradigm-archive/`, each prefixed with: + +``` +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. +``` + +They are preserved for historical reference (the sprint lookbacks in particular record real, +verified measurement history) but carry no governance weight. + +Formulation 6 (ADR-0174's deprecated dispatch prescription) is handled differently because ADR-0174 +is itself an Accepted ADR and a permanent record: it is **not moved**. Instead, both ADR-0164 (the +parent ADR) and ADR-0174 receive a `**Superseded-by:** ADR-0252` line in their header, alongside their +existing `Status: Accepted`, to make the relationship explicit without rewriting history. + +A single governing comprehension-and-solving paradigm will be authored under this ADR number, +**as a separate, human-led step** — not as part of this consolidation pass. See §4. + +## 3. What this decision does NOT touch + +This is a documentation-retirement decision plus a dead-code cleanup pass (audited separately in +`docs/research/paradigm-deadcode-audit-2026-07-19.md`). It does not change runtime behavior: the +serving reader's `wrong=0` and the full smoke/test/holdout numbers are required to be byte-identical +before and after every code removal performed under this consolidation (see the companion audit doc +for the baseline and post-removal numbers). + +Explicitly unaffected and not superseded by this ADR: + +- ADR-0243 (propositional falsifier), ADR-0249 (reader→Hamiltonian compiler composition frontier), + ADR-0250 (tier-2 multi-entity arithmetic), ADR-0251 (reader-arc recalibration) — all current and + standing. +- The `#77`/`#78` compare-multiplicative compiler tier and `NEUTRAL_COUNT_VERBS` positive-polarity + foundations. +- Any module proven live by the companion dead-code audit (importers, test coverage, or ADR + reference found) — those stay, even if a retired document originally proposed or referenced them. + +## 4. The paradigm — TO BE AUTHORED (human-led) + +This section is an explicit placeholder. The single governing comprehension-and-solving paradigm that +formulations 1–6 were each independently groping toward has not been authored. It is out of scope for +this consolidation pass and is reserved for a separate, human-led step under this same ADR number. diff --git a/docs/handoffs/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md b/docs/paradigm-archive/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md similarity index 99% rename from docs/handoffs/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md rename to docs/paradigm-archive/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md index 438fba1a..4a75a3a7 100644 --- a/docs/handoffs/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md +++ b/docs/paradigm-archive/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # Semantic State Transition Blueprint **Status:** development blueprint / handoff document diff --git a/docs/analysis/core-problem-solving-capability-roadmap-v2-2026-06-17.md b/docs/paradigm-archive/core-problem-solving-capability-roadmap-v2-2026-06-17.md similarity index 98% rename from docs/analysis/core-problem-solving-capability-roadmap-v2-2026-06-17.md rename to docs/paradigm-archive/core-problem-solving-capability-roadmap-v2-2026-06-17.md index fa4eb2dc..59f67292 100644 --- a/docs/analysis/core-problem-solving-capability-roadmap-v2-2026-06-17.md +++ b/docs/paradigm-archive/core-problem-solving-capability-roadmap-v2-2026-06-17.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # CORE Problem-Solving Capability Roadmap v2 — 2026-06-17 **Status:** Living document (post-Gate-A1 calibration update) diff --git a/docs/analysis/gsm8k-capability-paradigm-sprint10-lookback-2026-06-17.md b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint10-lookback-2026-06-17.md similarity index 98% rename from docs/analysis/gsm8k-capability-paradigm-sprint10-lookback-2026-06-17.md rename to docs/paradigm-archive/gsm8k-capability-paradigm-sprint10-lookback-2026-06-17.md index 7b1a007f..5fc9d31c 100644 --- a/docs/analysis/gsm8k-capability-paradigm-sprint10-lookback-2026-06-17.md +++ b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint10-lookback-2026-06-17.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # GSM8K Capability Paradigm Sprint 10 — Lookback (2026-06-17) ## 1. Starting baseline diff --git a/docs/analysis/gsm8k-capability-paradigm-sprint11-lookback-2026-06-17.md b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint11-lookback-2026-06-17.md similarity index 99% rename from docs/analysis/gsm8k-capability-paradigm-sprint11-lookback-2026-06-17.md rename to docs/paradigm-archive/gsm8k-capability-paradigm-sprint11-lookback-2026-06-17.md index 1e83cf25..3fc75362 100644 --- a/docs/analysis/gsm8k-capability-paradigm-sprint11-lookback-2026-06-17.md +++ b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint11-lookback-2026-06-17.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # GSM8K Capability Paradigm Sprint 11 — Lookback (2026-06-17) ## 1. Starting baseline diff --git a/docs/analysis/gsm8k-capability-paradigm-sprint12-lookback-2026-06-17.md b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint12-lookback-2026-06-17.md similarity index 99% rename from docs/analysis/gsm8k-capability-paradigm-sprint12-lookback-2026-06-17.md rename to docs/paradigm-archive/gsm8k-capability-paradigm-sprint12-lookback-2026-06-17.md index 2ae5aff3..fec45ba2 100644 --- a/docs/analysis/gsm8k-capability-paradigm-sprint12-lookback-2026-06-17.md +++ b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint12-lookback-2026-06-17.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # GSM8K Capability Paradigm Sprint 12 — Lookback (2026-06-17) ## 1. Starting baseline diff --git a/docs/analysis/gsm8k-capability-paradigm-sprint5-lookback-2026-06-17.md b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint5-lookback-2026-06-17.md similarity index 98% rename from docs/analysis/gsm8k-capability-paradigm-sprint5-lookback-2026-06-17.md rename to docs/paradigm-archive/gsm8k-capability-paradigm-sprint5-lookback-2026-06-17.md index 0117bd54..b3b60bf6 100644 --- a/docs/analysis/gsm8k-capability-paradigm-sprint5-lookback-2026-06-17.md +++ b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint5-lookback-2026-06-17.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # GSM8K Capability Paradigm Sprint 5 — Lookback (2026-06-17) ## 1. Starting baseline diff --git a/docs/analysis/gsm8k-capability-paradigm-sprint6-lookback-2026-06-17.md b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint6-lookback-2026-06-17.md similarity index 98% rename from docs/analysis/gsm8k-capability-paradigm-sprint6-lookback-2026-06-17.md rename to docs/paradigm-archive/gsm8k-capability-paradigm-sprint6-lookback-2026-06-17.md index a4598e05..6f950e3a 100644 --- a/docs/analysis/gsm8k-capability-paradigm-sprint6-lookback-2026-06-17.md +++ b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint6-lookback-2026-06-17.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # GSM8K Capability Paradigm Sprint 6 — Lookback (2026-06-17) ## 1. Starting baseline diff --git a/docs/analysis/gsm8k-capability-paradigm-sprint7-lookback-2026-06-17.md b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint7-lookback-2026-06-17.md similarity index 98% rename from docs/analysis/gsm8k-capability-paradigm-sprint7-lookback-2026-06-17.md rename to docs/paradigm-archive/gsm8k-capability-paradigm-sprint7-lookback-2026-06-17.md index 7911676d..5c667beb 100644 --- a/docs/analysis/gsm8k-capability-paradigm-sprint7-lookback-2026-06-17.md +++ b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint7-lookback-2026-06-17.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # GSM8K Capability Paradigm Sprint 7 — Lookback (2026-06-17) ## 1. Starting baseline diff --git a/docs/analysis/gsm8k-capability-paradigm-sprint8-lookback-2026-06-17.md b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint8-lookback-2026-06-17.md similarity index 98% rename from docs/analysis/gsm8k-capability-paradigm-sprint8-lookback-2026-06-17.md rename to docs/paradigm-archive/gsm8k-capability-paradigm-sprint8-lookback-2026-06-17.md index 5d58d851..6575e449 100644 --- a/docs/analysis/gsm8k-capability-paradigm-sprint8-lookback-2026-06-17.md +++ b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint8-lookback-2026-06-17.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # GSM8K Capability Paradigm Sprint 8 — Lookback (2026-06-17) ## 1. Starting baseline diff --git a/docs/analysis/gsm8k-capability-paradigm-sprint9-lookback-2026-06-17.md b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint9-lookback-2026-06-17.md similarity index 98% rename from docs/analysis/gsm8k-capability-paradigm-sprint9-lookback-2026-06-17.md rename to docs/paradigm-archive/gsm8k-capability-paradigm-sprint9-lookback-2026-06-17.md index fb7ccc86..0a1ec525 100644 --- a/docs/analysis/gsm8k-capability-paradigm-sprint9-lookback-2026-06-17.md +++ b/docs/paradigm-archive/gsm8k-capability-paradigm-sprint9-lookback-2026-06-17.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # GSM8K Capability Paradigm Sprint 9 — Lookback (2026-06-17) ## 1. Starting baseline diff --git a/docs/analysis/semantic-substrate-problem-solving-master-plan-2026-06-20.md b/docs/paradigm-archive/semantic-substrate-problem-solving-master-plan-2026-06-20.md similarity index 99% rename from docs/analysis/semantic-substrate-problem-solving-master-plan-2026-06-20.md rename to docs/paradigm-archive/semantic-substrate-problem-solving-master-plan-2026-06-20.md index 189379cf..a2e6445a 100644 --- a/docs/analysis/semantic-substrate-problem-solving-master-plan-2026-06-20.md +++ b/docs/paradigm-archive/semantic-substrate-problem-solving-master-plan-2026-06-20.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # Semantic-Substrate Problem-Solving Master Plan — 2026-06-20 **Status:** proposed implementation plan for architect ratification diff --git a/docs/implementation/semantic-symbolic-binding-graph-proposal.md b/docs/paradigm-archive/semantic-symbolic-binding-graph-proposal.md similarity index 99% rename from docs/implementation/semantic-symbolic-binding-graph-proposal.md rename to docs/paradigm-archive/semantic-symbolic-binding-graph-proposal.md index d7f77217..828aa1a1 100644 --- a/docs/implementation/semantic-symbolic-binding-graph-proposal.md +++ b/docs/paradigm-archive/semantic-symbolic-binding-graph-proposal.md @@ -1,3 +1,5 @@ +> SUPERSEDED 2026-07-19 — consolidated under ADR-0252. Archived, not governing. + # Semantic-Symbolic Binding Graph Proposal **Status:** Proposed architecture direction