From de1d6209c372a19e437ce211902b4b6ab1e185f5 Mon Sep 17 00:00:00 2001 From: Shay Date: Tue, 30 Jun 2026 16:51:23 -0700 Subject: [PATCH] docs: reorganize docs landscape per master plan --- docs/README.md | 28 + .../ADR-0001-vocab-layer-invariants.md | 0 .../ADR-0002-ingest-layer-design.md | 0 .../ADR-0003-coordinate-system-dissolution.md | 0 ...ADR-0004-rotor-as-operator-not-property.md | 0 .../ADR-0005-language-pack-contract.md | 0 .../ADR-0006-field-energy-operator.md | 0 .../ADR-0007-valence-layer.md | 0 .../ADR-0008-allocation-physics.md | 0 .../ADR-0009-compositional-physics.md | 0 .../ADR-0010-identity-physics.md | 0 docs/{decisions => adr}/ADR-0011-renderer.md | 0 .../ADR-0012-core-ingest-governance-layer.md | 0 .../ADR-0013-sensorium-multimodal-protocol.md | 0 .../ADR-0014-train-learning-loop.md | 0 ...5-language-packs-and-holonomy-resonance.md | 0 .../ADR-0016-capability-roadmap.md | 0 .../ADR-0017-agency-scope.md | 0 .../ADR-0018-tool-use-scope.md | 0 ...DR-0019-exact-vault-recall-acceleration.md | 0 .../ADR-0020-phase5-rust-parity-sequencing.md | 0 .../ADR-0021-epistemic-grade-policy.md | 0 .../ADR-0022-forward-semantic-control.md | 0 ...ADR-0023-forward-semantic-control-proof.md | 0 .../ADR-0024-inner-loop-admissibility.md | 0 ...5-rotor-frame-admissibility-design-note.md | 0 ...R-0026-ranked-admissibility-with-margin.md | 0 .../ADR-0027-identity-packs.md | 0 .../ADR-0028-identity-surface-wiring.md | 0 .../ADR-0029-safety-packs.md | 0 .../ADR-0030-depth-language-hedge.md | 0 .../ADR-0031-score-decomposition-surface.md | 0 .../ADR-0032-safety-check-surface.md | 0 .../ADR-0033-ethics-packs.md | 0 .../ADR-0034-ethics-check-surface.md | 0 .../ADR-0035-turn-loop-verdict-surfacing.md | 0 .../ADR-0036-safety-refusal-policy.md | 0 .../ADR-0037-per-predicate-ethics-refusal.md | 0 .../ADR-0038-hedge-injection.md | 0 .../ADR-0039-audit-completeness.md | 0 .../ADR-0040-telemetry-sink.md | 0 .../ADR-0041-cli-verdicts-and-fanout.md | 0 .../ADR-0042-audit-tour-demo.md | 0 .../ADR-0043-pack-measurements-phase2.md | 0 .../ADR-0044-medical-clinical-ethics-pack.md | 0 ...context-recall-vs-transformer-baselines.md | 0 .../ADR-0046-forward-graph-constraint.md | 0 .../ADR-0047-wire-forward-graph-constraint.md | 0 .../ADR-0048-pack-grounded-surface.md | 0 .../ADR-0049-intent-subject-extraction.md | 0 .../ADR-0050-pack-grounded-comparison.md | 0 .../ADR-0051-trust-boundary-hardening.md | 0 .../ADR-0052-teaching-grounded-surface.md | 0 .../ADR-0053-cognition-lane-closure.md | 0 ...ADR-0054-vault-recall-indexing-batching.md | 0 ...nter-session-memory-discovery-promotion.md | 0 .../ADR-0056-contemplation-loop-c1.md | 0 ...ADR-0057-teaching-chain-proposal-review.md | 0 ...DR-0058-forward-graph-constraint-status.md | 0 .../ADR-0059-correction-pass-telemetry.md | 0 ...0-correction-acknowledgment-topic-lemma.md | 0 ...-procedure-intent-pack-grounded-surface.md | 0 ...0062-composed-teaching-grounded-surface.md | 0 .../ADR-0063-cross-pack-surface-resolver.md | 0 .../ADR-0064-cross-pack-teaching-chains.md | 0 .../ADR-0065-oov-gradient-and-relations-v2.md | 0 .../ADR-0066-turn-level-composition.md | 0 .../ADR-0067-cross-pack-teaching-chains.md | 0 .../ADR-0068-register-pack-class.md | 0 .../ADR-0069-realizer-register-parameter.md | 0 .../ADR-0070-register-pack-terse-v1.md | 0 .../ADR-0071-seeded-surface-variation.md | 0 ...072-register-telemetry-operator-surface.md | 0 .../ADR-0073-anchor-lens-substrate.md | 0 .../ADR-0073a-anchor-lens-content-phase.md | 0 .../ADR-0073b-anchor-lens-class-loader.md | 0 .../ADR-0073c-anchor-lens-composer-wiring.md | 0 .../ADR-0073d-anchor-lens-telemetry-tour.md | 0 .../ADR-0074-orthogonality-tour.md | 0 .../ADR-0075-realizer-slot-type-guard.md | 0 ...ADR-0076-confirmation-tag-normalization.md | 0 .../ADR-0077-substantive-register-knobs.md | 0 ...DR-0078-composer-graph-atom-equivalence.md | 0 .../ADR-0078-phase1-implementation-note.md | 0 .../ADR-0080-contemplation-loop.md | 0 .../ADR-0083-transitive-chain-surface.md | 0 .../ADR-0084-definitional-layer.md | 0 .../ADR-0085-gloss-aware-cause.md | 0 .../ADR-0087-rhetorical-style-axis.md | 0 .../ADR-0091-domain-pack-contract-v1.md | 0 .../ADR-0092-reviewer-registry-v1.md | 0 ...-domain-pack-contract-v1-implementation.md | 0 .../ADR-0094-proposal-source-provenance.md | 0 ...R-0095-miner-sourced-teaching-proposals.md | 0 .../ADR-0096-fabrication-control-eval-lane.md | 0 ...cs-logic-reasoning-capable-ratification.md | 0 .../ADR-0098-demo-composition-contract.md | 0 .../ADR-0099-public-showcase-demo.md | 0 ...-physics-reasoning-capable-ratification.md | 0 ...software-reasoning-capable-ratification.md | 0 ...ew-greek-reasoning-capable-ratification.md | 0 ...03-fluency-lane-attachment-for-adr-0102.md | 0 ...4-curriculum-sourced-teaching-proposals.md | 0 .../ADR-0105-sealed-holdout-encryption.md | 0 ...ADR-0106-expert-demo-promotion-contract.md | 0 ...-mathematics-logic-expert-demo-deferred.md | 0 .../ADR-0108-proposed-adr-sequencing.md | 0 .../ADR-0109-lane-shape-aware-thresholds.md | 0 ...mathematics-logic-expert-demo-promotion.md | 0 .../ADR-0111-physics-expert-demo-promotion.md | 0 .../ADR-0112-runnable-expert-demo-showcase.md | 0 ...0113-rename-expert-demo-to-audit-passed.md | 0 ...4-expert-capability-roadmap-gsm8k-first.md | 0 ...114a-anti-overfitting-proof-obligations.md | 0 .../ADR-0114a.10-pack-provenance-auditor.md | 0 .../ADR-0114a.2-ood-ratio-auditor.md | 0 .../ADR-0114a.5-perturbation-suite.md | 0 .../ADR-0114a.6-depth-curve-auditor.md | 0 .../ADR-0114a.8-adversarial-auditor.md | 0 .../ADR-0115-math-problem-parser-and-graph.md | 0 .../ADR-0116-deterministic-solver.md | 0 .../ADR-0117-solution-trace-verifier.md | 0 .../ADR-0118-stepped-realizer.md | 0 .../ADR-0118a-ood-surface-generator.md | 0 .../ADR-0119-gsm8k-eval-lane-roadmap.md | 0 ...19.1-sealed-holdout-fabrication-control.md | 0 ...ADR-0119.2-gsm8k-eval-corpus-dev-public.md | 0 .../ADR-0119.3-lane-runner.md | 0 ...ADR-0119.4-frontier-baseline-comparison.md | 0 .../ADR-0119.5-adversarial-generation.md | 0 .../ADR-0119.6-depth-curve-harness.md | 0 .../ADR-0119.7-sealed-gsm8k-test.md | 0 .../ADR-0119.8-lane-gate.md | 0 .../ADR-0120-expert-promotion-contract.md | 0 .../ADR-0120-math-expert-ledger-flip.md | 0 .../ADR-0120-math-expert-promotion-wireup.md | 0 ...-0121-mathematics-logic-expert-deferred.md | 0 .../ADR-0122-parser-rate-per-unit.md | 0 ...-systems-software-audit-passed-deferred.md | 0 .../ADR-0123-parser-comparison-phrasing.md | 0 .../ADR-0123-symbolic-logic-shape-remap.md | 0 .../ADR-0123a-inference-shape-synonym.md | 0 ...systems-software-audit-passed-promotion.md | 0 ...-reasoning-isolation-perturbation-suite.md | 0 .../ADR-0126-candidate-graph-parser.md | 0 .../ADR-0127-0128-RESULTS.md | 0 ...-0127-units-pack-and-units-aware-parser.md | 0 .../ADR-0128-numerics-pack.md | 0 ...-0129-spaced-correction-replay-deferred.md | 0 ...0-pre-articulation-calibration-deferred.md | 0 .../ADR-0131-math-expert-rebench.md | 0 ...R-0131.1.F-frontier-baseline-comparison.md | 0 .../ADR-0131.1.S-sealed-holdout.md | 0 .../ADR-0131.2-teaching-corpus-eval.md | 0 ...ADR-0131.2.B-teaching-corpus-enrichment.md | 0 .../ADR-0131.3-bounded-grammar.md | 0 .../ADR-0131.4-composite-math-gate.md | 0 .../ADR-0131.5-gsm8k-probe-retirement.md | 0 .../ADR-0131.G-gsm8k-coverage-probe.md | 0 .../ADR-0131.G.0-probe-substrate.md | 0 ...ADR-0131.G.1-verb-classes-initial-state.md | 0 .../ADR-0131.G.2-comparatives.md | 0 .../ADR-0131.G.3-numerics.md | 0 .../ADR-0131.G.3.1-numerics-extensions.md | 0 .../ADR-0131.G.4-multi-clause.md | 0 ...R-0131.G.5-aggregate-answer-composition.md | 0 .../ADR-0132-binding-graph-data-model.md | 0 .../ADR-0133-binding-graph-adapter.md | 0 .../ADR-0134-binding-graph-admissibility.md | 0 .../ADR-0135-binding-graph-question-target.md | 0 .../ADR-0136-statement-layer-corridor.md | 0 .../ADR-0136.S.1-rate-event-statements.md | 0 .../ADR-0136.S.2-conditional-op-question.md | 0 .../ADR-0136.S.4-novel-initial-form.md | 0 .../ADR-0136.S2-post-rescan.md | 0 .../ADR-0136.S3-compound-initial-mutation.md | 0 .../ADR-0136.S3-post-rescan.md | 0 .../ADR-0138-comparative-reference-layer.md | 0 .../ADR-0139-arithmetic-as-versor-spike.md | 0 .../ADR-0140-core-trace-protocol-v0.md | 0 ...140-subtract-and-additive-group-closure.md | 0 ...41-multiply-as-dilator-positive-nonzero.md | 0 .../ADR-0142-epistemic-state-taxonomy.md | 0 ...0143-recognition-spike-anti-unification.md | 0 ...144-proposition-graph-epistemic-carrier.md | 0 ...-0145-energy-modulated-surface-readback.md | 0 ...146-l10-hybrid-engine-state-persistence.md | 0 .../ADR-0148-vault-promotion-policy-wiring.md | 0 ...0149-derived-recognizer-pipeline-wiring.md | 0 ...-autonomous-inter-session-contemplation.md | 0 .../ADR-0151-auto-proposal-pipeline.md | 0 .../ADR-0152-learning-arc-demo.md | 0 ...DR-0153-turn-event-trace-hash-backstamp.md | 0 .../ADR-0154-recognizer-producer-wiring.md | 0 .../ADR-0155-ci-contemplation-runner.md | 0 ...ADR-0156-atomic-engine-state-checkpoint.md | 0 .../ADR-0157-revision-mismatch-warning.md | 0 .../ADR-0158-reboot-event-audit.md | 0 .../ADR-0159-contemplation-quality-eval.md | 0 .../ADR-0160-core-workbench-v1.md | 0 .../ADR-0161-hitl-async-queue.md | 0 .../ADR-0162-workbench-design-system.md | 0 .../ADR-0163-F2-confuser-corpus-spec.md | 0 .../ADR-0163-gsm8k-path-to-mastery.md | 0 ...R-0164-incremental-comprehension-reader.md | 0 .../ADR-0164.1-lexical-primitive-scope.md | 0 .../ADR-0164.2-pronoun-entity-resolution.md | 0 .../ADR-0164.3-cross-sentence-state.md | 0 ...DR-0164.4-phase2-statement-frame-reader.md | 0 .../ADR-0165-regex-scope-rule.md | 0 ...-0166-measurement-capability-sequencing.md | 0 .../ADR-0167-audit-as-teaching-evidence.md | 0 .../ADR-0168-frameclaim-ratification.md | 0 ...0168.1-math-frameclaim-proposal-adapter.md | 0 .../ADR-0169-compositionclaim-ratification.md | 0 ...-math-compositionclaim-proposal-adapter.md | 0 .../ADR-0170-injector-contract-widening.md | 0 ...172-math-corpus-decomposition-mechanism.md | 0 ...3-workbench-ratification-trust-boundary.md | 0 .../ADR-0174-held-hypothesis-comprehension.md | 0 ...librated-attempt-and-eliminate-learning.md | 0 ...ultistep-composition-question-targeting.md | 0 .../ADR-0177-cue-precision-learning.md | 0 ...R-0178-GB3b-referent-accumulation-scope.md | 0 .../ADR-0178-compositional-structure.md | 0 .../ADR-0179-extraction-richness.md | 0 ...ADR-0180-crdt-sharded-vault-concurrency.md | 0 .../ADR-0181-audio-compiler-delta-crdt.md | 0 ...182-cross-composer-disagreement-pooling.md | 0 .../ADR-0183-lawful-audio-lexeme-path.md | 0 .../ADR-0184-distinct-unit-product-rule.md | 0 ...-0184-scoped-semantic-state-transitions.md | 0 .../ADR-0185-division-reading.md | 0 ...86-sealed-candidate-graph-injector-lane.md | 0 ...ADR-0189-comparative-verb-unit-widening.md | 0 .../ADR-0189a-day-enum-activity-first-flip.md | 0 ...0191-candidate-graph-completeness-guard.md | 0 ...ADR-0192-discrete-count-open-noun-class.md | 0 ...93-aggregate-existential-question-frame.md | 0 .../ADR-0194-labeled-container-subject.md | 0 .../ADR-0195-product-promotion-bridge.md | 0 ...0196-native-substrate-language-doctrine.md | 0 .../ADR-0197-vision-compiler-delta-crdt.md | 0 .../ADR-0198-motor-efferent-decoder-spike.md | 0 ...99-cross-domain-learning-arena-contract.md | 0 .../ADR-0200-expert-claim-reconciliation.md | 0 .../ADR-0201-proposition-canonicalizer.md | 0 .../ADR-0201.1-out-of-regime-detector.md | 0 ...202-proposition-representation-contract.md | 0 ...0203-binding-graph-acyclicity-invariant.md | 0 .../ADR-0204-proof-graph-builder.md | 0 ...ADR-0205-modus-ponens-disagreement-rule.md | 0 .../ADR-0206-response-governance-bridge.md | 0 .../ADR-0207-gsm8k-substrate-ratification.md | 0 .../ADR-0208-environmental-sensorium-loop.md | 0 ...ADR-0209-sensorimotor-feedback-contract.md | 0 .../ADR-0210-l10-grounding-pack.md | 0 .../ADR-0211-conformal-falsification-bench.md | 0 .../ADR-0216-motor-verdict-lowering.md | 0 ...7-r2-finite-integer-constraint-compiler.md | 0 ...0218-proof-carrying-coherence-promotion.md | 0 ...DR-0219-generation-checkpoint-atomicity.md | 0 ...220-engine-identity-vs-build-provenance.md | 0 .../ADR-0221-codeowners-review-topology.md | 0 .../ADR-0222-frame-verdict-closed-world.md | 0 ...223-semantic-substrate-affordance-audit.md | 0 ...24-foundational-substrate-readiness-map.md | 0 .../ADR-0225-adr-corpus-hygiene.md | 0 .../BRIEF-11D-next-capability-proposal.md | 0 .../L10-runtime-model-scope.md | 0 .../L11-hitl-async-queue-scope.md | 0 docs/adr/README.md | 3 + .../SESSION-2026-05-12-b.md | 0 ...SION-2026-05-12-language-packs-addendum.md | 0 docs/{decisions => adr}/SESSION-2026-05-12.md | 0 docs/{decisions => adr}/SESSION-2026-05-13.md | 0 ...SESSION-2026-05-26-comprehension-reader.md | 0 ...N-2026-05-27-adr-0167-parallel-dispatch.md | 0 .../SESSION-2026-05-27-tier3-sequencing.md | 0 .../epistemic-state-taxonomy-scope.md | 0 .../proposition-graph-scope.md | 0 .../recognizer-storage-scope.md | 0 .../substrate-liveness-audit-scope.md | 0 .../teaching-derived-recognition-scope.md | 0 docs/agents/grok/README.md | 3 + .../audio_pipeline_overview.md | 0 .../truth_seeking_schema.md | 0 docs/{ => audit}/claims_ledger.md | 0 docs/{brief => briefs}/brain_corp_brief.md | 0 docs/decisions/README.md | 501 ------------------ docs/grokbuild/README.md | 270 ---------- ...-reader-closure-and-capability-snapshot.md | 300 ----------- .../ADR-0084-pack-content-brief.md | 0 .../ADR-0085-content-style-pass-brief.md | 0 .../ADR-0085-content-style-pass-v2-brief.md | 0 .../ADR-0167-FOLLOWUPS.md | 0 .../ADR-0167-PARALLEL-WORK-PLAN.md | 0 .../ADR-0167-W2C-cross-domain-audit.md | 0 .../ADR-0172-TIER1-BRIEF-PACK.md | 0 .../ADR-0174-PHASE-3B-4-COMBINED-SCOPE.md | 0 .../AUDIT-ADR-0178-GB1-GB2.md | 0 .../AUDIT-ADR-0179-EX-RECONCILE.md | 0 .../BACKLOG-everyday-atoms-grounding-pack.md | 0 ...-reader-closure-and-capability-snapshot.md | 50 +- .../CHATGPT-REMOTE-BRIEF.md | 0 .../CLEANUP-C2-run-lane-migration.md | 0 .../CLEANUP-C4-compositions-compile.md | 0 ...CODEX-domain-pack-closure-cleanup-brief.md | 0 ...DEX-greek-hebrew-content-phase-ii-brief.md | 0 ...POSITION-FRAME-CONSUMPTION-WIRING-BRIEF.md | 0 .../COMPOSITIONCLAIM-BRIEF-PACK.md | 0 .../COMPREHENSION-READER-AUDIT.md | 0 .../CONSUMPTION-WIRING-DISPATCH-PACK.md | 0 docs/{handoff => handoffs}/DCS-S1-FINDING.md | 0 .../handoffs/HANDOFF-gpt55-2026-06-03.md | 3 + .../handoffs/HANDOFF-gpt55-2026-06-18.md | 3 + .../handoffs/HANDOFF-gpt55-2026-06-20.md | 0 .../MATCHER-EXTENSION-DISPATCH-PACK.md | 0 .../ME1-ME5-MILESTONE.md | 0 .../NEXT-SUBJECTS-CHATGPT-HANDOFF.md | 0 .../PARALLEL-WORK-PLAN-2026-05-29.md | 0 ...PHASE-3.1-FOLLOWUP-RECOGNIZER-EXPANSION.md | 0 .../POST-RAT1-PARALLEL-BRIEFS.md | 0 .../RB-GSM-SOLVER-DESIGN-INPUT.md | 0 .../SEMANTIC-STATE-TRANSITION-BLUEPRINT.md | 0 .../TIER2-AND-FRAMECLAIM-BRIEF-PACK.md | 0 .../VERB-EXPANSION-DISPATCH-PACK.md | 0 .../WAVE-NEXT-REVISED.md | 0 .../WORKBENCH-UI-WAVE-BRIEF-PACK.md | 0 .../WORKBENCH-UI-WAVE-SCOPING.md | 0 ...ORKBENCH-W3-RATIFICATION-CORRIDOR-BRIEF.md | 0 ...prehension-via-binding-graph-2026-06-05.md | 0 .../proposals_reveal.png | Bin .../proposals_table.png | Bin .../trace_edge_reveal.png | Bin .../workbench-truncated-cell/trace_full.png | Bin .../trace_rail_reveal.png | Bin ...rameverdict-type-inv31-brief-2026-06-15.md | 0 .../core-logos-W-Forge-brief-2026-06-14.md | 0 .../core-logos-W-Holonomy-brief-2026-06-14.md | 0 .../core-logos-studio-LG2-brief-2026-06-14.md | 0 .../core-logos-studio-LG3-brief-2026-06-14.md | 0 .../core-logos-studio-LG4-brief-2026-06-14.md | 0 ...logos-studio-readonly-briefs-2026-06-14.md | 0 .../demo-capture-shotlist-2026-06-14.md | 0 .../discrete_count_statement-injector-spec.md | 0 ...-continuity-hardening-briefs-2026-06-15.md | 0 ...llapse-anchor-reconciliation-2026-06-14.md | 0 .../phase-3b-4-skeleton/README.md | 0 .../en_core_names_v1/gender.jsonl | 0 .../en_core_names_v1/manifest.json | 0 .../test_adr_0174_phase3b_compound_clause.py | 0 .../test_adr_0174_phase4_contemplate.py | 0 .../proof-carrying-wiring-scope-2026-06-14.md | 0 ...and-relational-reader-briefs-2026-06-06.md | 0 ...ealed-measurement-obligation-2026-06-04.md | 0 ...-c-composition-investigation-2026-06-03.md | 0 ...ational-reasoning-brief-pack-2026-06-15.md | 0 ...wave-1-evidence-spine-briefs-2026-06-12.md | 0 ...-M-phaseB-calibration-briefs-2026-06-13.md | 0 .../wave-R-mastery-briefs-2026-06-12.md | 0 .../wave-R2-backend-brief-2026-06-12.md | 0 .../wave-R2-route-briefs-2026-06-12.md | 0 .../wave-R2-route-briefs-part2-2026-06-12.md | 0 .../wave-R3-briefs-2026-06-13.md | 0 ...onstruction-read-model-brief-2026-06-23.md | 0 ...trace-construction-tab-brief-2026-06-23.md | 0 ...-generalization-audits-brief-2026-06-23.md | 0 ...proposal-artifact-demo-brief-2026-06-23.md | 0 ...uncated-cell-visual-evidence-2026-06-14.md | 0 docs/issues/README.md | 3 + docs/lab/README.md | 4 + .../DEMO-PACKAGING-CHECKLIST.md | 0 .../PUBLIC-DEMO-ROADMAP.md | 0 docs/{ => plans}/capability_roadmap.md | 0 docs/{ => plans}/formation_pipeline_plan.md | 0 .../{SESSION-2026-05-13.md => 2026-05-13.md} | 0 ...ates.md => 2026-05-15-capability-gates.md} | 0 ...-arc.md => 2026-05-21-articulation-arc.md} | 0 ...rc.md => 2026-05-22-contract-layer-arc.md} | 0 ...agogy-research-and-teaching-loop-pivot.md} | 0 ...sure.md => 2026-05-26-corridor-closure.md} | 0 ...5-28-risk-reward-learning-architecture.md} | 0 ...mprehension-and-overfitting-discipline.md} | 0 ...c.md => 2026-05-29-multistep-build-arc.md} | 0 ...eductive-pivot-and-universal-structure.md} | 0 ...mantic-substrate-affordance-foundation.md} | 0 ...026-06-20-gsm8k-train-proxy-rebaseline.md} | 0 ... 2026-06-20-pr846-reconciliation-audit.md} | 0 ...ntity-foundational-slice-authorization.md} | 0 ...antity-entity-implementation-preflight.md} | 0 ...rkbench-proposal-first-alignment-scope.md} | 0 ...unary-state-change-delta-authorization.md} | 0 ...tate-change-delta-conformance-decision.md} | 0 ...-21-unary-state-change-delta-preflight.md} | 0 docs/sessions/README.md | 25 + docs/{ => specs}/runtime_contracts.md | 0 397 files changed, 101 insertions(+), 1092 deletions(-) create mode 100644 docs/README.md rename docs/{decisions => adr}/ADR-0001-vocab-layer-invariants.md (100%) rename docs/{decisions => adr}/ADR-0002-ingest-layer-design.md (100%) rename docs/{decisions => adr}/ADR-0003-coordinate-system-dissolution.md (100%) rename docs/{decisions => adr}/ADR-0004-rotor-as-operator-not-property.md (100%) rename docs/{decisions => adr}/ADR-0005-language-pack-contract.md (100%) rename docs/{decisions => adr}/ADR-0006-field-energy-operator.md (100%) rename docs/{decisions => adr}/ADR-0007-valence-layer.md (100%) rename docs/{decisions => adr}/ADR-0008-allocation-physics.md (100%) rename docs/{decisions => adr}/ADR-0009-compositional-physics.md (100%) rename docs/{decisions => adr}/ADR-0010-identity-physics.md (100%) rename docs/{decisions => adr}/ADR-0011-renderer.md (100%) rename docs/{decisions => adr}/ADR-0012-core-ingest-governance-layer.md (100%) rename docs/{decisions => adr}/ADR-0013-sensorium-multimodal-protocol.md (100%) rename docs/{decisions => adr}/ADR-0014-train-learning-loop.md (100%) rename docs/{decisions => adr}/ADR-0015-language-packs-and-holonomy-resonance.md (100%) rename docs/{decisions => adr}/ADR-0016-capability-roadmap.md (100%) rename docs/{decisions => adr}/ADR-0017-agency-scope.md (100%) rename docs/{decisions => adr}/ADR-0018-tool-use-scope.md (100%) rename docs/{decisions => adr}/ADR-0019-exact-vault-recall-acceleration.md (100%) rename docs/{decisions => adr}/ADR-0020-phase5-rust-parity-sequencing.md (100%) rename docs/{decisions => adr}/ADR-0021-epistemic-grade-policy.md (100%) rename docs/{decisions => adr}/ADR-0022-forward-semantic-control.md (100%) rename docs/{decisions => adr}/ADR-0023-forward-semantic-control-proof.md (100%) rename docs/{decisions => adr}/ADR-0024-inner-loop-admissibility.md (100%) rename docs/{decisions => adr}/ADR-0025-rotor-frame-admissibility-design-note.md (100%) rename docs/{decisions => adr}/ADR-0026-ranked-admissibility-with-margin.md (100%) rename docs/{decisions => adr}/ADR-0027-identity-packs.md (100%) rename docs/{decisions => adr}/ADR-0028-identity-surface-wiring.md (100%) rename docs/{decisions => adr}/ADR-0029-safety-packs.md (100%) rename docs/{decisions => adr}/ADR-0030-depth-language-hedge.md (100%) rename docs/{decisions => adr}/ADR-0031-score-decomposition-surface.md (100%) rename docs/{decisions => adr}/ADR-0032-safety-check-surface.md (100%) rename docs/{decisions => adr}/ADR-0033-ethics-packs.md (100%) rename docs/{decisions => adr}/ADR-0034-ethics-check-surface.md (100%) rename docs/{decisions => adr}/ADR-0035-turn-loop-verdict-surfacing.md (100%) rename docs/{decisions => adr}/ADR-0036-safety-refusal-policy.md (100%) rename docs/{decisions => adr}/ADR-0037-per-predicate-ethics-refusal.md (100%) rename docs/{decisions => adr}/ADR-0038-hedge-injection.md (100%) rename docs/{decisions => adr}/ADR-0039-audit-completeness.md (100%) rename docs/{decisions => adr}/ADR-0040-telemetry-sink.md (100%) rename docs/{decisions => adr}/ADR-0041-cli-verdicts-and-fanout.md (100%) rename docs/{decisions => adr}/ADR-0042-audit-tour-demo.md (100%) rename docs/{decisions => adr}/ADR-0043-pack-measurements-phase2.md (100%) rename docs/{decisions => adr}/ADR-0044-medical-clinical-ethics-pack.md (100%) rename docs/{decisions => adr}/ADR-0045-long-context-recall-vs-transformer-baselines.md (100%) rename docs/{decisions => adr}/ADR-0046-forward-graph-constraint.md (100%) rename docs/{decisions => adr}/ADR-0047-wire-forward-graph-constraint.md (100%) rename docs/{decisions => adr}/ADR-0048-pack-grounded-surface.md (100%) rename docs/{decisions => adr}/ADR-0049-intent-subject-extraction.md (100%) rename docs/{decisions => adr}/ADR-0050-pack-grounded-comparison.md (100%) rename docs/{decisions => adr}/ADR-0051-trust-boundary-hardening.md (100%) rename docs/{decisions => adr}/ADR-0052-teaching-grounded-surface.md (100%) rename docs/{decisions => adr}/ADR-0053-cognition-lane-closure.md (100%) rename docs/{decisions => adr}/ADR-0054-vault-recall-indexing-batching.md (100%) rename docs/{decisions => adr}/ADR-0055-inter-session-memory-discovery-promotion.md (100%) rename docs/{decisions => adr}/ADR-0056-contemplation-loop-c1.md (100%) rename docs/{decisions => adr}/ADR-0057-teaching-chain-proposal-review.md (100%) rename docs/{decisions => adr}/ADR-0058-forward-graph-constraint-status.md (100%) rename docs/{decisions => adr}/ADR-0059-correction-pass-telemetry.md (100%) rename docs/{decisions => adr}/ADR-0060-correction-acknowledgment-topic-lemma.md (100%) rename docs/{decisions => adr}/ADR-0061-procedure-intent-pack-grounded-surface.md (100%) rename docs/{decisions => adr}/ADR-0062-composed-teaching-grounded-surface.md (100%) rename docs/{decisions => adr}/ADR-0063-cross-pack-surface-resolver.md (100%) rename docs/{decisions => adr}/ADR-0064-cross-pack-teaching-chains.md (100%) rename docs/{decisions => adr}/ADR-0065-oov-gradient-and-relations-v2.md (100%) rename docs/{decisions => adr}/ADR-0066-turn-level-composition.md (100%) rename docs/{decisions => adr}/ADR-0067-cross-pack-teaching-chains.md (100%) rename docs/{decisions => adr}/ADR-0068-register-pack-class.md (100%) rename docs/{decisions => adr}/ADR-0069-realizer-register-parameter.md (100%) rename docs/{decisions => adr}/ADR-0070-register-pack-terse-v1.md (100%) rename docs/{decisions => adr}/ADR-0071-seeded-surface-variation.md (100%) rename docs/{decisions => adr}/ADR-0072-register-telemetry-operator-surface.md (100%) rename docs/{decisions => adr}/ADR-0073-anchor-lens-substrate.md (100%) rename docs/{decisions => adr}/ADR-0073a-anchor-lens-content-phase.md (100%) rename docs/{decisions => adr}/ADR-0073b-anchor-lens-class-loader.md (100%) rename docs/{decisions => adr}/ADR-0073c-anchor-lens-composer-wiring.md (100%) rename docs/{decisions => adr}/ADR-0073d-anchor-lens-telemetry-tour.md (100%) rename docs/{decisions => adr}/ADR-0074-orthogonality-tour.md (100%) rename docs/{decisions => adr}/ADR-0075-realizer-slot-type-guard.md (100%) rename docs/{decisions => adr}/ADR-0076-confirmation-tag-normalization.md (100%) rename docs/{decisions => adr}/ADR-0077-substantive-register-knobs.md (100%) rename docs/{decisions => adr}/ADR-0078-composer-graph-atom-equivalence.md (100%) rename docs/{decisions => adr}/ADR-0078-phase1-implementation-note.md (100%) rename docs/{decisions => adr}/ADR-0080-contemplation-loop.md (100%) rename docs/{decisions => adr}/ADR-0083-transitive-chain-surface.md (100%) rename docs/{decisions => adr}/ADR-0084-definitional-layer.md (100%) rename docs/{decisions => adr}/ADR-0085-gloss-aware-cause.md (100%) rename docs/{decisions => adr}/ADR-0087-rhetorical-style-axis.md (100%) rename docs/{decisions => adr}/ADR-0091-domain-pack-contract-v1.md (100%) rename docs/{decisions => adr}/ADR-0092-reviewer-registry-v1.md (100%) rename docs/{decisions => adr}/ADR-0093-domain-pack-contract-v1-implementation.md (100%) rename docs/{decisions => adr}/ADR-0094-proposal-source-provenance.md (100%) rename docs/{decisions => adr}/ADR-0095-miner-sourced-teaching-proposals.md (100%) rename docs/{decisions => adr}/ADR-0096-fabrication-control-eval-lane.md (100%) rename docs/{decisions => adr}/ADR-0097-mathematics-logic-reasoning-capable-ratification.md (100%) rename docs/{decisions => adr}/ADR-0098-demo-composition-contract.md (100%) rename docs/{decisions => adr}/ADR-0099-public-showcase-demo.md (100%) rename docs/{decisions => adr}/ADR-0100-physics-reasoning-capable-ratification.md (100%) rename docs/{decisions => adr}/ADR-0101-systems-software-reasoning-capable-ratification.md (100%) rename docs/{decisions => adr}/ADR-0102-hebrew-greek-reasoning-capable-ratification.md (100%) rename docs/{decisions => adr}/ADR-0103-fluency-lane-attachment-for-adr-0102.md (100%) rename docs/{decisions => adr}/ADR-0104-curriculum-sourced-teaching-proposals.md (100%) rename docs/{decisions => adr}/ADR-0105-sealed-holdout-encryption.md (100%) rename docs/{decisions => adr}/ADR-0106-expert-demo-promotion-contract.md (100%) rename docs/{decisions => adr}/ADR-0107-mathematics-logic-expert-demo-deferred.md (100%) rename docs/{decisions => adr}/ADR-0108-proposed-adr-sequencing.md (100%) rename docs/{decisions => adr}/ADR-0109-lane-shape-aware-thresholds.md (100%) rename docs/{decisions => adr}/ADR-0110-mathematics-logic-expert-demo-promotion.md (100%) rename docs/{decisions => adr}/ADR-0111-physics-expert-demo-promotion.md (100%) rename docs/{decisions => adr}/ADR-0112-runnable-expert-demo-showcase.md (100%) rename docs/{decisions => adr}/ADR-0113-rename-expert-demo-to-audit-passed.md (100%) rename docs/{decisions => adr}/ADR-0114-expert-capability-roadmap-gsm8k-first.md (100%) rename docs/{decisions => adr}/ADR-0114a-anti-overfitting-proof-obligations.md (100%) rename docs/{decisions => adr}/ADR-0114a.10-pack-provenance-auditor.md (100%) rename docs/{decisions => adr}/ADR-0114a.2-ood-ratio-auditor.md (100%) rename docs/{decisions => adr}/ADR-0114a.5-perturbation-suite.md (100%) rename docs/{decisions => adr}/ADR-0114a.6-depth-curve-auditor.md (100%) rename docs/{decisions => adr}/ADR-0114a.8-adversarial-auditor.md (100%) rename docs/{decisions => adr}/ADR-0115-math-problem-parser-and-graph.md (100%) rename docs/{decisions => adr}/ADR-0116-deterministic-solver.md (100%) rename docs/{decisions => adr}/ADR-0117-solution-trace-verifier.md (100%) rename docs/{decisions => adr}/ADR-0118-stepped-realizer.md (100%) rename docs/{decisions => adr}/ADR-0118a-ood-surface-generator.md (100%) rename docs/{decisions => adr}/ADR-0119-gsm8k-eval-lane-roadmap.md (100%) rename docs/{decisions => adr}/ADR-0119.1-sealed-holdout-fabrication-control.md (100%) rename docs/{decisions => adr}/ADR-0119.2-gsm8k-eval-corpus-dev-public.md (100%) rename docs/{decisions => adr}/ADR-0119.3-lane-runner.md (100%) rename docs/{decisions => adr}/ADR-0119.4-frontier-baseline-comparison.md (100%) rename docs/{decisions => adr}/ADR-0119.5-adversarial-generation.md (100%) rename docs/{decisions => adr}/ADR-0119.6-depth-curve-harness.md (100%) rename docs/{decisions => adr}/ADR-0119.7-sealed-gsm8k-test.md (100%) rename docs/{decisions => adr}/ADR-0119.8-lane-gate.md (100%) rename docs/{decisions => adr}/ADR-0120-expert-promotion-contract.md (100%) rename docs/{decisions => adr}/ADR-0120-math-expert-ledger-flip.md (100%) rename docs/{decisions => adr}/ADR-0120-math-expert-promotion-wireup.md (100%) rename docs/{decisions => adr}/ADR-0121-mathematics-logic-expert-deferred.md (100%) rename docs/{decisions => adr}/ADR-0122-parser-rate-per-unit.md (100%) rename docs/{decisions => adr}/ADR-0122-systems-software-audit-passed-deferred.md (100%) rename docs/{decisions => adr}/ADR-0123-parser-comparison-phrasing.md (100%) rename docs/{decisions => adr}/ADR-0123-symbolic-logic-shape-remap.md (100%) rename docs/{decisions => adr}/ADR-0123a-inference-shape-synonym.md (100%) rename docs/{decisions => adr}/ADR-0124-systems-software-audit-passed-promotion.md (100%) rename docs/{decisions => adr}/ADR-0125-reasoning-isolation-perturbation-suite.md (100%) rename docs/{decisions => adr}/ADR-0126-candidate-graph-parser.md (100%) rename docs/{decisions => adr}/ADR-0127-0128-RESULTS.md (100%) rename docs/{decisions => adr}/ADR-0127-units-pack-and-units-aware-parser.md (100%) rename docs/{decisions => adr}/ADR-0128-numerics-pack.md (100%) rename docs/{decisions => adr}/ADR-0129-spaced-correction-replay-deferred.md (100%) rename docs/{decisions => adr}/ADR-0130-pre-articulation-calibration-deferred.md (100%) rename docs/{decisions => adr}/ADR-0131-math-expert-rebench.md (100%) rename docs/{decisions => adr}/ADR-0131.1.F-frontier-baseline-comparison.md (100%) rename docs/{decisions => adr}/ADR-0131.1.S-sealed-holdout.md (100%) rename docs/{decisions => adr}/ADR-0131.2-teaching-corpus-eval.md (100%) rename docs/{decisions => adr}/ADR-0131.2.B-teaching-corpus-enrichment.md (100%) rename docs/{decisions => adr}/ADR-0131.3-bounded-grammar.md (100%) rename docs/{decisions => adr}/ADR-0131.4-composite-math-gate.md (100%) rename docs/{decisions => adr}/ADR-0131.5-gsm8k-probe-retirement.md (100%) rename docs/{decisions => adr}/ADR-0131.G-gsm8k-coverage-probe.md (100%) rename docs/{decisions => adr}/ADR-0131.G.0-probe-substrate.md (100%) rename docs/{decisions => adr}/ADR-0131.G.1-verb-classes-initial-state.md (100%) rename docs/{decisions => adr}/ADR-0131.G.2-comparatives.md (100%) rename docs/{decisions => adr}/ADR-0131.G.3-numerics.md (100%) rename docs/{decisions => adr}/ADR-0131.G.3.1-numerics-extensions.md (100%) rename docs/{decisions => adr}/ADR-0131.G.4-multi-clause.md (100%) rename docs/{decisions => adr}/ADR-0131.G.5-aggregate-answer-composition.md (100%) rename docs/{decisions => adr}/ADR-0132-binding-graph-data-model.md (100%) rename docs/{decisions => adr}/ADR-0133-binding-graph-adapter.md (100%) rename docs/{decisions => adr}/ADR-0134-binding-graph-admissibility.md (100%) rename docs/{decisions => adr}/ADR-0135-binding-graph-question-target.md (100%) rename docs/{decisions => adr}/ADR-0136-statement-layer-corridor.md (100%) rename docs/{decisions => adr}/ADR-0136.S.1-rate-event-statements.md (100%) rename docs/{decisions => adr}/ADR-0136.S.2-conditional-op-question.md (100%) rename docs/{decisions => adr}/ADR-0136.S.4-novel-initial-form.md (100%) rename docs/{decisions => adr}/ADR-0136.S2-post-rescan.md (100%) rename docs/{decisions => adr}/ADR-0136.S3-compound-initial-mutation.md (100%) rename docs/{decisions => adr}/ADR-0136.S3-post-rescan.md (100%) rename docs/{decisions => adr}/ADR-0138-comparative-reference-layer.md (100%) rename docs/{decisions => adr}/ADR-0139-arithmetic-as-versor-spike.md (100%) rename docs/{decisions => adr}/ADR-0140-core-trace-protocol-v0.md (100%) rename docs/{decisions => adr}/ADR-0140-subtract-and-additive-group-closure.md (100%) rename docs/{decisions => adr}/ADR-0141-multiply-as-dilator-positive-nonzero.md (100%) rename docs/{decisions => adr}/ADR-0142-epistemic-state-taxonomy.md (100%) rename docs/{decisions => adr}/ADR-0143-recognition-spike-anti-unification.md (100%) rename docs/{decisions => adr}/ADR-0144-proposition-graph-epistemic-carrier.md (100%) rename docs/{decisions => adr}/ADR-0145-energy-modulated-surface-readback.md (100%) rename docs/{decisions => adr}/ADR-0146-l10-hybrid-engine-state-persistence.md (100%) rename docs/{decisions => adr}/ADR-0148-vault-promotion-policy-wiring.md (100%) rename docs/{decisions => adr}/ADR-0149-derived-recognizer-pipeline-wiring.md (100%) rename docs/{decisions => adr}/ADR-0150-autonomous-inter-session-contemplation.md (100%) rename docs/{decisions => adr}/ADR-0151-auto-proposal-pipeline.md (100%) rename docs/{decisions => adr}/ADR-0152-learning-arc-demo.md (100%) rename docs/{decisions => adr}/ADR-0153-turn-event-trace-hash-backstamp.md (100%) rename docs/{decisions => adr}/ADR-0154-recognizer-producer-wiring.md (100%) rename docs/{decisions => adr}/ADR-0155-ci-contemplation-runner.md (100%) rename docs/{decisions => adr}/ADR-0156-atomic-engine-state-checkpoint.md (100%) rename docs/{decisions => adr}/ADR-0157-revision-mismatch-warning.md (100%) rename docs/{decisions => adr}/ADR-0158-reboot-event-audit.md (100%) rename docs/{decisions => adr}/ADR-0159-contemplation-quality-eval.md (100%) rename docs/{decisions => adr}/ADR-0160-core-workbench-v1.md (100%) rename docs/{decisions => adr}/ADR-0161-hitl-async-queue.md (100%) rename docs/{decisions => adr}/ADR-0162-workbench-design-system.md (100%) rename docs/{decisions => adr}/ADR-0163-F2-confuser-corpus-spec.md (100%) rename docs/{decisions => adr}/ADR-0163-gsm8k-path-to-mastery.md (100%) rename docs/{decisions => adr}/ADR-0164-incremental-comprehension-reader.md (100%) rename docs/{decisions => adr}/ADR-0164.1-lexical-primitive-scope.md (100%) rename docs/{decisions => adr}/ADR-0164.2-pronoun-entity-resolution.md (100%) rename docs/{decisions => adr}/ADR-0164.3-cross-sentence-state.md (100%) rename docs/{decisions => adr}/ADR-0164.4-phase2-statement-frame-reader.md (100%) rename docs/{decisions => adr}/ADR-0165-regex-scope-rule.md (100%) rename docs/{decisions => adr}/ADR-0166-measurement-capability-sequencing.md (100%) rename docs/{decisions => adr}/ADR-0167-audit-as-teaching-evidence.md (100%) rename docs/{decisions => adr}/ADR-0168-frameclaim-ratification.md (100%) rename docs/{decisions => adr}/ADR-0168.1-math-frameclaim-proposal-adapter.md (100%) rename docs/{decisions => adr}/ADR-0169-compositionclaim-ratification.md (100%) rename docs/{decisions => adr}/ADR-0169.1-math-compositionclaim-proposal-adapter.md (100%) rename docs/{decisions => adr}/ADR-0170-injector-contract-widening.md (100%) rename docs/{decisions => adr}/ADR-0172-math-corpus-decomposition-mechanism.md (100%) rename docs/{decisions => adr}/ADR-0173-workbench-ratification-trust-boundary.md (100%) rename docs/{decisions => adr}/ADR-0174-held-hypothesis-comprehension.md (100%) rename docs/{decisions => adr}/ADR-0175-calibrated-attempt-and-eliminate-learning.md (100%) rename docs/{decisions => adr}/ADR-0176-multistep-composition-question-targeting.md (100%) rename docs/{decisions => adr}/ADR-0177-cue-precision-learning.md (100%) rename docs/{decisions => adr}/ADR-0178-GB3b-referent-accumulation-scope.md (100%) rename docs/{decisions => adr}/ADR-0178-compositional-structure.md (100%) rename docs/{decisions => adr}/ADR-0179-extraction-richness.md (100%) rename docs/{decisions => adr}/ADR-0180-crdt-sharded-vault-concurrency.md (100%) rename docs/{decisions => adr}/ADR-0181-audio-compiler-delta-crdt.md (100%) rename docs/{decisions => adr}/ADR-0182-cross-composer-disagreement-pooling.md (100%) rename docs/{decisions => adr}/ADR-0183-lawful-audio-lexeme-path.md (100%) rename docs/{decisions => adr}/ADR-0184-distinct-unit-product-rule.md (100%) rename docs/{decisions => adr}/ADR-0184-scoped-semantic-state-transitions.md (100%) rename docs/{decisions => adr}/ADR-0185-division-reading.md (100%) rename docs/{decisions => adr}/ADR-0186-sealed-candidate-graph-injector-lane.md (100%) rename docs/{decisions => adr}/ADR-0189-comparative-verb-unit-widening.md (100%) rename docs/{decisions => adr}/ADR-0189a-day-enum-activity-first-flip.md (100%) rename docs/{decisions => adr}/ADR-0191-candidate-graph-completeness-guard.md (100%) rename docs/{decisions => adr}/ADR-0192-discrete-count-open-noun-class.md (100%) rename docs/{decisions => adr}/ADR-0193-aggregate-existential-question-frame.md (100%) rename docs/{decisions => adr}/ADR-0194-labeled-container-subject.md (100%) rename docs/{decisions => adr}/ADR-0195-product-promotion-bridge.md (100%) rename docs/{decisions => adr}/ADR-0196-native-substrate-language-doctrine.md (100%) rename docs/{decisions => adr}/ADR-0197-vision-compiler-delta-crdt.md (100%) rename docs/{decisions => adr}/ADR-0198-motor-efferent-decoder-spike.md (100%) rename docs/{decisions => adr}/ADR-0199-cross-domain-learning-arena-contract.md (100%) rename docs/{decisions => adr}/ADR-0200-expert-claim-reconciliation.md (100%) rename docs/{decisions => adr}/ADR-0201-proposition-canonicalizer.md (100%) rename docs/{decisions => adr}/ADR-0201.1-out-of-regime-detector.md (100%) rename docs/{decisions => adr}/ADR-0202-proposition-representation-contract.md (100%) rename docs/{decisions => adr}/ADR-0203-binding-graph-acyclicity-invariant.md (100%) rename docs/{decisions => adr}/ADR-0204-proof-graph-builder.md (100%) rename docs/{decisions => adr}/ADR-0205-modus-ponens-disagreement-rule.md (100%) rename docs/{decisions => adr}/ADR-0206-response-governance-bridge.md (100%) rename docs/{decisions => adr}/ADR-0207-gsm8k-substrate-ratification.md (100%) rename docs/{decisions => adr}/ADR-0208-environmental-sensorium-loop.md (100%) rename docs/{decisions => adr}/ADR-0209-sensorimotor-feedback-contract.md (100%) rename docs/{decisions => adr}/ADR-0210-l10-grounding-pack.md (100%) rename docs/{decisions => adr}/ADR-0211-conformal-falsification-bench.md (100%) rename docs/{decisions => adr}/ADR-0216-motor-verdict-lowering.md (100%) rename docs/{decisions => adr}/ADR-0217-r2-finite-integer-constraint-compiler.md (100%) rename docs/{decisions => adr}/ADR-0218-proof-carrying-coherence-promotion.md (100%) rename docs/{decisions => adr}/ADR-0219-generation-checkpoint-atomicity.md (100%) rename docs/{decisions => adr}/ADR-0220-engine-identity-vs-build-provenance.md (100%) rename docs/{decisions => adr}/ADR-0221-codeowners-review-topology.md (100%) rename docs/{decisions => adr}/ADR-0222-frame-verdict-closed-world.md (100%) rename docs/{decisions => adr}/ADR-0223-semantic-substrate-affordance-audit.md (100%) rename docs/{decisions => adr}/ADR-0224-foundational-substrate-readiness-map.md (100%) rename docs/{decisions => adr}/ADR-0225-adr-corpus-hygiene.md (100%) rename docs/{decisions => adr}/BRIEF-11D-next-capability-proposal.md (100%) rename docs/{decisions => adr}/L10-runtime-model-scope.md (100%) rename docs/{decisions => adr}/L11-hitl-async-queue-scope.md (100%) create mode 100644 docs/adr/README.md rename docs/{decisions => adr}/SESSION-2026-05-12-b.md (100%) rename docs/{decisions => adr}/SESSION-2026-05-12-language-packs-addendum.md (100%) rename docs/{decisions => adr}/SESSION-2026-05-12.md (100%) rename docs/{decisions => adr}/SESSION-2026-05-13.md (100%) rename docs/{decisions => adr}/SESSION-2026-05-26-comprehension-reader.md (100%) rename docs/{decisions => adr}/SESSION-2026-05-27-adr-0167-parallel-dispatch.md (100%) rename docs/{decisions => adr}/SESSION-2026-05-27-tier3-sequencing.md (100%) rename docs/{decisions => adr}/epistemic-state-taxonomy-scope.md (100%) rename docs/{decisions => adr}/proposition-graph-scope.md (100%) rename docs/{decisions => adr}/recognizer-storage-scope.md (100%) rename docs/{decisions => adr}/substrate-liveness-audit-scope.md (100%) rename docs/{decisions => adr}/teaching-derived-recognition-scope.md (100%) create mode 100644 docs/agents/grok/README.md rename docs/{ => architecture}/audio_pipeline_overview.md (100%) rename docs/{ => architecture}/truth_seeking_schema.md (100%) rename docs/{ => audit}/claims_ledger.md (100%) rename docs/{brief => briefs}/brain_corp_brief.md (100%) delete mode 100644 docs/decisions/README.md delete mode 100644 docs/grokbuild/README.md delete mode 100644 docs/handoff/BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md rename docs/{handoff => handoffs}/ADR-0084-pack-content-brief.md (100%) rename docs/{handoff => handoffs}/ADR-0085-content-style-pass-brief.md (100%) rename docs/{handoff => handoffs}/ADR-0085-content-style-pass-v2-brief.md (100%) rename docs/{handoff => handoffs}/ADR-0167-FOLLOWUPS.md (100%) rename docs/{handoff => handoffs}/ADR-0167-PARALLEL-WORK-PLAN.md (100%) rename docs/{handoff => handoffs}/ADR-0167-W2C-cross-domain-audit.md (100%) rename docs/{handoff => handoffs}/ADR-0172-TIER1-BRIEF-PACK.md (100%) rename docs/{handoff => handoffs}/ADR-0174-PHASE-3B-4-COMBINED-SCOPE.md (100%) rename docs/{handoff => handoffs}/AUDIT-ADR-0178-GB1-GB2.md (100%) rename docs/{handoff => handoffs}/AUDIT-ADR-0179-EX-RECONCILE.md (100%) rename docs/{handoff => handoffs}/BACKLOG-everyday-atoms-grounding-pack.md (100%) rename docs/{handoff => handoffs}/CHATGPT-REMOTE-BRIEF.md (100%) rename docs/{handoff => handoffs}/CLEANUP-C2-run-lane-migration.md (100%) rename docs/{handoff => handoffs}/CLEANUP-C4-compositions-compile.md (100%) rename docs/{handoff => handoffs}/CODEX-domain-pack-closure-cleanup-brief.md (100%) rename docs/{handoff => handoffs}/CODEX-greek-hebrew-content-phase-ii-brief.md (100%) rename docs/{handoff => handoffs}/COMPOSITION-FRAME-CONSUMPTION-WIRING-BRIEF.md (100%) rename docs/{handoff => handoffs}/COMPOSITIONCLAIM-BRIEF-PACK.md (100%) rename docs/{handoff => handoffs}/COMPREHENSION-READER-AUDIT.md (100%) rename docs/{handoff => handoffs}/CONSUMPTION-WIRING-DISPATCH-PACK.md (100%) rename docs/{handoff => handoffs}/DCS-S1-FINDING.md (100%) rename HANDOFF-gpt55-2026-06-03.md => docs/handoffs/HANDOFF-gpt55-2026-06-03.md (98%) rename HANDOFF-gpt55-2026-06-18.md => docs/handoffs/HANDOFF-gpt55-2026-06-18.md (98%) rename HANDOFF-gpt55-2026-06-20.md => docs/handoffs/HANDOFF-gpt55-2026-06-20.md (100%) rename docs/{handoff => handoffs}/MATCHER-EXTENSION-DISPATCH-PACK.md (100%) rename docs/{handoff => handoffs}/ME1-ME5-MILESTONE.md (100%) rename docs/{handoff => handoffs}/NEXT-SUBJECTS-CHATGPT-HANDOFF.md (100%) rename docs/{handoff => handoffs}/PARALLEL-WORK-PLAN-2026-05-29.md (100%) rename docs/{handoff => handoffs}/PHASE-3.1-FOLLOWUP-RECOGNIZER-EXPANSION.md (100%) rename docs/{handoff => handoffs}/POST-RAT1-PARALLEL-BRIEFS.md (100%) rename docs/{handoff => handoffs}/RB-GSM-SOLVER-DESIGN-INPUT.md (100%) rename docs/{handoff => handoffs}/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md (100%) rename docs/{handoff => handoffs}/TIER2-AND-FRAMECLAIM-BRIEF-PACK.md (100%) rename docs/{handoff => handoffs}/VERB-EXPANSION-DISPATCH-PACK.md (100%) rename docs/{handoff => handoffs}/WAVE-NEXT-REVISED.md (100%) rename docs/{handoff => handoffs}/WORKBENCH-UI-WAVE-BRIEF-PACK.md (100%) rename docs/{handoff => handoffs}/WORKBENCH-UI-WAVE-SCOPING.md (100%) rename docs/{handoff => handoffs}/WORKBENCH-W3-RATIFICATION-CORRIDOR-BRIEF.md (100%) rename docs/{handoff => handoffs}/arithmetic-comprehension-via-binding-graph-2026-06-05.md (100%) rename docs/{handoff => handoffs}/assets/workbench-truncated-cell/proposals_reveal.png (100%) rename docs/{handoff => handoffs}/assets/workbench-truncated-cell/proposals_table.png (100%) rename docs/{handoff => handoffs}/assets/workbench-truncated-cell/trace_edge_reveal.png (100%) rename docs/{handoff => handoffs}/assets/workbench-truncated-cell/trace_full.png (100%) rename docs/{handoff => handoffs}/assets/workbench-truncated-cell/trace_rail_reveal.png (100%) rename docs/{handoff => handoffs}/b4-pr1-frameverdict-type-inv31-brief-2026-06-15.md (100%) rename docs/{handoff => handoffs}/core-logos-W-Forge-brief-2026-06-14.md (100%) rename docs/{handoff => handoffs}/core-logos-W-Holonomy-brief-2026-06-14.md (100%) rename docs/{handoff => handoffs}/core-logos-studio-LG2-brief-2026-06-14.md (100%) rename docs/{handoff => handoffs}/core-logos-studio-LG3-brief-2026-06-14.md (100%) rename docs/{handoff => handoffs}/core-logos-studio-LG4-brief-2026-06-14.md (100%) rename docs/{handoff => handoffs}/core-logos-studio-readonly-briefs-2026-06-14.md (100%) rename docs/{handoff => handoffs}/demo-capture-shotlist-2026-06-14.md (100%) rename docs/{handoff => handoffs}/discrete_count_statement-injector-spec.md (100%) rename docs/{handoff => handoffs}/l10-continuity-hardening-briefs-2026-06-15.md (100%) rename docs/{handoff => handoffs}/logos-collapse-anchor-reconciliation-2026-06-14.md (100%) rename docs/{handoff => handoffs}/phase-3b-4-skeleton/README.md (100%) rename docs/{handoff => handoffs}/phase-3b-4-skeleton/en_core_names_v1/gender.jsonl (100%) rename docs/{handoff => handoffs}/phase-3b-4-skeleton/en_core_names_v1/manifest.json (100%) rename docs/{handoff => handoffs}/phase-3b-4-skeleton/test_adr_0174_phase3b_compound_clause.py (100%) rename docs/{handoff => handoffs}/phase-3b-4-skeleton/test_adr_0174_phase4_contemplate.py (100%) rename docs/{handoff => handoffs}/proof-carrying-wiring-scope-2026-06-14.md (100%) rename docs/{handoff => handoffs}/proofwriter-owa-and-relational-reader-briefs-2026-06-06.md (100%) rename docs/{handoff => handoffs}/sealed-measurement-obligation-2026-06-04.md (100%) rename docs/{handoff => handoffs}/stage-c-composition-investigation-2026-06-03.md (100%) rename docs/{handoff => handoffs}/step3-relational-reasoning-brief-pack-2026-06-15.md (100%) rename docs/{handoff => handoffs}/wave-1-evidence-spine-briefs-2026-06-12.md (100%) rename docs/{handoff => handoffs}/wave-M-phaseB-calibration-briefs-2026-06-13.md (100%) rename docs/{handoff => handoffs}/wave-R-mastery-briefs-2026-06-12.md (100%) rename docs/{handoff => handoffs}/wave-R2-backend-brief-2026-06-12.md (100%) rename docs/{handoff => handoffs}/wave-R2-route-briefs-2026-06-12.md (100%) rename docs/{handoff => handoffs}/wave-R2-route-briefs-part2-2026-06-12.md (100%) rename docs/{handoff => handoffs}/wave-R3-briefs-2026-06-13.md (100%) rename docs/{handoff => handoffs}/workbench-catchup-PR2-construction-read-model-brief-2026-06-23.md (100%) rename docs/{handoff => handoffs}/workbench-catchup-PR3-trace-construction-tab-brief-2026-06-23.md (100%) rename docs/{handoff => handoffs}/workbench-catchup-PR4-generalization-audits-brief-2026-06-23.md (100%) rename docs/{handoff => handoffs}/workbench-catchup-PR5-proposal-artifact-demo-brief-2026-06-23.md (100%) rename docs/{handoff => handoffs}/workbench-truncated-cell-visual-evidence-2026-06-14.md (100%) create mode 100644 docs/issues/README.md create mode 100644 docs/lab/README.md rename docs/{planning => plans}/DEMO-PACKAGING-CHECKLIST.md (100%) rename docs/{planning => plans}/PUBLIC-DEMO-ROADMAP.md (100%) rename docs/{ => plans}/capability_roadmap.md (100%) rename docs/{ => plans}/formation_pipeline_plan.md (100%) rename docs/sessions/{SESSION-2026-05-13.md => 2026-05-13.md} (100%) rename docs/sessions/{SESSION-2026-05-15-capability-gates.md => 2026-05-15-capability-gates.md} (100%) rename docs/sessions/{SESSION-2026-05-21-articulation-arc.md => 2026-05-21-articulation-arc.md} (100%) rename docs/sessions/{SESSION-2026-05-22-contract-layer-arc.md => 2026-05-22-contract-layer-arc.md} (100%) rename docs/sessions/{SESSION-2026-05-23-pedagogy-research-and-teaching-loop-pivot.md => 2026-05-23-pedagogy-research-and-teaching-loop-pivot.md} (100%) rename docs/sessions/{SESSION-2026-05-26-corridor-closure.md => 2026-05-26-corridor-closure.md} (100%) rename docs/sessions/{SESSION-2026-05-28-risk-reward-learning-architecture.md => 2026-05-28-risk-reward-learning-architecture.md} (100%) rename docs/sessions/{SESSION-2026-05-29-comprehension-and-overfitting-discipline.md => 2026-05-29-comprehension-and-overfitting-discipline.md} (100%) rename docs/sessions/{SESSION-2026-05-29-multistep-build-arc.md => 2026-05-29-multistep-build-arc.md} (100%) rename docs/sessions/{SESSION-2026-06-04-deductive-pivot-and-universal-structure.md => 2026-06-04-deductive-pivot-and-universal-structure.md} (100%) rename docs/sessions/{SESSION-2026-06-19-semantic-substrate-affordance-foundation.md => 2026-06-19-semantic-substrate-affordance-foundation.md} (100%) rename docs/sessions/{gsm8k-train-proxy-rebaseline-2026-06-20.md => 2026-06-20-gsm8k-train-proxy-rebaseline.md} (100%) rename docs/sessions/{pr846-reconciliation-audit-2026-06-20.md => 2026-06-20-pr846-reconciliation-audit.md} (100%) rename docs/sessions/{quantity-entity-foundational-slice-authorization-2026-06-20.md => 2026-06-20-quantity-entity-foundational-slice-authorization.md} (100%) rename docs/sessions/{quantity-entity-implementation-preflight-2026-06-20.md => 2026-06-20-quantity-entity-implementation-preflight.md} (100%) rename docs/sessions/{workbench-proposal-first-alignment-scope-2026-06-20.md => 2026-06-20-workbench-proposal-first-alignment-scope.md} (100%) rename docs/sessions/{unary-state-change-delta-authorization-2026-06-21.md => 2026-06-21-unary-state-change-delta-authorization.md} (100%) rename docs/sessions/{unary-state-change-delta-conformance-decision-2026-06-21.md => 2026-06-21-unary-state-change-delta-conformance-decision.md} (100%) rename docs/sessions/{unary-state-change-delta-preflight-2026-06-21.md => 2026-06-21-unary-state-change-delta-preflight.md} (100%) create mode 100644 docs/sessions/README.md rename docs/{ => specs}/runtime_contracts.md (100%) diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 00000000..84a58382 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,28 @@ +# CORE Documentation Index + +This is the central index for all documentation in the CORE project. + +## Directories +- `adr/` - Architecture decision records +- `analysis/` - Deep dives and master plans +- `architecture/` - Architecture docs +- `audit/` - Audit reports +- `benchmarks/` - Benchmark evidence +- `briefs/` - Briefs +- `curriculum/` - Teaching/learning order +- `evals/` - Eval docs +- `examples/` - Usage examples +- `handoffs/` - Handoff docs +- `implementation/` - Implementation guides +- `issues/` - Detailed issue analyses +- `lab/` - Experimental content (Not ratified) +- `outreach/` - External comms +- `plans/` - Plans +- `research/` - Research notes +- `sessions/` - Session logs +- `specs/` - Specifications +- `workbench/` - Workbench docs +- `zig/` - Zig language docs +- `agents/` - Agent-specific operational guides + +> **Note regarding `grokbuild/`**: Agent-specific operational guide for Grok 4.3 + Grok Build. Not architecture documentation. Candidate for relocation to `docs/agents/grok/`. diff --git a/docs/decisions/ADR-0001-vocab-layer-invariants.md b/docs/adr/ADR-0001-vocab-layer-invariants.md similarity index 100% rename from docs/decisions/ADR-0001-vocab-layer-invariants.md rename to docs/adr/ADR-0001-vocab-layer-invariants.md diff --git a/docs/decisions/ADR-0002-ingest-layer-design.md b/docs/adr/ADR-0002-ingest-layer-design.md similarity index 100% rename from docs/decisions/ADR-0002-ingest-layer-design.md rename to docs/adr/ADR-0002-ingest-layer-design.md diff --git a/docs/decisions/ADR-0003-coordinate-system-dissolution.md b/docs/adr/ADR-0003-coordinate-system-dissolution.md similarity index 100% rename from docs/decisions/ADR-0003-coordinate-system-dissolution.md rename to docs/adr/ADR-0003-coordinate-system-dissolution.md diff --git a/docs/decisions/ADR-0004-rotor-as-operator-not-property.md b/docs/adr/ADR-0004-rotor-as-operator-not-property.md similarity index 100% rename from docs/decisions/ADR-0004-rotor-as-operator-not-property.md rename to docs/adr/ADR-0004-rotor-as-operator-not-property.md diff --git a/docs/decisions/ADR-0005-language-pack-contract.md b/docs/adr/ADR-0005-language-pack-contract.md similarity index 100% rename from docs/decisions/ADR-0005-language-pack-contract.md rename to docs/adr/ADR-0005-language-pack-contract.md diff --git a/docs/decisions/ADR-0006-field-energy-operator.md b/docs/adr/ADR-0006-field-energy-operator.md similarity index 100% rename from docs/decisions/ADR-0006-field-energy-operator.md rename to docs/adr/ADR-0006-field-energy-operator.md diff --git a/docs/decisions/ADR-0007-valence-layer.md b/docs/adr/ADR-0007-valence-layer.md similarity index 100% rename from docs/decisions/ADR-0007-valence-layer.md rename to docs/adr/ADR-0007-valence-layer.md diff --git a/docs/decisions/ADR-0008-allocation-physics.md b/docs/adr/ADR-0008-allocation-physics.md similarity index 100% rename from docs/decisions/ADR-0008-allocation-physics.md rename to docs/adr/ADR-0008-allocation-physics.md diff --git a/docs/decisions/ADR-0009-compositional-physics.md b/docs/adr/ADR-0009-compositional-physics.md similarity index 100% rename from docs/decisions/ADR-0009-compositional-physics.md rename to docs/adr/ADR-0009-compositional-physics.md diff --git a/docs/decisions/ADR-0010-identity-physics.md b/docs/adr/ADR-0010-identity-physics.md similarity index 100% rename from docs/decisions/ADR-0010-identity-physics.md rename to docs/adr/ADR-0010-identity-physics.md diff --git a/docs/decisions/ADR-0011-renderer.md b/docs/adr/ADR-0011-renderer.md similarity index 100% rename from docs/decisions/ADR-0011-renderer.md rename to docs/adr/ADR-0011-renderer.md diff --git a/docs/decisions/ADR-0012-core-ingest-governance-layer.md b/docs/adr/ADR-0012-core-ingest-governance-layer.md similarity index 100% rename from docs/decisions/ADR-0012-core-ingest-governance-layer.md rename to docs/adr/ADR-0012-core-ingest-governance-layer.md diff --git a/docs/decisions/ADR-0013-sensorium-multimodal-protocol.md b/docs/adr/ADR-0013-sensorium-multimodal-protocol.md similarity index 100% rename from docs/decisions/ADR-0013-sensorium-multimodal-protocol.md rename to docs/adr/ADR-0013-sensorium-multimodal-protocol.md diff --git a/docs/decisions/ADR-0014-train-learning-loop.md b/docs/adr/ADR-0014-train-learning-loop.md similarity index 100% rename from docs/decisions/ADR-0014-train-learning-loop.md rename to docs/adr/ADR-0014-train-learning-loop.md diff --git a/docs/decisions/ADR-0015-language-packs-and-holonomy-resonance.md b/docs/adr/ADR-0015-language-packs-and-holonomy-resonance.md similarity index 100% rename from docs/decisions/ADR-0015-language-packs-and-holonomy-resonance.md rename to docs/adr/ADR-0015-language-packs-and-holonomy-resonance.md diff --git a/docs/decisions/ADR-0016-capability-roadmap.md b/docs/adr/ADR-0016-capability-roadmap.md similarity index 100% rename from docs/decisions/ADR-0016-capability-roadmap.md rename to docs/adr/ADR-0016-capability-roadmap.md diff --git a/docs/decisions/ADR-0017-agency-scope.md b/docs/adr/ADR-0017-agency-scope.md similarity index 100% rename from docs/decisions/ADR-0017-agency-scope.md rename to docs/adr/ADR-0017-agency-scope.md diff --git a/docs/decisions/ADR-0018-tool-use-scope.md b/docs/adr/ADR-0018-tool-use-scope.md similarity index 100% rename from docs/decisions/ADR-0018-tool-use-scope.md rename to docs/adr/ADR-0018-tool-use-scope.md diff --git a/docs/decisions/ADR-0019-exact-vault-recall-acceleration.md b/docs/adr/ADR-0019-exact-vault-recall-acceleration.md similarity index 100% rename from docs/decisions/ADR-0019-exact-vault-recall-acceleration.md rename to docs/adr/ADR-0019-exact-vault-recall-acceleration.md diff --git a/docs/decisions/ADR-0020-phase5-rust-parity-sequencing.md b/docs/adr/ADR-0020-phase5-rust-parity-sequencing.md similarity index 100% rename from docs/decisions/ADR-0020-phase5-rust-parity-sequencing.md rename to docs/adr/ADR-0020-phase5-rust-parity-sequencing.md diff --git a/docs/decisions/ADR-0021-epistemic-grade-policy.md b/docs/adr/ADR-0021-epistemic-grade-policy.md similarity index 100% rename from docs/decisions/ADR-0021-epistemic-grade-policy.md rename to docs/adr/ADR-0021-epistemic-grade-policy.md diff --git a/docs/decisions/ADR-0022-forward-semantic-control.md b/docs/adr/ADR-0022-forward-semantic-control.md similarity index 100% rename from docs/decisions/ADR-0022-forward-semantic-control.md rename to docs/adr/ADR-0022-forward-semantic-control.md diff --git a/docs/decisions/ADR-0023-forward-semantic-control-proof.md b/docs/adr/ADR-0023-forward-semantic-control-proof.md similarity index 100% rename from docs/decisions/ADR-0023-forward-semantic-control-proof.md rename to docs/adr/ADR-0023-forward-semantic-control-proof.md diff --git a/docs/decisions/ADR-0024-inner-loop-admissibility.md b/docs/adr/ADR-0024-inner-loop-admissibility.md similarity index 100% rename from docs/decisions/ADR-0024-inner-loop-admissibility.md rename to docs/adr/ADR-0024-inner-loop-admissibility.md diff --git a/docs/decisions/ADR-0025-rotor-frame-admissibility-design-note.md b/docs/adr/ADR-0025-rotor-frame-admissibility-design-note.md similarity index 100% rename from docs/decisions/ADR-0025-rotor-frame-admissibility-design-note.md rename to docs/adr/ADR-0025-rotor-frame-admissibility-design-note.md diff --git a/docs/decisions/ADR-0026-ranked-admissibility-with-margin.md b/docs/adr/ADR-0026-ranked-admissibility-with-margin.md similarity index 100% rename from docs/decisions/ADR-0026-ranked-admissibility-with-margin.md rename to docs/adr/ADR-0026-ranked-admissibility-with-margin.md diff --git a/docs/decisions/ADR-0027-identity-packs.md b/docs/adr/ADR-0027-identity-packs.md similarity index 100% rename from docs/decisions/ADR-0027-identity-packs.md rename to docs/adr/ADR-0027-identity-packs.md diff --git a/docs/decisions/ADR-0028-identity-surface-wiring.md b/docs/adr/ADR-0028-identity-surface-wiring.md similarity index 100% rename from docs/decisions/ADR-0028-identity-surface-wiring.md rename to docs/adr/ADR-0028-identity-surface-wiring.md diff --git a/docs/decisions/ADR-0029-safety-packs.md b/docs/adr/ADR-0029-safety-packs.md similarity index 100% rename from docs/decisions/ADR-0029-safety-packs.md rename to docs/adr/ADR-0029-safety-packs.md diff --git a/docs/decisions/ADR-0030-depth-language-hedge.md b/docs/adr/ADR-0030-depth-language-hedge.md similarity index 100% rename from docs/decisions/ADR-0030-depth-language-hedge.md rename to docs/adr/ADR-0030-depth-language-hedge.md diff --git a/docs/decisions/ADR-0031-score-decomposition-surface.md b/docs/adr/ADR-0031-score-decomposition-surface.md similarity index 100% rename from docs/decisions/ADR-0031-score-decomposition-surface.md rename to docs/adr/ADR-0031-score-decomposition-surface.md diff --git a/docs/decisions/ADR-0032-safety-check-surface.md b/docs/adr/ADR-0032-safety-check-surface.md similarity index 100% rename from docs/decisions/ADR-0032-safety-check-surface.md rename to docs/adr/ADR-0032-safety-check-surface.md diff --git a/docs/decisions/ADR-0033-ethics-packs.md b/docs/adr/ADR-0033-ethics-packs.md similarity index 100% rename from docs/decisions/ADR-0033-ethics-packs.md rename to docs/adr/ADR-0033-ethics-packs.md diff --git a/docs/decisions/ADR-0034-ethics-check-surface.md b/docs/adr/ADR-0034-ethics-check-surface.md similarity index 100% rename from docs/decisions/ADR-0034-ethics-check-surface.md rename to docs/adr/ADR-0034-ethics-check-surface.md diff --git a/docs/decisions/ADR-0035-turn-loop-verdict-surfacing.md b/docs/adr/ADR-0035-turn-loop-verdict-surfacing.md similarity index 100% rename from docs/decisions/ADR-0035-turn-loop-verdict-surfacing.md rename to docs/adr/ADR-0035-turn-loop-verdict-surfacing.md diff --git a/docs/decisions/ADR-0036-safety-refusal-policy.md b/docs/adr/ADR-0036-safety-refusal-policy.md similarity index 100% rename from docs/decisions/ADR-0036-safety-refusal-policy.md rename to docs/adr/ADR-0036-safety-refusal-policy.md diff --git a/docs/decisions/ADR-0037-per-predicate-ethics-refusal.md b/docs/adr/ADR-0037-per-predicate-ethics-refusal.md similarity index 100% rename from docs/decisions/ADR-0037-per-predicate-ethics-refusal.md rename to docs/adr/ADR-0037-per-predicate-ethics-refusal.md diff --git a/docs/decisions/ADR-0038-hedge-injection.md b/docs/adr/ADR-0038-hedge-injection.md similarity index 100% rename from docs/decisions/ADR-0038-hedge-injection.md rename to docs/adr/ADR-0038-hedge-injection.md diff --git a/docs/decisions/ADR-0039-audit-completeness.md b/docs/adr/ADR-0039-audit-completeness.md similarity index 100% rename from docs/decisions/ADR-0039-audit-completeness.md rename to docs/adr/ADR-0039-audit-completeness.md diff --git a/docs/decisions/ADR-0040-telemetry-sink.md b/docs/adr/ADR-0040-telemetry-sink.md similarity index 100% rename from docs/decisions/ADR-0040-telemetry-sink.md rename to docs/adr/ADR-0040-telemetry-sink.md diff --git a/docs/decisions/ADR-0041-cli-verdicts-and-fanout.md b/docs/adr/ADR-0041-cli-verdicts-and-fanout.md similarity index 100% rename from docs/decisions/ADR-0041-cli-verdicts-and-fanout.md rename to docs/adr/ADR-0041-cli-verdicts-and-fanout.md diff --git a/docs/decisions/ADR-0042-audit-tour-demo.md b/docs/adr/ADR-0042-audit-tour-demo.md similarity index 100% rename from docs/decisions/ADR-0042-audit-tour-demo.md rename to docs/adr/ADR-0042-audit-tour-demo.md diff --git a/docs/decisions/ADR-0043-pack-measurements-phase2.md b/docs/adr/ADR-0043-pack-measurements-phase2.md similarity index 100% rename from docs/decisions/ADR-0043-pack-measurements-phase2.md rename to docs/adr/ADR-0043-pack-measurements-phase2.md diff --git a/docs/decisions/ADR-0044-medical-clinical-ethics-pack.md b/docs/adr/ADR-0044-medical-clinical-ethics-pack.md similarity index 100% rename from docs/decisions/ADR-0044-medical-clinical-ethics-pack.md rename to docs/adr/ADR-0044-medical-clinical-ethics-pack.md diff --git a/docs/decisions/ADR-0045-long-context-recall-vs-transformer-baselines.md b/docs/adr/ADR-0045-long-context-recall-vs-transformer-baselines.md similarity index 100% rename from docs/decisions/ADR-0045-long-context-recall-vs-transformer-baselines.md rename to docs/adr/ADR-0045-long-context-recall-vs-transformer-baselines.md diff --git a/docs/decisions/ADR-0046-forward-graph-constraint.md b/docs/adr/ADR-0046-forward-graph-constraint.md similarity index 100% rename from docs/decisions/ADR-0046-forward-graph-constraint.md rename to docs/adr/ADR-0046-forward-graph-constraint.md diff --git a/docs/decisions/ADR-0047-wire-forward-graph-constraint.md b/docs/adr/ADR-0047-wire-forward-graph-constraint.md similarity index 100% rename from docs/decisions/ADR-0047-wire-forward-graph-constraint.md rename to docs/adr/ADR-0047-wire-forward-graph-constraint.md diff --git a/docs/decisions/ADR-0048-pack-grounded-surface.md b/docs/adr/ADR-0048-pack-grounded-surface.md similarity index 100% rename from docs/decisions/ADR-0048-pack-grounded-surface.md rename to docs/adr/ADR-0048-pack-grounded-surface.md diff --git a/docs/decisions/ADR-0049-intent-subject-extraction.md b/docs/adr/ADR-0049-intent-subject-extraction.md similarity index 100% rename from docs/decisions/ADR-0049-intent-subject-extraction.md rename to docs/adr/ADR-0049-intent-subject-extraction.md diff --git a/docs/decisions/ADR-0050-pack-grounded-comparison.md b/docs/adr/ADR-0050-pack-grounded-comparison.md similarity index 100% rename from docs/decisions/ADR-0050-pack-grounded-comparison.md rename to docs/adr/ADR-0050-pack-grounded-comparison.md diff --git a/docs/decisions/ADR-0051-trust-boundary-hardening.md b/docs/adr/ADR-0051-trust-boundary-hardening.md similarity index 100% rename from docs/decisions/ADR-0051-trust-boundary-hardening.md rename to docs/adr/ADR-0051-trust-boundary-hardening.md diff --git a/docs/decisions/ADR-0052-teaching-grounded-surface.md b/docs/adr/ADR-0052-teaching-grounded-surface.md similarity index 100% rename from docs/decisions/ADR-0052-teaching-grounded-surface.md rename to docs/adr/ADR-0052-teaching-grounded-surface.md diff --git a/docs/decisions/ADR-0053-cognition-lane-closure.md b/docs/adr/ADR-0053-cognition-lane-closure.md similarity index 100% rename from docs/decisions/ADR-0053-cognition-lane-closure.md rename to docs/adr/ADR-0053-cognition-lane-closure.md diff --git a/docs/decisions/ADR-0054-vault-recall-indexing-batching.md b/docs/adr/ADR-0054-vault-recall-indexing-batching.md similarity index 100% rename from docs/decisions/ADR-0054-vault-recall-indexing-batching.md rename to docs/adr/ADR-0054-vault-recall-indexing-batching.md diff --git a/docs/decisions/ADR-0055-inter-session-memory-discovery-promotion.md b/docs/adr/ADR-0055-inter-session-memory-discovery-promotion.md similarity index 100% rename from docs/decisions/ADR-0055-inter-session-memory-discovery-promotion.md rename to docs/adr/ADR-0055-inter-session-memory-discovery-promotion.md diff --git a/docs/decisions/ADR-0056-contemplation-loop-c1.md b/docs/adr/ADR-0056-contemplation-loop-c1.md similarity index 100% rename from docs/decisions/ADR-0056-contemplation-loop-c1.md rename to docs/adr/ADR-0056-contemplation-loop-c1.md diff --git a/docs/decisions/ADR-0057-teaching-chain-proposal-review.md b/docs/adr/ADR-0057-teaching-chain-proposal-review.md similarity index 100% rename from docs/decisions/ADR-0057-teaching-chain-proposal-review.md rename to docs/adr/ADR-0057-teaching-chain-proposal-review.md diff --git a/docs/decisions/ADR-0058-forward-graph-constraint-status.md b/docs/adr/ADR-0058-forward-graph-constraint-status.md similarity index 100% rename from docs/decisions/ADR-0058-forward-graph-constraint-status.md rename to docs/adr/ADR-0058-forward-graph-constraint-status.md diff --git a/docs/decisions/ADR-0059-correction-pass-telemetry.md b/docs/adr/ADR-0059-correction-pass-telemetry.md similarity index 100% rename from docs/decisions/ADR-0059-correction-pass-telemetry.md rename to docs/adr/ADR-0059-correction-pass-telemetry.md diff --git a/docs/decisions/ADR-0060-correction-acknowledgment-topic-lemma.md b/docs/adr/ADR-0060-correction-acknowledgment-topic-lemma.md similarity index 100% rename from docs/decisions/ADR-0060-correction-acknowledgment-topic-lemma.md rename to docs/adr/ADR-0060-correction-acknowledgment-topic-lemma.md diff --git a/docs/decisions/ADR-0061-procedure-intent-pack-grounded-surface.md b/docs/adr/ADR-0061-procedure-intent-pack-grounded-surface.md similarity index 100% rename from docs/decisions/ADR-0061-procedure-intent-pack-grounded-surface.md rename to docs/adr/ADR-0061-procedure-intent-pack-grounded-surface.md diff --git a/docs/decisions/ADR-0062-composed-teaching-grounded-surface.md b/docs/adr/ADR-0062-composed-teaching-grounded-surface.md similarity index 100% rename from docs/decisions/ADR-0062-composed-teaching-grounded-surface.md rename to docs/adr/ADR-0062-composed-teaching-grounded-surface.md diff --git a/docs/decisions/ADR-0063-cross-pack-surface-resolver.md b/docs/adr/ADR-0063-cross-pack-surface-resolver.md similarity index 100% rename from docs/decisions/ADR-0063-cross-pack-surface-resolver.md rename to docs/adr/ADR-0063-cross-pack-surface-resolver.md diff --git a/docs/decisions/ADR-0064-cross-pack-teaching-chains.md b/docs/adr/ADR-0064-cross-pack-teaching-chains.md similarity index 100% rename from docs/decisions/ADR-0064-cross-pack-teaching-chains.md rename to docs/adr/ADR-0064-cross-pack-teaching-chains.md diff --git a/docs/decisions/ADR-0065-oov-gradient-and-relations-v2.md b/docs/adr/ADR-0065-oov-gradient-and-relations-v2.md similarity index 100% rename from docs/decisions/ADR-0065-oov-gradient-and-relations-v2.md rename to docs/adr/ADR-0065-oov-gradient-and-relations-v2.md diff --git a/docs/decisions/ADR-0066-turn-level-composition.md b/docs/adr/ADR-0066-turn-level-composition.md similarity index 100% rename from docs/decisions/ADR-0066-turn-level-composition.md rename to docs/adr/ADR-0066-turn-level-composition.md diff --git a/docs/decisions/ADR-0067-cross-pack-teaching-chains.md b/docs/adr/ADR-0067-cross-pack-teaching-chains.md similarity index 100% rename from docs/decisions/ADR-0067-cross-pack-teaching-chains.md rename to docs/adr/ADR-0067-cross-pack-teaching-chains.md diff --git a/docs/decisions/ADR-0068-register-pack-class.md b/docs/adr/ADR-0068-register-pack-class.md similarity index 100% rename from docs/decisions/ADR-0068-register-pack-class.md rename to docs/adr/ADR-0068-register-pack-class.md diff --git a/docs/decisions/ADR-0069-realizer-register-parameter.md b/docs/adr/ADR-0069-realizer-register-parameter.md similarity index 100% rename from docs/decisions/ADR-0069-realizer-register-parameter.md rename to docs/adr/ADR-0069-realizer-register-parameter.md diff --git a/docs/decisions/ADR-0070-register-pack-terse-v1.md b/docs/adr/ADR-0070-register-pack-terse-v1.md similarity index 100% rename from docs/decisions/ADR-0070-register-pack-terse-v1.md rename to docs/adr/ADR-0070-register-pack-terse-v1.md diff --git a/docs/decisions/ADR-0071-seeded-surface-variation.md b/docs/adr/ADR-0071-seeded-surface-variation.md similarity index 100% rename from docs/decisions/ADR-0071-seeded-surface-variation.md rename to docs/adr/ADR-0071-seeded-surface-variation.md diff --git a/docs/decisions/ADR-0072-register-telemetry-operator-surface.md b/docs/adr/ADR-0072-register-telemetry-operator-surface.md similarity index 100% rename from docs/decisions/ADR-0072-register-telemetry-operator-surface.md rename to docs/adr/ADR-0072-register-telemetry-operator-surface.md diff --git a/docs/decisions/ADR-0073-anchor-lens-substrate.md b/docs/adr/ADR-0073-anchor-lens-substrate.md similarity index 100% rename from docs/decisions/ADR-0073-anchor-lens-substrate.md rename to docs/adr/ADR-0073-anchor-lens-substrate.md diff --git a/docs/decisions/ADR-0073a-anchor-lens-content-phase.md b/docs/adr/ADR-0073a-anchor-lens-content-phase.md similarity index 100% rename from docs/decisions/ADR-0073a-anchor-lens-content-phase.md rename to docs/adr/ADR-0073a-anchor-lens-content-phase.md diff --git a/docs/decisions/ADR-0073b-anchor-lens-class-loader.md b/docs/adr/ADR-0073b-anchor-lens-class-loader.md similarity index 100% rename from docs/decisions/ADR-0073b-anchor-lens-class-loader.md rename to docs/adr/ADR-0073b-anchor-lens-class-loader.md diff --git a/docs/decisions/ADR-0073c-anchor-lens-composer-wiring.md b/docs/adr/ADR-0073c-anchor-lens-composer-wiring.md similarity index 100% rename from docs/decisions/ADR-0073c-anchor-lens-composer-wiring.md rename to docs/adr/ADR-0073c-anchor-lens-composer-wiring.md diff --git a/docs/decisions/ADR-0073d-anchor-lens-telemetry-tour.md b/docs/adr/ADR-0073d-anchor-lens-telemetry-tour.md similarity index 100% rename from docs/decisions/ADR-0073d-anchor-lens-telemetry-tour.md rename to docs/adr/ADR-0073d-anchor-lens-telemetry-tour.md diff --git a/docs/decisions/ADR-0074-orthogonality-tour.md b/docs/adr/ADR-0074-orthogonality-tour.md similarity index 100% rename from docs/decisions/ADR-0074-orthogonality-tour.md rename to docs/adr/ADR-0074-orthogonality-tour.md diff --git a/docs/decisions/ADR-0075-realizer-slot-type-guard.md b/docs/adr/ADR-0075-realizer-slot-type-guard.md similarity index 100% rename from docs/decisions/ADR-0075-realizer-slot-type-guard.md rename to docs/adr/ADR-0075-realizer-slot-type-guard.md diff --git a/docs/decisions/ADR-0076-confirmation-tag-normalization.md b/docs/adr/ADR-0076-confirmation-tag-normalization.md similarity index 100% rename from docs/decisions/ADR-0076-confirmation-tag-normalization.md rename to docs/adr/ADR-0076-confirmation-tag-normalization.md diff --git a/docs/decisions/ADR-0077-substantive-register-knobs.md b/docs/adr/ADR-0077-substantive-register-knobs.md similarity index 100% rename from docs/decisions/ADR-0077-substantive-register-knobs.md rename to docs/adr/ADR-0077-substantive-register-knobs.md diff --git a/docs/decisions/ADR-0078-composer-graph-atom-equivalence.md b/docs/adr/ADR-0078-composer-graph-atom-equivalence.md similarity index 100% rename from docs/decisions/ADR-0078-composer-graph-atom-equivalence.md rename to docs/adr/ADR-0078-composer-graph-atom-equivalence.md diff --git a/docs/decisions/ADR-0078-phase1-implementation-note.md b/docs/adr/ADR-0078-phase1-implementation-note.md similarity index 100% rename from docs/decisions/ADR-0078-phase1-implementation-note.md rename to docs/adr/ADR-0078-phase1-implementation-note.md diff --git a/docs/decisions/ADR-0080-contemplation-loop.md b/docs/adr/ADR-0080-contemplation-loop.md similarity index 100% rename from docs/decisions/ADR-0080-contemplation-loop.md rename to docs/adr/ADR-0080-contemplation-loop.md diff --git a/docs/decisions/ADR-0083-transitive-chain-surface.md b/docs/adr/ADR-0083-transitive-chain-surface.md similarity index 100% rename from docs/decisions/ADR-0083-transitive-chain-surface.md rename to docs/adr/ADR-0083-transitive-chain-surface.md diff --git a/docs/decisions/ADR-0084-definitional-layer.md b/docs/adr/ADR-0084-definitional-layer.md similarity index 100% rename from docs/decisions/ADR-0084-definitional-layer.md rename to docs/adr/ADR-0084-definitional-layer.md diff --git a/docs/decisions/ADR-0085-gloss-aware-cause.md b/docs/adr/ADR-0085-gloss-aware-cause.md similarity index 100% rename from docs/decisions/ADR-0085-gloss-aware-cause.md rename to docs/adr/ADR-0085-gloss-aware-cause.md diff --git a/docs/decisions/ADR-0087-rhetorical-style-axis.md b/docs/adr/ADR-0087-rhetorical-style-axis.md similarity index 100% rename from docs/decisions/ADR-0087-rhetorical-style-axis.md rename to docs/adr/ADR-0087-rhetorical-style-axis.md diff --git a/docs/decisions/ADR-0091-domain-pack-contract-v1.md b/docs/adr/ADR-0091-domain-pack-contract-v1.md similarity index 100% rename from docs/decisions/ADR-0091-domain-pack-contract-v1.md rename to docs/adr/ADR-0091-domain-pack-contract-v1.md diff --git a/docs/decisions/ADR-0092-reviewer-registry-v1.md b/docs/adr/ADR-0092-reviewer-registry-v1.md similarity index 100% rename from docs/decisions/ADR-0092-reviewer-registry-v1.md rename to docs/adr/ADR-0092-reviewer-registry-v1.md diff --git a/docs/decisions/ADR-0093-domain-pack-contract-v1-implementation.md b/docs/adr/ADR-0093-domain-pack-contract-v1-implementation.md similarity index 100% rename from docs/decisions/ADR-0093-domain-pack-contract-v1-implementation.md rename to docs/adr/ADR-0093-domain-pack-contract-v1-implementation.md diff --git a/docs/decisions/ADR-0094-proposal-source-provenance.md b/docs/adr/ADR-0094-proposal-source-provenance.md similarity index 100% rename from docs/decisions/ADR-0094-proposal-source-provenance.md rename to docs/adr/ADR-0094-proposal-source-provenance.md diff --git a/docs/decisions/ADR-0095-miner-sourced-teaching-proposals.md b/docs/adr/ADR-0095-miner-sourced-teaching-proposals.md similarity index 100% rename from docs/decisions/ADR-0095-miner-sourced-teaching-proposals.md rename to docs/adr/ADR-0095-miner-sourced-teaching-proposals.md diff --git a/docs/decisions/ADR-0096-fabrication-control-eval-lane.md b/docs/adr/ADR-0096-fabrication-control-eval-lane.md similarity index 100% rename from docs/decisions/ADR-0096-fabrication-control-eval-lane.md rename to docs/adr/ADR-0096-fabrication-control-eval-lane.md diff --git a/docs/decisions/ADR-0097-mathematics-logic-reasoning-capable-ratification.md b/docs/adr/ADR-0097-mathematics-logic-reasoning-capable-ratification.md similarity index 100% rename from docs/decisions/ADR-0097-mathematics-logic-reasoning-capable-ratification.md rename to docs/adr/ADR-0097-mathematics-logic-reasoning-capable-ratification.md diff --git a/docs/decisions/ADR-0098-demo-composition-contract.md b/docs/adr/ADR-0098-demo-composition-contract.md similarity index 100% rename from docs/decisions/ADR-0098-demo-composition-contract.md rename to docs/adr/ADR-0098-demo-composition-contract.md diff --git a/docs/decisions/ADR-0099-public-showcase-demo.md b/docs/adr/ADR-0099-public-showcase-demo.md similarity index 100% rename from docs/decisions/ADR-0099-public-showcase-demo.md rename to docs/adr/ADR-0099-public-showcase-demo.md diff --git a/docs/decisions/ADR-0100-physics-reasoning-capable-ratification.md b/docs/adr/ADR-0100-physics-reasoning-capable-ratification.md similarity index 100% rename from docs/decisions/ADR-0100-physics-reasoning-capable-ratification.md rename to docs/adr/ADR-0100-physics-reasoning-capable-ratification.md diff --git a/docs/decisions/ADR-0101-systems-software-reasoning-capable-ratification.md b/docs/adr/ADR-0101-systems-software-reasoning-capable-ratification.md similarity index 100% rename from docs/decisions/ADR-0101-systems-software-reasoning-capable-ratification.md rename to docs/adr/ADR-0101-systems-software-reasoning-capable-ratification.md diff --git a/docs/decisions/ADR-0102-hebrew-greek-reasoning-capable-ratification.md b/docs/adr/ADR-0102-hebrew-greek-reasoning-capable-ratification.md similarity index 100% rename from docs/decisions/ADR-0102-hebrew-greek-reasoning-capable-ratification.md rename to docs/adr/ADR-0102-hebrew-greek-reasoning-capable-ratification.md diff --git a/docs/decisions/ADR-0103-fluency-lane-attachment-for-adr-0102.md b/docs/adr/ADR-0103-fluency-lane-attachment-for-adr-0102.md similarity index 100% rename from docs/decisions/ADR-0103-fluency-lane-attachment-for-adr-0102.md rename to docs/adr/ADR-0103-fluency-lane-attachment-for-adr-0102.md diff --git a/docs/decisions/ADR-0104-curriculum-sourced-teaching-proposals.md b/docs/adr/ADR-0104-curriculum-sourced-teaching-proposals.md similarity index 100% rename from docs/decisions/ADR-0104-curriculum-sourced-teaching-proposals.md rename to docs/adr/ADR-0104-curriculum-sourced-teaching-proposals.md diff --git a/docs/decisions/ADR-0105-sealed-holdout-encryption.md b/docs/adr/ADR-0105-sealed-holdout-encryption.md similarity index 100% rename from docs/decisions/ADR-0105-sealed-holdout-encryption.md rename to docs/adr/ADR-0105-sealed-holdout-encryption.md diff --git a/docs/decisions/ADR-0106-expert-demo-promotion-contract.md b/docs/adr/ADR-0106-expert-demo-promotion-contract.md similarity index 100% rename from docs/decisions/ADR-0106-expert-demo-promotion-contract.md rename to docs/adr/ADR-0106-expert-demo-promotion-contract.md diff --git a/docs/decisions/ADR-0107-mathematics-logic-expert-demo-deferred.md b/docs/adr/ADR-0107-mathematics-logic-expert-demo-deferred.md similarity index 100% rename from docs/decisions/ADR-0107-mathematics-logic-expert-demo-deferred.md rename to docs/adr/ADR-0107-mathematics-logic-expert-demo-deferred.md diff --git a/docs/decisions/ADR-0108-proposed-adr-sequencing.md b/docs/adr/ADR-0108-proposed-adr-sequencing.md similarity index 100% rename from docs/decisions/ADR-0108-proposed-adr-sequencing.md rename to docs/adr/ADR-0108-proposed-adr-sequencing.md diff --git a/docs/decisions/ADR-0109-lane-shape-aware-thresholds.md b/docs/adr/ADR-0109-lane-shape-aware-thresholds.md similarity index 100% rename from docs/decisions/ADR-0109-lane-shape-aware-thresholds.md rename to docs/adr/ADR-0109-lane-shape-aware-thresholds.md diff --git a/docs/decisions/ADR-0110-mathematics-logic-expert-demo-promotion.md b/docs/adr/ADR-0110-mathematics-logic-expert-demo-promotion.md similarity index 100% rename from docs/decisions/ADR-0110-mathematics-logic-expert-demo-promotion.md rename to docs/adr/ADR-0110-mathematics-logic-expert-demo-promotion.md diff --git a/docs/decisions/ADR-0111-physics-expert-demo-promotion.md b/docs/adr/ADR-0111-physics-expert-demo-promotion.md similarity index 100% rename from docs/decisions/ADR-0111-physics-expert-demo-promotion.md rename to docs/adr/ADR-0111-physics-expert-demo-promotion.md diff --git a/docs/decisions/ADR-0112-runnable-expert-demo-showcase.md b/docs/adr/ADR-0112-runnable-expert-demo-showcase.md similarity index 100% rename from docs/decisions/ADR-0112-runnable-expert-demo-showcase.md rename to docs/adr/ADR-0112-runnable-expert-demo-showcase.md diff --git a/docs/decisions/ADR-0113-rename-expert-demo-to-audit-passed.md b/docs/adr/ADR-0113-rename-expert-demo-to-audit-passed.md similarity index 100% rename from docs/decisions/ADR-0113-rename-expert-demo-to-audit-passed.md rename to docs/adr/ADR-0113-rename-expert-demo-to-audit-passed.md diff --git a/docs/decisions/ADR-0114-expert-capability-roadmap-gsm8k-first.md b/docs/adr/ADR-0114-expert-capability-roadmap-gsm8k-first.md similarity index 100% rename from docs/decisions/ADR-0114-expert-capability-roadmap-gsm8k-first.md rename to docs/adr/ADR-0114-expert-capability-roadmap-gsm8k-first.md diff --git a/docs/decisions/ADR-0114a-anti-overfitting-proof-obligations.md b/docs/adr/ADR-0114a-anti-overfitting-proof-obligations.md similarity index 100% rename from docs/decisions/ADR-0114a-anti-overfitting-proof-obligations.md rename to docs/adr/ADR-0114a-anti-overfitting-proof-obligations.md diff --git a/docs/decisions/ADR-0114a.10-pack-provenance-auditor.md b/docs/adr/ADR-0114a.10-pack-provenance-auditor.md similarity index 100% rename from docs/decisions/ADR-0114a.10-pack-provenance-auditor.md rename to docs/adr/ADR-0114a.10-pack-provenance-auditor.md diff --git a/docs/decisions/ADR-0114a.2-ood-ratio-auditor.md b/docs/adr/ADR-0114a.2-ood-ratio-auditor.md similarity index 100% rename from docs/decisions/ADR-0114a.2-ood-ratio-auditor.md rename to docs/adr/ADR-0114a.2-ood-ratio-auditor.md diff --git a/docs/decisions/ADR-0114a.5-perturbation-suite.md b/docs/adr/ADR-0114a.5-perturbation-suite.md similarity index 100% rename from docs/decisions/ADR-0114a.5-perturbation-suite.md rename to docs/adr/ADR-0114a.5-perturbation-suite.md diff --git a/docs/decisions/ADR-0114a.6-depth-curve-auditor.md b/docs/adr/ADR-0114a.6-depth-curve-auditor.md similarity index 100% rename from docs/decisions/ADR-0114a.6-depth-curve-auditor.md rename to docs/adr/ADR-0114a.6-depth-curve-auditor.md diff --git a/docs/decisions/ADR-0114a.8-adversarial-auditor.md b/docs/adr/ADR-0114a.8-adversarial-auditor.md similarity index 100% rename from docs/decisions/ADR-0114a.8-adversarial-auditor.md rename to docs/adr/ADR-0114a.8-adversarial-auditor.md diff --git a/docs/decisions/ADR-0115-math-problem-parser-and-graph.md b/docs/adr/ADR-0115-math-problem-parser-and-graph.md similarity index 100% rename from docs/decisions/ADR-0115-math-problem-parser-and-graph.md rename to docs/adr/ADR-0115-math-problem-parser-and-graph.md diff --git a/docs/decisions/ADR-0116-deterministic-solver.md b/docs/adr/ADR-0116-deterministic-solver.md similarity index 100% rename from docs/decisions/ADR-0116-deterministic-solver.md rename to docs/adr/ADR-0116-deterministic-solver.md diff --git a/docs/decisions/ADR-0117-solution-trace-verifier.md b/docs/adr/ADR-0117-solution-trace-verifier.md similarity index 100% rename from docs/decisions/ADR-0117-solution-trace-verifier.md rename to docs/adr/ADR-0117-solution-trace-verifier.md diff --git a/docs/decisions/ADR-0118-stepped-realizer.md b/docs/adr/ADR-0118-stepped-realizer.md similarity index 100% rename from docs/decisions/ADR-0118-stepped-realizer.md rename to docs/adr/ADR-0118-stepped-realizer.md diff --git a/docs/decisions/ADR-0118a-ood-surface-generator.md b/docs/adr/ADR-0118a-ood-surface-generator.md similarity index 100% rename from docs/decisions/ADR-0118a-ood-surface-generator.md rename to docs/adr/ADR-0118a-ood-surface-generator.md diff --git a/docs/decisions/ADR-0119-gsm8k-eval-lane-roadmap.md b/docs/adr/ADR-0119-gsm8k-eval-lane-roadmap.md similarity index 100% rename from docs/decisions/ADR-0119-gsm8k-eval-lane-roadmap.md rename to docs/adr/ADR-0119-gsm8k-eval-lane-roadmap.md diff --git a/docs/decisions/ADR-0119.1-sealed-holdout-fabrication-control.md b/docs/adr/ADR-0119.1-sealed-holdout-fabrication-control.md similarity index 100% rename from docs/decisions/ADR-0119.1-sealed-holdout-fabrication-control.md rename to docs/adr/ADR-0119.1-sealed-holdout-fabrication-control.md diff --git a/docs/decisions/ADR-0119.2-gsm8k-eval-corpus-dev-public.md b/docs/adr/ADR-0119.2-gsm8k-eval-corpus-dev-public.md similarity index 100% rename from docs/decisions/ADR-0119.2-gsm8k-eval-corpus-dev-public.md rename to docs/adr/ADR-0119.2-gsm8k-eval-corpus-dev-public.md diff --git a/docs/decisions/ADR-0119.3-lane-runner.md b/docs/adr/ADR-0119.3-lane-runner.md similarity index 100% rename from docs/decisions/ADR-0119.3-lane-runner.md rename to docs/adr/ADR-0119.3-lane-runner.md diff --git a/docs/decisions/ADR-0119.4-frontier-baseline-comparison.md b/docs/adr/ADR-0119.4-frontier-baseline-comparison.md similarity index 100% rename from docs/decisions/ADR-0119.4-frontier-baseline-comparison.md rename to docs/adr/ADR-0119.4-frontier-baseline-comparison.md diff --git a/docs/decisions/ADR-0119.5-adversarial-generation.md b/docs/adr/ADR-0119.5-adversarial-generation.md similarity index 100% rename from docs/decisions/ADR-0119.5-adversarial-generation.md rename to docs/adr/ADR-0119.5-adversarial-generation.md diff --git a/docs/decisions/ADR-0119.6-depth-curve-harness.md b/docs/adr/ADR-0119.6-depth-curve-harness.md similarity index 100% rename from docs/decisions/ADR-0119.6-depth-curve-harness.md rename to docs/adr/ADR-0119.6-depth-curve-harness.md diff --git a/docs/decisions/ADR-0119.7-sealed-gsm8k-test.md b/docs/adr/ADR-0119.7-sealed-gsm8k-test.md similarity index 100% rename from docs/decisions/ADR-0119.7-sealed-gsm8k-test.md rename to docs/adr/ADR-0119.7-sealed-gsm8k-test.md diff --git a/docs/decisions/ADR-0119.8-lane-gate.md b/docs/adr/ADR-0119.8-lane-gate.md similarity index 100% rename from docs/decisions/ADR-0119.8-lane-gate.md rename to docs/adr/ADR-0119.8-lane-gate.md diff --git a/docs/decisions/ADR-0120-expert-promotion-contract.md b/docs/adr/ADR-0120-expert-promotion-contract.md similarity index 100% rename from docs/decisions/ADR-0120-expert-promotion-contract.md rename to docs/adr/ADR-0120-expert-promotion-contract.md diff --git a/docs/decisions/ADR-0120-math-expert-ledger-flip.md b/docs/adr/ADR-0120-math-expert-ledger-flip.md similarity index 100% rename from docs/decisions/ADR-0120-math-expert-ledger-flip.md rename to docs/adr/ADR-0120-math-expert-ledger-flip.md diff --git a/docs/decisions/ADR-0120-math-expert-promotion-wireup.md b/docs/adr/ADR-0120-math-expert-promotion-wireup.md similarity index 100% rename from docs/decisions/ADR-0120-math-expert-promotion-wireup.md rename to docs/adr/ADR-0120-math-expert-promotion-wireup.md diff --git a/docs/decisions/ADR-0121-mathematics-logic-expert-deferred.md b/docs/adr/ADR-0121-mathematics-logic-expert-deferred.md similarity index 100% rename from docs/decisions/ADR-0121-mathematics-logic-expert-deferred.md rename to docs/adr/ADR-0121-mathematics-logic-expert-deferred.md diff --git a/docs/decisions/ADR-0122-parser-rate-per-unit.md b/docs/adr/ADR-0122-parser-rate-per-unit.md similarity index 100% rename from docs/decisions/ADR-0122-parser-rate-per-unit.md rename to docs/adr/ADR-0122-parser-rate-per-unit.md diff --git a/docs/decisions/ADR-0122-systems-software-audit-passed-deferred.md b/docs/adr/ADR-0122-systems-software-audit-passed-deferred.md similarity index 100% rename from docs/decisions/ADR-0122-systems-software-audit-passed-deferred.md rename to docs/adr/ADR-0122-systems-software-audit-passed-deferred.md diff --git a/docs/decisions/ADR-0123-parser-comparison-phrasing.md b/docs/adr/ADR-0123-parser-comparison-phrasing.md similarity index 100% rename from docs/decisions/ADR-0123-parser-comparison-phrasing.md rename to docs/adr/ADR-0123-parser-comparison-phrasing.md diff --git a/docs/decisions/ADR-0123-symbolic-logic-shape-remap.md b/docs/adr/ADR-0123-symbolic-logic-shape-remap.md similarity index 100% rename from docs/decisions/ADR-0123-symbolic-logic-shape-remap.md rename to docs/adr/ADR-0123-symbolic-logic-shape-remap.md diff --git a/docs/decisions/ADR-0123a-inference-shape-synonym.md b/docs/adr/ADR-0123a-inference-shape-synonym.md similarity index 100% rename from docs/decisions/ADR-0123a-inference-shape-synonym.md rename to docs/adr/ADR-0123a-inference-shape-synonym.md diff --git a/docs/decisions/ADR-0124-systems-software-audit-passed-promotion.md b/docs/adr/ADR-0124-systems-software-audit-passed-promotion.md similarity index 100% rename from docs/decisions/ADR-0124-systems-software-audit-passed-promotion.md rename to docs/adr/ADR-0124-systems-software-audit-passed-promotion.md diff --git a/docs/decisions/ADR-0125-reasoning-isolation-perturbation-suite.md b/docs/adr/ADR-0125-reasoning-isolation-perturbation-suite.md similarity index 100% rename from docs/decisions/ADR-0125-reasoning-isolation-perturbation-suite.md rename to docs/adr/ADR-0125-reasoning-isolation-perturbation-suite.md diff --git a/docs/decisions/ADR-0126-candidate-graph-parser.md b/docs/adr/ADR-0126-candidate-graph-parser.md similarity index 100% rename from docs/decisions/ADR-0126-candidate-graph-parser.md rename to docs/adr/ADR-0126-candidate-graph-parser.md diff --git a/docs/decisions/ADR-0127-0128-RESULTS.md b/docs/adr/ADR-0127-0128-RESULTS.md similarity index 100% rename from docs/decisions/ADR-0127-0128-RESULTS.md rename to docs/adr/ADR-0127-0128-RESULTS.md diff --git a/docs/decisions/ADR-0127-units-pack-and-units-aware-parser.md b/docs/adr/ADR-0127-units-pack-and-units-aware-parser.md similarity index 100% rename from docs/decisions/ADR-0127-units-pack-and-units-aware-parser.md rename to docs/adr/ADR-0127-units-pack-and-units-aware-parser.md diff --git a/docs/decisions/ADR-0128-numerics-pack.md b/docs/adr/ADR-0128-numerics-pack.md similarity index 100% rename from docs/decisions/ADR-0128-numerics-pack.md rename to docs/adr/ADR-0128-numerics-pack.md diff --git a/docs/decisions/ADR-0129-spaced-correction-replay-deferred.md b/docs/adr/ADR-0129-spaced-correction-replay-deferred.md similarity index 100% rename from docs/decisions/ADR-0129-spaced-correction-replay-deferred.md rename to docs/adr/ADR-0129-spaced-correction-replay-deferred.md diff --git a/docs/decisions/ADR-0130-pre-articulation-calibration-deferred.md b/docs/adr/ADR-0130-pre-articulation-calibration-deferred.md similarity index 100% rename from docs/decisions/ADR-0130-pre-articulation-calibration-deferred.md rename to docs/adr/ADR-0130-pre-articulation-calibration-deferred.md diff --git a/docs/decisions/ADR-0131-math-expert-rebench.md b/docs/adr/ADR-0131-math-expert-rebench.md similarity index 100% rename from docs/decisions/ADR-0131-math-expert-rebench.md rename to docs/adr/ADR-0131-math-expert-rebench.md diff --git a/docs/decisions/ADR-0131.1.F-frontier-baseline-comparison.md b/docs/adr/ADR-0131.1.F-frontier-baseline-comparison.md similarity index 100% rename from docs/decisions/ADR-0131.1.F-frontier-baseline-comparison.md rename to docs/adr/ADR-0131.1.F-frontier-baseline-comparison.md diff --git a/docs/decisions/ADR-0131.1.S-sealed-holdout.md b/docs/adr/ADR-0131.1.S-sealed-holdout.md similarity index 100% rename from docs/decisions/ADR-0131.1.S-sealed-holdout.md rename to docs/adr/ADR-0131.1.S-sealed-holdout.md diff --git a/docs/decisions/ADR-0131.2-teaching-corpus-eval.md b/docs/adr/ADR-0131.2-teaching-corpus-eval.md similarity index 100% rename from docs/decisions/ADR-0131.2-teaching-corpus-eval.md rename to docs/adr/ADR-0131.2-teaching-corpus-eval.md diff --git a/docs/decisions/ADR-0131.2.B-teaching-corpus-enrichment.md b/docs/adr/ADR-0131.2.B-teaching-corpus-enrichment.md similarity index 100% rename from docs/decisions/ADR-0131.2.B-teaching-corpus-enrichment.md rename to docs/adr/ADR-0131.2.B-teaching-corpus-enrichment.md diff --git a/docs/decisions/ADR-0131.3-bounded-grammar.md b/docs/adr/ADR-0131.3-bounded-grammar.md similarity index 100% rename from docs/decisions/ADR-0131.3-bounded-grammar.md rename to docs/adr/ADR-0131.3-bounded-grammar.md diff --git a/docs/decisions/ADR-0131.4-composite-math-gate.md b/docs/adr/ADR-0131.4-composite-math-gate.md similarity index 100% rename from docs/decisions/ADR-0131.4-composite-math-gate.md rename to docs/adr/ADR-0131.4-composite-math-gate.md diff --git a/docs/decisions/ADR-0131.5-gsm8k-probe-retirement.md b/docs/adr/ADR-0131.5-gsm8k-probe-retirement.md similarity index 100% rename from docs/decisions/ADR-0131.5-gsm8k-probe-retirement.md rename to docs/adr/ADR-0131.5-gsm8k-probe-retirement.md diff --git a/docs/decisions/ADR-0131.G-gsm8k-coverage-probe.md b/docs/adr/ADR-0131.G-gsm8k-coverage-probe.md similarity index 100% rename from docs/decisions/ADR-0131.G-gsm8k-coverage-probe.md rename to docs/adr/ADR-0131.G-gsm8k-coverage-probe.md diff --git a/docs/decisions/ADR-0131.G.0-probe-substrate.md b/docs/adr/ADR-0131.G.0-probe-substrate.md similarity index 100% rename from docs/decisions/ADR-0131.G.0-probe-substrate.md rename to docs/adr/ADR-0131.G.0-probe-substrate.md diff --git a/docs/decisions/ADR-0131.G.1-verb-classes-initial-state.md b/docs/adr/ADR-0131.G.1-verb-classes-initial-state.md similarity index 100% rename from docs/decisions/ADR-0131.G.1-verb-classes-initial-state.md rename to docs/adr/ADR-0131.G.1-verb-classes-initial-state.md diff --git a/docs/decisions/ADR-0131.G.2-comparatives.md b/docs/adr/ADR-0131.G.2-comparatives.md similarity index 100% rename from docs/decisions/ADR-0131.G.2-comparatives.md rename to docs/adr/ADR-0131.G.2-comparatives.md diff --git a/docs/decisions/ADR-0131.G.3-numerics.md b/docs/adr/ADR-0131.G.3-numerics.md similarity index 100% rename from docs/decisions/ADR-0131.G.3-numerics.md rename to docs/adr/ADR-0131.G.3-numerics.md diff --git a/docs/decisions/ADR-0131.G.3.1-numerics-extensions.md b/docs/adr/ADR-0131.G.3.1-numerics-extensions.md similarity index 100% rename from docs/decisions/ADR-0131.G.3.1-numerics-extensions.md rename to docs/adr/ADR-0131.G.3.1-numerics-extensions.md diff --git a/docs/decisions/ADR-0131.G.4-multi-clause.md b/docs/adr/ADR-0131.G.4-multi-clause.md similarity index 100% rename from docs/decisions/ADR-0131.G.4-multi-clause.md rename to docs/adr/ADR-0131.G.4-multi-clause.md diff --git a/docs/decisions/ADR-0131.G.5-aggregate-answer-composition.md b/docs/adr/ADR-0131.G.5-aggregate-answer-composition.md similarity index 100% rename from docs/decisions/ADR-0131.G.5-aggregate-answer-composition.md rename to docs/adr/ADR-0131.G.5-aggregate-answer-composition.md diff --git a/docs/decisions/ADR-0132-binding-graph-data-model.md b/docs/adr/ADR-0132-binding-graph-data-model.md similarity index 100% rename from docs/decisions/ADR-0132-binding-graph-data-model.md rename to docs/adr/ADR-0132-binding-graph-data-model.md diff --git a/docs/decisions/ADR-0133-binding-graph-adapter.md b/docs/adr/ADR-0133-binding-graph-adapter.md similarity index 100% rename from docs/decisions/ADR-0133-binding-graph-adapter.md rename to docs/adr/ADR-0133-binding-graph-adapter.md diff --git a/docs/decisions/ADR-0134-binding-graph-admissibility.md b/docs/adr/ADR-0134-binding-graph-admissibility.md similarity index 100% rename from docs/decisions/ADR-0134-binding-graph-admissibility.md rename to docs/adr/ADR-0134-binding-graph-admissibility.md diff --git a/docs/decisions/ADR-0135-binding-graph-question-target.md b/docs/adr/ADR-0135-binding-graph-question-target.md similarity index 100% rename from docs/decisions/ADR-0135-binding-graph-question-target.md rename to docs/adr/ADR-0135-binding-graph-question-target.md diff --git a/docs/decisions/ADR-0136-statement-layer-corridor.md b/docs/adr/ADR-0136-statement-layer-corridor.md similarity index 100% rename from docs/decisions/ADR-0136-statement-layer-corridor.md rename to docs/adr/ADR-0136-statement-layer-corridor.md diff --git a/docs/decisions/ADR-0136.S.1-rate-event-statements.md b/docs/adr/ADR-0136.S.1-rate-event-statements.md similarity index 100% rename from docs/decisions/ADR-0136.S.1-rate-event-statements.md rename to docs/adr/ADR-0136.S.1-rate-event-statements.md diff --git a/docs/decisions/ADR-0136.S.2-conditional-op-question.md b/docs/adr/ADR-0136.S.2-conditional-op-question.md similarity index 100% rename from docs/decisions/ADR-0136.S.2-conditional-op-question.md rename to docs/adr/ADR-0136.S.2-conditional-op-question.md diff --git a/docs/decisions/ADR-0136.S.4-novel-initial-form.md b/docs/adr/ADR-0136.S.4-novel-initial-form.md similarity index 100% rename from docs/decisions/ADR-0136.S.4-novel-initial-form.md rename to docs/adr/ADR-0136.S.4-novel-initial-form.md diff --git a/docs/decisions/ADR-0136.S2-post-rescan.md b/docs/adr/ADR-0136.S2-post-rescan.md similarity index 100% rename from docs/decisions/ADR-0136.S2-post-rescan.md rename to docs/adr/ADR-0136.S2-post-rescan.md diff --git a/docs/decisions/ADR-0136.S3-compound-initial-mutation.md b/docs/adr/ADR-0136.S3-compound-initial-mutation.md similarity index 100% rename from docs/decisions/ADR-0136.S3-compound-initial-mutation.md rename to docs/adr/ADR-0136.S3-compound-initial-mutation.md diff --git a/docs/decisions/ADR-0136.S3-post-rescan.md b/docs/adr/ADR-0136.S3-post-rescan.md similarity index 100% rename from docs/decisions/ADR-0136.S3-post-rescan.md rename to docs/adr/ADR-0136.S3-post-rescan.md diff --git a/docs/decisions/ADR-0138-comparative-reference-layer.md b/docs/adr/ADR-0138-comparative-reference-layer.md similarity index 100% rename from docs/decisions/ADR-0138-comparative-reference-layer.md rename to docs/adr/ADR-0138-comparative-reference-layer.md diff --git a/docs/decisions/ADR-0139-arithmetic-as-versor-spike.md b/docs/adr/ADR-0139-arithmetic-as-versor-spike.md similarity index 100% rename from docs/decisions/ADR-0139-arithmetic-as-versor-spike.md rename to docs/adr/ADR-0139-arithmetic-as-versor-spike.md diff --git a/docs/decisions/ADR-0140-core-trace-protocol-v0.md b/docs/adr/ADR-0140-core-trace-protocol-v0.md similarity index 100% rename from docs/decisions/ADR-0140-core-trace-protocol-v0.md rename to docs/adr/ADR-0140-core-trace-protocol-v0.md diff --git a/docs/decisions/ADR-0140-subtract-and-additive-group-closure.md b/docs/adr/ADR-0140-subtract-and-additive-group-closure.md similarity index 100% rename from docs/decisions/ADR-0140-subtract-and-additive-group-closure.md rename to docs/adr/ADR-0140-subtract-and-additive-group-closure.md diff --git a/docs/decisions/ADR-0141-multiply-as-dilator-positive-nonzero.md b/docs/adr/ADR-0141-multiply-as-dilator-positive-nonzero.md similarity index 100% rename from docs/decisions/ADR-0141-multiply-as-dilator-positive-nonzero.md rename to docs/adr/ADR-0141-multiply-as-dilator-positive-nonzero.md diff --git a/docs/decisions/ADR-0142-epistemic-state-taxonomy.md b/docs/adr/ADR-0142-epistemic-state-taxonomy.md similarity index 100% rename from docs/decisions/ADR-0142-epistemic-state-taxonomy.md rename to docs/adr/ADR-0142-epistemic-state-taxonomy.md diff --git a/docs/decisions/ADR-0143-recognition-spike-anti-unification.md b/docs/adr/ADR-0143-recognition-spike-anti-unification.md similarity index 100% rename from docs/decisions/ADR-0143-recognition-spike-anti-unification.md rename to docs/adr/ADR-0143-recognition-spike-anti-unification.md diff --git a/docs/decisions/ADR-0144-proposition-graph-epistemic-carrier.md b/docs/adr/ADR-0144-proposition-graph-epistemic-carrier.md similarity index 100% rename from docs/decisions/ADR-0144-proposition-graph-epistemic-carrier.md rename to docs/adr/ADR-0144-proposition-graph-epistemic-carrier.md diff --git a/docs/decisions/ADR-0145-energy-modulated-surface-readback.md b/docs/adr/ADR-0145-energy-modulated-surface-readback.md similarity index 100% rename from docs/decisions/ADR-0145-energy-modulated-surface-readback.md rename to docs/adr/ADR-0145-energy-modulated-surface-readback.md diff --git a/docs/decisions/ADR-0146-l10-hybrid-engine-state-persistence.md b/docs/adr/ADR-0146-l10-hybrid-engine-state-persistence.md similarity index 100% rename from docs/decisions/ADR-0146-l10-hybrid-engine-state-persistence.md rename to docs/adr/ADR-0146-l10-hybrid-engine-state-persistence.md diff --git a/docs/decisions/ADR-0148-vault-promotion-policy-wiring.md b/docs/adr/ADR-0148-vault-promotion-policy-wiring.md similarity index 100% rename from docs/decisions/ADR-0148-vault-promotion-policy-wiring.md rename to docs/adr/ADR-0148-vault-promotion-policy-wiring.md diff --git a/docs/decisions/ADR-0149-derived-recognizer-pipeline-wiring.md b/docs/adr/ADR-0149-derived-recognizer-pipeline-wiring.md similarity index 100% rename from docs/decisions/ADR-0149-derived-recognizer-pipeline-wiring.md rename to docs/adr/ADR-0149-derived-recognizer-pipeline-wiring.md diff --git a/docs/decisions/ADR-0150-autonomous-inter-session-contemplation.md b/docs/adr/ADR-0150-autonomous-inter-session-contemplation.md similarity index 100% rename from docs/decisions/ADR-0150-autonomous-inter-session-contemplation.md rename to docs/adr/ADR-0150-autonomous-inter-session-contemplation.md diff --git a/docs/decisions/ADR-0151-auto-proposal-pipeline.md b/docs/adr/ADR-0151-auto-proposal-pipeline.md similarity index 100% rename from docs/decisions/ADR-0151-auto-proposal-pipeline.md rename to docs/adr/ADR-0151-auto-proposal-pipeline.md diff --git a/docs/decisions/ADR-0152-learning-arc-demo.md b/docs/adr/ADR-0152-learning-arc-demo.md similarity index 100% rename from docs/decisions/ADR-0152-learning-arc-demo.md rename to docs/adr/ADR-0152-learning-arc-demo.md diff --git a/docs/decisions/ADR-0153-turn-event-trace-hash-backstamp.md b/docs/adr/ADR-0153-turn-event-trace-hash-backstamp.md similarity index 100% rename from docs/decisions/ADR-0153-turn-event-trace-hash-backstamp.md rename to docs/adr/ADR-0153-turn-event-trace-hash-backstamp.md diff --git a/docs/decisions/ADR-0154-recognizer-producer-wiring.md b/docs/adr/ADR-0154-recognizer-producer-wiring.md similarity index 100% rename from docs/decisions/ADR-0154-recognizer-producer-wiring.md rename to docs/adr/ADR-0154-recognizer-producer-wiring.md diff --git a/docs/decisions/ADR-0155-ci-contemplation-runner.md b/docs/adr/ADR-0155-ci-contemplation-runner.md similarity index 100% rename from docs/decisions/ADR-0155-ci-contemplation-runner.md rename to docs/adr/ADR-0155-ci-contemplation-runner.md diff --git a/docs/decisions/ADR-0156-atomic-engine-state-checkpoint.md b/docs/adr/ADR-0156-atomic-engine-state-checkpoint.md similarity index 100% rename from docs/decisions/ADR-0156-atomic-engine-state-checkpoint.md rename to docs/adr/ADR-0156-atomic-engine-state-checkpoint.md diff --git a/docs/decisions/ADR-0157-revision-mismatch-warning.md b/docs/adr/ADR-0157-revision-mismatch-warning.md similarity index 100% rename from docs/decisions/ADR-0157-revision-mismatch-warning.md rename to docs/adr/ADR-0157-revision-mismatch-warning.md diff --git a/docs/decisions/ADR-0158-reboot-event-audit.md b/docs/adr/ADR-0158-reboot-event-audit.md similarity index 100% rename from docs/decisions/ADR-0158-reboot-event-audit.md rename to docs/adr/ADR-0158-reboot-event-audit.md diff --git a/docs/decisions/ADR-0159-contemplation-quality-eval.md b/docs/adr/ADR-0159-contemplation-quality-eval.md similarity index 100% rename from docs/decisions/ADR-0159-contemplation-quality-eval.md rename to docs/adr/ADR-0159-contemplation-quality-eval.md diff --git a/docs/decisions/ADR-0160-core-workbench-v1.md b/docs/adr/ADR-0160-core-workbench-v1.md similarity index 100% rename from docs/decisions/ADR-0160-core-workbench-v1.md rename to docs/adr/ADR-0160-core-workbench-v1.md diff --git a/docs/decisions/ADR-0161-hitl-async-queue.md b/docs/adr/ADR-0161-hitl-async-queue.md similarity index 100% rename from docs/decisions/ADR-0161-hitl-async-queue.md rename to docs/adr/ADR-0161-hitl-async-queue.md diff --git a/docs/decisions/ADR-0162-workbench-design-system.md b/docs/adr/ADR-0162-workbench-design-system.md similarity index 100% rename from docs/decisions/ADR-0162-workbench-design-system.md rename to docs/adr/ADR-0162-workbench-design-system.md diff --git a/docs/decisions/ADR-0163-F2-confuser-corpus-spec.md b/docs/adr/ADR-0163-F2-confuser-corpus-spec.md similarity index 100% rename from docs/decisions/ADR-0163-F2-confuser-corpus-spec.md rename to docs/adr/ADR-0163-F2-confuser-corpus-spec.md diff --git a/docs/decisions/ADR-0163-gsm8k-path-to-mastery.md b/docs/adr/ADR-0163-gsm8k-path-to-mastery.md similarity index 100% rename from docs/decisions/ADR-0163-gsm8k-path-to-mastery.md rename to docs/adr/ADR-0163-gsm8k-path-to-mastery.md diff --git a/docs/decisions/ADR-0164-incremental-comprehension-reader.md b/docs/adr/ADR-0164-incremental-comprehension-reader.md similarity index 100% rename from docs/decisions/ADR-0164-incremental-comprehension-reader.md rename to docs/adr/ADR-0164-incremental-comprehension-reader.md diff --git a/docs/decisions/ADR-0164.1-lexical-primitive-scope.md b/docs/adr/ADR-0164.1-lexical-primitive-scope.md similarity index 100% rename from docs/decisions/ADR-0164.1-lexical-primitive-scope.md rename to docs/adr/ADR-0164.1-lexical-primitive-scope.md diff --git a/docs/decisions/ADR-0164.2-pronoun-entity-resolution.md b/docs/adr/ADR-0164.2-pronoun-entity-resolution.md similarity index 100% rename from docs/decisions/ADR-0164.2-pronoun-entity-resolution.md rename to docs/adr/ADR-0164.2-pronoun-entity-resolution.md diff --git a/docs/decisions/ADR-0164.3-cross-sentence-state.md b/docs/adr/ADR-0164.3-cross-sentence-state.md similarity index 100% rename from docs/decisions/ADR-0164.3-cross-sentence-state.md rename to docs/adr/ADR-0164.3-cross-sentence-state.md diff --git a/docs/decisions/ADR-0164.4-phase2-statement-frame-reader.md b/docs/adr/ADR-0164.4-phase2-statement-frame-reader.md similarity index 100% rename from docs/decisions/ADR-0164.4-phase2-statement-frame-reader.md rename to docs/adr/ADR-0164.4-phase2-statement-frame-reader.md diff --git a/docs/decisions/ADR-0165-regex-scope-rule.md b/docs/adr/ADR-0165-regex-scope-rule.md similarity index 100% rename from docs/decisions/ADR-0165-regex-scope-rule.md rename to docs/adr/ADR-0165-regex-scope-rule.md diff --git a/docs/decisions/ADR-0166-measurement-capability-sequencing.md b/docs/adr/ADR-0166-measurement-capability-sequencing.md similarity index 100% rename from docs/decisions/ADR-0166-measurement-capability-sequencing.md rename to docs/adr/ADR-0166-measurement-capability-sequencing.md diff --git a/docs/decisions/ADR-0167-audit-as-teaching-evidence.md b/docs/adr/ADR-0167-audit-as-teaching-evidence.md similarity index 100% rename from docs/decisions/ADR-0167-audit-as-teaching-evidence.md rename to docs/adr/ADR-0167-audit-as-teaching-evidence.md diff --git a/docs/decisions/ADR-0168-frameclaim-ratification.md b/docs/adr/ADR-0168-frameclaim-ratification.md similarity index 100% rename from docs/decisions/ADR-0168-frameclaim-ratification.md rename to docs/adr/ADR-0168-frameclaim-ratification.md diff --git a/docs/decisions/ADR-0168.1-math-frameclaim-proposal-adapter.md b/docs/adr/ADR-0168.1-math-frameclaim-proposal-adapter.md similarity index 100% rename from docs/decisions/ADR-0168.1-math-frameclaim-proposal-adapter.md rename to docs/adr/ADR-0168.1-math-frameclaim-proposal-adapter.md diff --git a/docs/decisions/ADR-0169-compositionclaim-ratification.md b/docs/adr/ADR-0169-compositionclaim-ratification.md similarity index 100% rename from docs/decisions/ADR-0169-compositionclaim-ratification.md rename to docs/adr/ADR-0169-compositionclaim-ratification.md diff --git a/docs/decisions/ADR-0169.1-math-compositionclaim-proposal-adapter.md b/docs/adr/ADR-0169.1-math-compositionclaim-proposal-adapter.md similarity index 100% rename from docs/decisions/ADR-0169.1-math-compositionclaim-proposal-adapter.md rename to docs/adr/ADR-0169.1-math-compositionclaim-proposal-adapter.md diff --git a/docs/decisions/ADR-0170-injector-contract-widening.md b/docs/adr/ADR-0170-injector-contract-widening.md similarity index 100% rename from docs/decisions/ADR-0170-injector-contract-widening.md rename to docs/adr/ADR-0170-injector-contract-widening.md diff --git a/docs/decisions/ADR-0172-math-corpus-decomposition-mechanism.md b/docs/adr/ADR-0172-math-corpus-decomposition-mechanism.md similarity index 100% rename from docs/decisions/ADR-0172-math-corpus-decomposition-mechanism.md rename to docs/adr/ADR-0172-math-corpus-decomposition-mechanism.md diff --git a/docs/decisions/ADR-0173-workbench-ratification-trust-boundary.md b/docs/adr/ADR-0173-workbench-ratification-trust-boundary.md similarity index 100% rename from docs/decisions/ADR-0173-workbench-ratification-trust-boundary.md rename to docs/adr/ADR-0173-workbench-ratification-trust-boundary.md diff --git a/docs/decisions/ADR-0174-held-hypothesis-comprehension.md b/docs/adr/ADR-0174-held-hypothesis-comprehension.md similarity index 100% rename from docs/decisions/ADR-0174-held-hypothesis-comprehension.md rename to docs/adr/ADR-0174-held-hypothesis-comprehension.md diff --git a/docs/decisions/ADR-0175-calibrated-attempt-and-eliminate-learning.md b/docs/adr/ADR-0175-calibrated-attempt-and-eliminate-learning.md similarity index 100% rename from docs/decisions/ADR-0175-calibrated-attempt-and-eliminate-learning.md rename to docs/adr/ADR-0175-calibrated-attempt-and-eliminate-learning.md diff --git a/docs/decisions/ADR-0176-multistep-composition-question-targeting.md b/docs/adr/ADR-0176-multistep-composition-question-targeting.md similarity index 100% rename from docs/decisions/ADR-0176-multistep-composition-question-targeting.md rename to docs/adr/ADR-0176-multistep-composition-question-targeting.md diff --git a/docs/decisions/ADR-0177-cue-precision-learning.md b/docs/adr/ADR-0177-cue-precision-learning.md similarity index 100% rename from docs/decisions/ADR-0177-cue-precision-learning.md rename to docs/adr/ADR-0177-cue-precision-learning.md diff --git a/docs/decisions/ADR-0178-GB3b-referent-accumulation-scope.md b/docs/adr/ADR-0178-GB3b-referent-accumulation-scope.md similarity index 100% rename from docs/decisions/ADR-0178-GB3b-referent-accumulation-scope.md rename to docs/adr/ADR-0178-GB3b-referent-accumulation-scope.md diff --git a/docs/decisions/ADR-0178-compositional-structure.md b/docs/adr/ADR-0178-compositional-structure.md similarity index 100% rename from docs/decisions/ADR-0178-compositional-structure.md rename to docs/adr/ADR-0178-compositional-structure.md diff --git a/docs/decisions/ADR-0179-extraction-richness.md b/docs/adr/ADR-0179-extraction-richness.md similarity index 100% rename from docs/decisions/ADR-0179-extraction-richness.md rename to docs/adr/ADR-0179-extraction-richness.md diff --git a/docs/decisions/ADR-0180-crdt-sharded-vault-concurrency.md b/docs/adr/ADR-0180-crdt-sharded-vault-concurrency.md similarity index 100% rename from docs/decisions/ADR-0180-crdt-sharded-vault-concurrency.md rename to docs/adr/ADR-0180-crdt-sharded-vault-concurrency.md diff --git a/docs/decisions/ADR-0181-audio-compiler-delta-crdt.md b/docs/adr/ADR-0181-audio-compiler-delta-crdt.md similarity index 100% rename from docs/decisions/ADR-0181-audio-compiler-delta-crdt.md rename to docs/adr/ADR-0181-audio-compiler-delta-crdt.md diff --git a/docs/decisions/ADR-0182-cross-composer-disagreement-pooling.md b/docs/adr/ADR-0182-cross-composer-disagreement-pooling.md similarity index 100% rename from docs/decisions/ADR-0182-cross-composer-disagreement-pooling.md rename to docs/adr/ADR-0182-cross-composer-disagreement-pooling.md diff --git a/docs/decisions/ADR-0183-lawful-audio-lexeme-path.md b/docs/adr/ADR-0183-lawful-audio-lexeme-path.md similarity index 100% rename from docs/decisions/ADR-0183-lawful-audio-lexeme-path.md rename to docs/adr/ADR-0183-lawful-audio-lexeme-path.md diff --git a/docs/decisions/ADR-0184-distinct-unit-product-rule.md b/docs/adr/ADR-0184-distinct-unit-product-rule.md similarity index 100% rename from docs/decisions/ADR-0184-distinct-unit-product-rule.md rename to docs/adr/ADR-0184-distinct-unit-product-rule.md diff --git a/docs/decisions/ADR-0184-scoped-semantic-state-transitions.md b/docs/adr/ADR-0184-scoped-semantic-state-transitions.md similarity index 100% rename from docs/decisions/ADR-0184-scoped-semantic-state-transitions.md rename to docs/adr/ADR-0184-scoped-semantic-state-transitions.md diff --git a/docs/decisions/ADR-0185-division-reading.md b/docs/adr/ADR-0185-division-reading.md similarity index 100% rename from docs/decisions/ADR-0185-division-reading.md rename to docs/adr/ADR-0185-division-reading.md diff --git a/docs/decisions/ADR-0186-sealed-candidate-graph-injector-lane.md b/docs/adr/ADR-0186-sealed-candidate-graph-injector-lane.md similarity index 100% rename from docs/decisions/ADR-0186-sealed-candidate-graph-injector-lane.md rename to docs/adr/ADR-0186-sealed-candidate-graph-injector-lane.md diff --git a/docs/decisions/ADR-0189-comparative-verb-unit-widening.md b/docs/adr/ADR-0189-comparative-verb-unit-widening.md similarity index 100% rename from docs/decisions/ADR-0189-comparative-verb-unit-widening.md rename to docs/adr/ADR-0189-comparative-verb-unit-widening.md diff --git a/docs/decisions/ADR-0189a-day-enum-activity-first-flip.md b/docs/adr/ADR-0189a-day-enum-activity-first-flip.md similarity index 100% rename from docs/decisions/ADR-0189a-day-enum-activity-first-flip.md rename to docs/adr/ADR-0189a-day-enum-activity-first-flip.md diff --git a/docs/decisions/ADR-0191-candidate-graph-completeness-guard.md b/docs/adr/ADR-0191-candidate-graph-completeness-guard.md similarity index 100% rename from docs/decisions/ADR-0191-candidate-graph-completeness-guard.md rename to docs/adr/ADR-0191-candidate-graph-completeness-guard.md diff --git a/docs/decisions/ADR-0192-discrete-count-open-noun-class.md b/docs/adr/ADR-0192-discrete-count-open-noun-class.md similarity index 100% rename from docs/decisions/ADR-0192-discrete-count-open-noun-class.md rename to docs/adr/ADR-0192-discrete-count-open-noun-class.md diff --git a/docs/decisions/ADR-0193-aggregate-existential-question-frame.md b/docs/adr/ADR-0193-aggregate-existential-question-frame.md similarity index 100% rename from docs/decisions/ADR-0193-aggregate-existential-question-frame.md rename to docs/adr/ADR-0193-aggregate-existential-question-frame.md diff --git a/docs/decisions/ADR-0194-labeled-container-subject.md b/docs/adr/ADR-0194-labeled-container-subject.md similarity index 100% rename from docs/decisions/ADR-0194-labeled-container-subject.md rename to docs/adr/ADR-0194-labeled-container-subject.md diff --git a/docs/decisions/ADR-0195-product-promotion-bridge.md b/docs/adr/ADR-0195-product-promotion-bridge.md similarity index 100% rename from docs/decisions/ADR-0195-product-promotion-bridge.md rename to docs/adr/ADR-0195-product-promotion-bridge.md diff --git a/docs/decisions/ADR-0196-native-substrate-language-doctrine.md b/docs/adr/ADR-0196-native-substrate-language-doctrine.md similarity index 100% rename from docs/decisions/ADR-0196-native-substrate-language-doctrine.md rename to docs/adr/ADR-0196-native-substrate-language-doctrine.md diff --git a/docs/decisions/ADR-0197-vision-compiler-delta-crdt.md b/docs/adr/ADR-0197-vision-compiler-delta-crdt.md similarity index 100% rename from docs/decisions/ADR-0197-vision-compiler-delta-crdt.md rename to docs/adr/ADR-0197-vision-compiler-delta-crdt.md diff --git a/docs/decisions/ADR-0198-motor-efferent-decoder-spike.md b/docs/adr/ADR-0198-motor-efferent-decoder-spike.md similarity index 100% rename from docs/decisions/ADR-0198-motor-efferent-decoder-spike.md rename to docs/adr/ADR-0198-motor-efferent-decoder-spike.md diff --git a/docs/decisions/ADR-0199-cross-domain-learning-arena-contract.md b/docs/adr/ADR-0199-cross-domain-learning-arena-contract.md similarity index 100% rename from docs/decisions/ADR-0199-cross-domain-learning-arena-contract.md rename to docs/adr/ADR-0199-cross-domain-learning-arena-contract.md diff --git a/docs/decisions/ADR-0200-expert-claim-reconciliation.md b/docs/adr/ADR-0200-expert-claim-reconciliation.md similarity index 100% rename from docs/decisions/ADR-0200-expert-claim-reconciliation.md rename to docs/adr/ADR-0200-expert-claim-reconciliation.md diff --git a/docs/decisions/ADR-0201-proposition-canonicalizer.md b/docs/adr/ADR-0201-proposition-canonicalizer.md similarity index 100% rename from docs/decisions/ADR-0201-proposition-canonicalizer.md rename to docs/adr/ADR-0201-proposition-canonicalizer.md diff --git a/docs/decisions/ADR-0201.1-out-of-regime-detector.md b/docs/adr/ADR-0201.1-out-of-regime-detector.md similarity index 100% rename from docs/decisions/ADR-0201.1-out-of-regime-detector.md rename to docs/adr/ADR-0201.1-out-of-regime-detector.md diff --git a/docs/decisions/ADR-0202-proposition-representation-contract.md b/docs/adr/ADR-0202-proposition-representation-contract.md similarity index 100% rename from docs/decisions/ADR-0202-proposition-representation-contract.md rename to docs/adr/ADR-0202-proposition-representation-contract.md diff --git a/docs/decisions/ADR-0203-binding-graph-acyclicity-invariant.md b/docs/adr/ADR-0203-binding-graph-acyclicity-invariant.md similarity index 100% rename from docs/decisions/ADR-0203-binding-graph-acyclicity-invariant.md rename to docs/adr/ADR-0203-binding-graph-acyclicity-invariant.md diff --git a/docs/decisions/ADR-0204-proof-graph-builder.md b/docs/adr/ADR-0204-proof-graph-builder.md similarity index 100% rename from docs/decisions/ADR-0204-proof-graph-builder.md rename to docs/adr/ADR-0204-proof-graph-builder.md diff --git a/docs/decisions/ADR-0205-modus-ponens-disagreement-rule.md b/docs/adr/ADR-0205-modus-ponens-disagreement-rule.md similarity index 100% rename from docs/decisions/ADR-0205-modus-ponens-disagreement-rule.md rename to docs/adr/ADR-0205-modus-ponens-disagreement-rule.md diff --git a/docs/decisions/ADR-0206-response-governance-bridge.md b/docs/adr/ADR-0206-response-governance-bridge.md similarity index 100% rename from docs/decisions/ADR-0206-response-governance-bridge.md rename to docs/adr/ADR-0206-response-governance-bridge.md diff --git a/docs/decisions/ADR-0207-gsm8k-substrate-ratification.md b/docs/adr/ADR-0207-gsm8k-substrate-ratification.md similarity index 100% rename from docs/decisions/ADR-0207-gsm8k-substrate-ratification.md rename to docs/adr/ADR-0207-gsm8k-substrate-ratification.md diff --git a/docs/decisions/ADR-0208-environmental-sensorium-loop.md b/docs/adr/ADR-0208-environmental-sensorium-loop.md similarity index 100% rename from docs/decisions/ADR-0208-environmental-sensorium-loop.md rename to docs/adr/ADR-0208-environmental-sensorium-loop.md diff --git a/docs/decisions/ADR-0209-sensorimotor-feedback-contract.md b/docs/adr/ADR-0209-sensorimotor-feedback-contract.md similarity index 100% rename from docs/decisions/ADR-0209-sensorimotor-feedback-contract.md rename to docs/adr/ADR-0209-sensorimotor-feedback-contract.md diff --git a/docs/decisions/ADR-0210-l10-grounding-pack.md b/docs/adr/ADR-0210-l10-grounding-pack.md similarity index 100% rename from docs/decisions/ADR-0210-l10-grounding-pack.md rename to docs/adr/ADR-0210-l10-grounding-pack.md diff --git a/docs/decisions/ADR-0211-conformal-falsification-bench.md b/docs/adr/ADR-0211-conformal-falsification-bench.md similarity index 100% rename from docs/decisions/ADR-0211-conformal-falsification-bench.md rename to docs/adr/ADR-0211-conformal-falsification-bench.md diff --git a/docs/decisions/ADR-0216-motor-verdict-lowering.md b/docs/adr/ADR-0216-motor-verdict-lowering.md similarity index 100% rename from docs/decisions/ADR-0216-motor-verdict-lowering.md rename to docs/adr/ADR-0216-motor-verdict-lowering.md diff --git a/docs/decisions/ADR-0217-r2-finite-integer-constraint-compiler.md b/docs/adr/ADR-0217-r2-finite-integer-constraint-compiler.md similarity index 100% rename from docs/decisions/ADR-0217-r2-finite-integer-constraint-compiler.md rename to docs/adr/ADR-0217-r2-finite-integer-constraint-compiler.md diff --git a/docs/decisions/ADR-0218-proof-carrying-coherence-promotion.md b/docs/adr/ADR-0218-proof-carrying-coherence-promotion.md similarity index 100% rename from docs/decisions/ADR-0218-proof-carrying-coherence-promotion.md rename to docs/adr/ADR-0218-proof-carrying-coherence-promotion.md diff --git a/docs/decisions/ADR-0219-generation-checkpoint-atomicity.md b/docs/adr/ADR-0219-generation-checkpoint-atomicity.md similarity index 100% rename from docs/decisions/ADR-0219-generation-checkpoint-atomicity.md rename to docs/adr/ADR-0219-generation-checkpoint-atomicity.md diff --git a/docs/decisions/ADR-0220-engine-identity-vs-build-provenance.md b/docs/adr/ADR-0220-engine-identity-vs-build-provenance.md similarity index 100% rename from docs/decisions/ADR-0220-engine-identity-vs-build-provenance.md rename to docs/adr/ADR-0220-engine-identity-vs-build-provenance.md diff --git a/docs/decisions/ADR-0221-codeowners-review-topology.md b/docs/adr/ADR-0221-codeowners-review-topology.md similarity index 100% rename from docs/decisions/ADR-0221-codeowners-review-topology.md rename to docs/adr/ADR-0221-codeowners-review-topology.md diff --git a/docs/decisions/ADR-0222-frame-verdict-closed-world.md b/docs/adr/ADR-0222-frame-verdict-closed-world.md similarity index 100% rename from docs/decisions/ADR-0222-frame-verdict-closed-world.md rename to docs/adr/ADR-0222-frame-verdict-closed-world.md diff --git a/docs/decisions/ADR-0223-semantic-substrate-affordance-audit.md b/docs/adr/ADR-0223-semantic-substrate-affordance-audit.md similarity index 100% rename from docs/decisions/ADR-0223-semantic-substrate-affordance-audit.md rename to docs/adr/ADR-0223-semantic-substrate-affordance-audit.md diff --git a/docs/decisions/ADR-0224-foundational-substrate-readiness-map.md b/docs/adr/ADR-0224-foundational-substrate-readiness-map.md similarity index 100% rename from docs/decisions/ADR-0224-foundational-substrate-readiness-map.md rename to docs/adr/ADR-0224-foundational-substrate-readiness-map.md diff --git a/docs/decisions/ADR-0225-adr-corpus-hygiene.md b/docs/adr/ADR-0225-adr-corpus-hygiene.md similarity index 100% rename from docs/decisions/ADR-0225-adr-corpus-hygiene.md rename to docs/adr/ADR-0225-adr-corpus-hygiene.md diff --git a/docs/decisions/BRIEF-11D-next-capability-proposal.md b/docs/adr/BRIEF-11D-next-capability-proposal.md similarity index 100% rename from docs/decisions/BRIEF-11D-next-capability-proposal.md rename to docs/adr/BRIEF-11D-next-capability-proposal.md diff --git a/docs/decisions/L10-runtime-model-scope.md b/docs/adr/L10-runtime-model-scope.md similarity index 100% rename from docs/decisions/L10-runtime-model-scope.md rename to docs/adr/L10-runtime-model-scope.md diff --git a/docs/decisions/L11-hitl-async-queue-scope.md b/docs/adr/L11-hitl-async-queue-scope.md similarity index 100% rename from docs/decisions/L11-hitl-async-queue-scope.md rename to docs/adr/L11-hitl-async-queue-scope.md diff --git a/docs/adr/README.md b/docs/adr/README.md new file mode 100644 index 00000000..b6195698 --- /dev/null +++ b/docs/adr/README.md @@ -0,0 +1,3 @@ +# Architecture Decision Records (ADRs) + +Canonical directory for all ADRs. diff --git a/docs/decisions/SESSION-2026-05-12-b.md b/docs/adr/SESSION-2026-05-12-b.md similarity index 100% rename from docs/decisions/SESSION-2026-05-12-b.md rename to docs/adr/SESSION-2026-05-12-b.md diff --git a/docs/decisions/SESSION-2026-05-12-language-packs-addendum.md b/docs/adr/SESSION-2026-05-12-language-packs-addendum.md similarity index 100% rename from docs/decisions/SESSION-2026-05-12-language-packs-addendum.md rename to docs/adr/SESSION-2026-05-12-language-packs-addendum.md diff --git a/docs/decisions/SESSION-2026-05-12.md b/docs/adr/SESSION-2026-05-12.md similarity index 100% rename from docs/decisions/SESSION-2026-05-12.md rename to docs/adr/SESSION-2026-05-12.md diff --git a/docs/decisions/SESSION-2026-05-13.md b/docs/adr/SESSION-2026-05-13.md similarity index 100% rename from docs/decisions/SESSION-2026-05-13.md rename to docs/adr/SESSION-2026-05-13.md diff --git a/docs/decisions/SESSION-2026-05-26-comprehension-reader.md b/docs/adr/SESSION-2026-05-26-comprehension-reader.md similarity index 100% rename from docs/decisions/SESSION-2026-05-26-comprehension-reader.md rename to docs/adr/SESSION-2026-05-26-comprehension-reader.md diff --git a/docs/decisions/SESSION-2026-05-27-adr-0167-parallel-dispatch.md b/docs/adr/SESSION-2026-05-27-adr-0167-parallel-dispatch.md similarity index 100% rename from docs/decisions/SESSION-2026-05-27-adr-0167-parallel-dispatch.md rename to docs/adr/SESSION-2026-05-27-adr-0167-parallel-dispatch.md diff --git a/docs/decisions/SESSION-2026-05-27-tier3-sequencing.md b/docs/adr/SESSION-2026-05-27-tier3-sequencing.md similarity index 100% rename from docs/decisions/SESSION-2026-05-27-tier3-sequencing.md rename to docs/adr/SESSION-2026-05-27-tier3-sequencing.md diff --git a/docs/decisions/epistemic-state-taxonomy-scope.md b/docs/adr/epistemic-state-taxonomy-scope.md similarity index 100% rename from docs/decisions/epistemic-state-taxonomy-scope.md rename to docs/adr/epistemic-state-taxonomy-scope.md diff --git a/docs/decisions/proposition-graph-scope.md b/docs/adr/proposition-graph-scope.md similarity index 100% rename from docs/decisions/proposition-graph-scope.md rename to docs/adr/proposition-graph-scope.md diff --git a/docs/decisions/recognizer-storage-scope.md b/docs/adr/recognizer-storage-scope.md similarity index 100% rename from docs/decisions/recognizer-storage-scope.md rename to docs/adr/recognizer-storage-scope.md diff --git a/docs/decisions/substrate-liveness-audit-scope.md b/docs/adr/substrate-liveness-audit-scope.md similarity index 100% rename from docs/decisions/substrate-liveness-audit-scope.md rename to docs/adr/substrate-liveness-audit-scope.md diff --git a/docs/decisions/teaching-derived-recognition-scope.md b/docs/adr/teaching-derived-recognition-scope.md similarity index 100% rename from docs/decisions/teaching-derived-recognition-scope.md rename to docs/adr/teaching-derived-recognition-scope.md diff --git a/docs/agents/grok/README.md b/docs/agents/grok/README.md new file mode 100644 index 00000000..c192aa0c --- /dev/null +++ b/docs/agents/grok/README.md @@ -0,0 +1,3 @@ +# Grok Agent + +Operational guide for using Grok 4.3 + Grok Build with CORE. diff --git a/docs/audio_pipeline_overview.md b/docs/architecture/audio_pipeline_overview.md similarity index 100% rename from docs/audio_pipeline_overview.md rename to docs/architecture/audio_pipeline_overview.md diff --git a/docs/truth_seeking_schema.md b/docs/architecture/truth_seeking_schema.md similarity index 100% rename from docs/truth_seeking_schema.md rename to docs/architecture/truth_seeking_schema.md diff --git a/docs/claims_ledger.md b/docs/audit/claims_ledger.md similarity index 100% rename from docs/claims_ledger.md rename to docs/audit/claims_ledger.md diff --git a/docs/brief/brain_corp_brief.md b/docs/briefs/brain_corp_brief.md similarity index 100% rename from docs/brief/brain_corp_brief.md rename to docs/briefs/brain_corp_brief.md diff --git a/docs/decisions/README.md b/docs/decisions/README.md deleted file mode 100644 index 98419e75..00000000 --- a/docs/decisions/README.md +++ /dev/null @@ -1,501 +0,0 @@ -# Architecture Decision Records - -This directory contains the Architecture Decision Records (ADRs) for the CORE project. - -ADRs record significant architectural decisions: what was decided, why, what alternatives were considered, and what consequences follow. They are permanent records — superseded ADRs are archived, not deleted. - ---- - -## Index - -| ADR | Title | Status | -|---|---|---| -| [ADR-0001](ADR-0001-vocab-layer-invariants.md) | VocabManifold Versor Invariant | Accepted | -| [ADR-0002](ADR-0002-ingest-layer-design.md) | Ingest Layer Architecture | Accepted | -| [ADR-0003](ADR-0003-coordinate-system-dissolution.md) | Coordinate System Dissolution | Accepted | -| [ADR-0004](ADR-0004-rotor-as-operator-not-property.md) | Rotor as Operator, Not Vocabulary Property | Accepted | -| [ADR-0005](ADR-0005-language-pack-contract.md) | Language Pack Contract | Accepted | -| [ADR-0006](ADR-0006-field-energy-operator.md) | The Field Energy Operator (Hamiltonian Companion Field) | Implemented | -| [ADR-0007](ADR-0007-valence-layer.md) | The Valence Layer | Accepted | -| [ADR-0008](ADR-0008-allocation-physics.md) | Allocation Physics | Accepted | -| [ADR-0009](ADR-0009-compositional-physics.md) | Compositional Physics | Accepted | -| [ADR-0010](ADR-0010-identity-physics.md) | Identity Physics | Accepted | -| [ADR-0011](ADR-0011-renderer.md) | Renderer Layer Contract | Accepted | -| [ADR-0012](ADR-0012-core-ingest-governance-layer.md) | `core_ingest` Governance Layer | Accepted | -| [ADR-0013](ADR-0013-sensorium-multimodal-protocol.md) | `sensorium/` Multimodal Protocol Layer | Accepted | -| [ADR-0014](ADR-0014-train-learning-loop.md) | `train/` Learning Loop | Accepted (Stub) | -| [ADR-0015](ADR-0015-language-packs-and-holonomy-resonance.md) | Language Packs as Compiled Linguistic Manifolds | Accepted | -| [ADR-0016](ADR-0016-capability-roadmap.md) | Capability Roadmap and Eval Methodology | Accepted | -| [ADR-0017](ADR-0017-agency-scope.md) | Agency Scope: Responsive-with-Axiology | Accepted | -| [ADR-0018](ADR-0018-tool-use-scope.md) | Tool Use Scope: Typed Deterministic Operators | Accepted | -| [ADR-0019](ADR-0019-exact-vault-recall-acceleration.md) | Exact Vault Recall Acceleration | Accepted | -| [ADR-0020](ADR-0020-phase5-rust-parity-sequencing.md) | Phase 5 / Rust Parity Sequencing | Accepted (2026-05-16) | -| [ADR-0021](ADR-0021-epistemic-grade-policy.md) | Epistemic Grade Policy | Accepted | -| [ADR-0022](ADR-0022-forward-semantic-control.md) | Forward Semantic Control | Accepted (2026-05-17 — all five TBDs addressed; all | -| [ADR-0023](ADR-0023-forward-semantic-control-proof.md) | Forward Semantic Control: Proof Evidence | — | -| [ADR-0024](ADR-0024-inner-loop-admissibility.md) | Inner-Loop Per-Rotor Admissibility | — | -| [ADR-0025](ADR-0025-rotor-frame-admissibility-design-note.md) | Rotor / Frame Admissibility | — | -| [ADR-0026](ADR-0026-ranked-admissibility-with-margin.md) | Ranked Admissibility with Margin | Accepted (2026-05-17) | -| [ADR-0027](ADR-0027-identity-packs.md) | Identity Packs — Load-Bearing, Swappable, Ratified | Accepted (2026-05-17) — Phases 1–6 complete; Phase 7 (this doc + the operational reference) complete; deep realizer wiring landed under [ADR-0028](ADR-0028-identity-surface-wiring.md) (2026-05-17). | -| [ADR-0028](ADR-0028-identity-surface-wiring.md) | Identity Surface Wiring — Pack-Driven Hedge & Claim Strength | Accepted (2026-05-17) | -| [ADR-0029](ADR-0029-safety-packs.md) | Safety Packs — Always-Loaded, Never-Replaceable Boundaries | Accepted (2026-05-17) | -| [ADR-0030](ADR-0030-depth-language-hedge.md) | Depth-Language Hedge Wiring | Accepted (2026-05-17) | -| [ADR-0031](ADR-0031-score-decomposition-surface.md) | Score-Decomposition Surface — Per-Axis Hedge Phrases | Accepted (2026-05-17) | -| [ADR-0032](ADR-0032-safety-check-surface.md) | SafetyCheck — Structural Surface for Safety-Pack Boundaries | Accepted (2026-05-17) | -| [ADR-0033](ADR-0033-ethics-packs.md) | Ethics Packs — Swappable Domain Commitments | Accepted (2026-05-17) | -| [ADR-0034](ADR-0034-ethics-check-surface.md) | EthicsCheck — Structural Surface for Ethics-Pack Commitments | Accepted (2026-05-17) | -| [ADR-0035](ADR-0035-turn-loop-verdict-surfacing.md) | Turn-Loop Verdict Surfacing for SafetyCheck and EthicsCheck | Accepted (2026-05-17) | -| [ADR-0036](ADR-0036-safety-refusal-policy.md) | Safety-Only Typed Refusal Policy | Accepted (2026-05-17) | -| [ADR-0037](ADR-0037-per-predicate-ethics-refusal.md) | Per-Predicate Ethics Refusal Opt-In | Accepted (2026-05-17) | -| [ADR-0038](ADR-0038-hedge-injection.md) | Hedge Injection as a Runtime-Level Affordance | Accepted (2026-05-17) | -| [ADR-0039](ADR-0039-audit-completeness.md) | Audit Completeness — `TurnVerdicts` Bundle, Stub-Path `TurnEvent`, `hedge_injected` Signal | Accepted (2026-05-17) | -| [ADR-0040](ADR-0040-telemetry-sink.md) | Structured-Logging Sink for Turn-Event Audit | Accepted (2026-05-17) | -| [ADR-0041](ADR-0041-cli-verdicts-and-fanout.md) | `core chat --show-verdicts` + Sink Fan-Out | Accepted (2026-05-17) | -| [ADR-0042](ADR-0042-audit-tour-demo.md) | Audit Tour Demo — `core demo audit-tour` | Accepted (2026-05-17) | -| [ADR-0043](ADR-0043-pack-measurements-phase2.md) | Phase-2 pack measurements: claims → numbers | Accepted (2026-05-17) | -| [ADR-0044](ADR-0044-medical-clinical-ethics-pack.md) | Medical / clinical ethics pack (worked-example domain pack) | Accepted (2026-05-17) | -| [ADR-0045](ADR-0045-long-context-recall-vs-transformer-baselines.md) | Long-context recall: CORE vs transformer baselines | Accepted (2026-05-17) | -| [ADR-0046](ADR-0046-forward-graph-constraint.md) | PropositionGraph as Forward Admissibility Constraint | Accepted | -| [ADR-0047](ADR-0047-wire-forward-graph-constraint.md) | Wire the Forward Graph Constraint into the Chat Hot Path | Accepted | -| [ADR-0048](ADR-0048-pack-grounded-surface.md) | Pack-Grounded Surface for Cold-Start DEFINITION / RECALL | Accepted | -| [ADR-0049](ADR-0049-intent-subject-extraction.md) | Intent Classifier Head-Noun Subject Extraction | Accepted | -| [ADR-0050](ADR-0050-pack-grounded-comparison.md) | Pack-Grounded Surface for Cold-Start COMPARISON | Accepted | -| [ADR-0051](ADR-0051-trust-boundary-hardening.md) | Trust-Boundary Hardening Pass | Accepted | -| [ADR-0052](ADR-0052-teaching-grounded-surface.md) | Teaching-Grounded Surface for Cold-Start CAUSE / VERIFICATION | Accepted | -| [ADR-0053](ADR-0053-cognition-lane-closure.md) | Cognition Lane Closure: Dev-Driven Corpus Expansion + CORRECTION Acknowledgement | Accepted | -| [ADR-0054](ADR-0054-vault-recall-indexing-batching.md) | Vault Recall: Matrix-Cache Indexing + Batched API; Holdout Split Wired | Accepted | -| [ADR-0055](ADR-0055-inter-session-memory-discovery-promotion.md) | Inter-Session Memory: Reviewed Discovery Promotion | Phase A + Phase B Accepted; Phase C Implemented (ADR-0056/0057); Phases D–E substantially landed | -| [ADR-0056](ADR-0056-contemplation-loop-c1.md) | Contemplation Loop: Question Decomposition + Polarity + Domain Typing (Phase C1) | Accepted (implemented at `4eecf73`, 2026-05-18) | -| [ADR-0057](ADR-0057-teaching-chain-proposal-review.md) | Teaching-Chain Proposal + Review + Replay-Equivalence Gate (Phase C2) | Accepted | -| [ADR-0058](ADR-0058-forward-graph-constraint-status.md) | `forward_graph_constraint`: Engaged but Inert on Today's Cognition Lane | Accepted | -| [ADR-0059](ADR-0059-correction-pass-telemetry.md) | Correction-Pass Telemetry Emission | Accepted | -| [ADR-0060](ADR-0060-correction-acknowledgment-topic-lemma.md) | CORRECTION Acknowledgement Carries the Corrected-Topic Lemma | Accepted | -| [ADR-0061](ADR-0061-procedure-intent-pack-grounded-surface.md) | PROCEDURE Intent Routes to Pack-Grounded Surface | Accepted | -| [ADR-0062](ADR-0062-composed-teaching-grounded-surface.md) | Composed Teaching-Grounded Surface (Chain-of-Chains) | Accepted | -| [ADR-0063](ADR-0063-cross-pack-surface-resolver.md) | Cross-pack surface resolver | Accepted | -| [ADR-0064](ADR-0064-cross-pack-teaching-chains.md) | Cross-pack teaching chains | Accepted | -| [ADR-0065](ADR-0065-oov-gradient-and-relations-v2.md) | OOV gradient + relations v2 (Plan Phase 2) | Accepted | -| [ADR-0066](ADR-0066-turn-level-composition.md) | Turn-level composition (Plan Phase 3) | Accepted | -| [ADR-0067](ADR-0067-cross-pack-teaching-chains.md) | Cross-pack teaching chains (Plan Phase 4) | Accepted | -| [ADR-0068](ADR-0068-register-pack-class.md) | Register pack class (Plan Phase R1) | Accepted | -| [ADR-0069](ADR-0069-realizer-register-parameter.md) | Realizer register parameter (Plan Phase R2) | Accepted (amended 2026-05-19) | -| [ADR-0070](ADR-0070-register-pack-terse-v1.md) | Second ratified register pack: `terse_v1` (Plan Phase R3) | Accepted | -| [ADR-0071](ADR-0071-seeded-surface-variation.md) | Seeded surface variation + discourse markers (Plan Phase R4) | Accepted | -| [ADR-0072](ADR-0072-register-telemetry-operator-surface.md) | Register telemetry + operator surface (Plan Phase R5) | Accepted | -| [ADR-0073](ADR-0073-anchor-lens-substrate.md) | Anchor lens: substrate-driven substantive variation | Accepted (umbrella ratified; sub-ADRs L1.1–L1.4 each ratify in isolation) | -| [ADR-0073a](ADR-0073a-anchor-lens-content-phase.md) | Anchor lens content phase (Plan Phase L1.1) | Accepted | -| [ADR-0073b](ADR-0073b-anchor-lens-class-loader.md) | Anchor lens class + loader (Plan Phase L1.2) | Accepted | -| [ADR-0073c](ADR-0073c-anchor-lens-composer-wiring.md) | First non-trivial lenses + composer wiring (Plan Phase L1.3) | Accepted | -| [ADR-0073d](ADR-0073d-anchor-lens-telemetry-tour.md) | Anchor-lens telemetry, CLI, and tour demo (Plan Phase L1.4) | Accepted | -| [ADR-0074](ADR-0074-orthogonality-tour.md) | Orthogonality tour: anchor-lens × register composition demo | Accepted | -| [ADR-0075](ADR-0075-realizer-slot-type-guard.md) | Realizer slot-type guard (C1: coherence floor) | Accepted | -| [ADR-0076](ADR-0076-confirmation-tag-normalization.md) | Confirmation-Tag Normalization (C2) | Accepted | -| [ADR-0077](ADR-0077-substantive-register-knobs.md) | Substantive register knobs + register-tour gate strengthening (R6) | Ratified | -| [ADR-0078](ADR-0078-composer-graph-atom-equivalence.md) | Composer/Graph atom equivalence telemetry | Ratified | -| [ADR-0078](ADR-0078-phase1-implementation-note.md) | ADR-0078 Phase 1 — Pre-Implementation Planning Note | — | -| [ADR-0080](ADR-0080-contemplation-loop.md) | Contemplation Loop: self-interrogation without self-ratification | Accepted | -| [ADR-0083](ADR-0083-transitive-chain-surface.md) | Transitive Chain Surface (Bounded Multi-Hop Composition) | Accepted | -| [ADR-0084](ADR-0084-definitional-layer.md) | Definitional Layer for Lexicon Packs | Proposed | -| [ADR-0085](ADR-0085-gloss-aware-cause.md) | Gloss-Aware CAUSE Composer | Accepted | -| [ADR-0087](ADR-0087-rhetorical-style-axis.md) | Rhetorical Style as Selection Axis (Pre-Work for Writing Curriculum) | Proposed | -| [ADR-0091](ADR-0091-domain-pack-contract-v1.md) | Domain Pack Contract v1 | Accepted | -| [ADR-0092](ADR-0092-reviewer-registry-v1.md) | Reviewer Registry v1 | Accepted | -| [ADR-0093](ADR-0093-domain-pack-contract-v1-implementation.md) | Domain Pack Contract v1 Implementation | Accepted | -| [ADR-0094](ADR-0094-proposal-source-provenance.md) | Proposal Source Provenance | Accepted | -| [ADR-0095](ADR-0095-miner-sourced-teaching-proposals.md) | Miner-Sourced Teaching Proposals | Accepted | -| [ADR-0096](ADR-0096-fabrication-control-eval-lane.md) | Fabrication-Control Eval Lane | Accepted | -| [ADR-0097](ADR-0097-mathematics-logic-reasoning-capable-ratification.md) | Mathematics-Logic Reasoning-Capable Ratification | Accepted | -| [ADR-0098](ADR-0098-demo-composition-contract.md) | Demo Composition Contract | Accepted | -| [ADR-0099](ADR-0099-public-showcase-demo.md) | Public Showcase Demo | Accepted | -| [ADR-0100](ADR-0100-physics-reasoning-capable-ratification.md) | Physics Reasoning-Capable Ratification | Accepted | -| [ADR-0101](ADR-0101-systems-software-reasoning-capable-ratification.md) | Systems-Software Reasoning-Capable Ratification | Accepted | -| [ADR-0102](ADR-0102-hebrew-greek-reasoning-capable-ratification.md) | Hebrew-Greek Textual-Reasoning Reasoning-Capable Ratification | Accepted | -| [ADR-0103](ADR-0103-fluency-lane-attachment-for-adr-0102.md) | Fluency Lane Attachment for ADR-0102 | Accepted | -| [ADR-0104](ADR-0104-curriculum-sourced-teaching-proposals.md) | Curriculum-Sourced Teaching Proposals | Accepted | -| [ADR-0105](ADR-0105-sealed-holdout-encryption.md) | Sealed Holdout Encryption via age | Accepted (2026-05-22) | -| [ADR-0106](ADR-0106-expert-demo-promotion-contract.md) | Expert-Demo Promotion Contract | Accepted | -| [ADR-0107](ADR-0107-mathematics-logic-expert-demo-deferred.md) | `mathematics_logic` Expert-Demo Promotion: Deferred | Accepted (decision: defer promotion) | -| [ADR-0108](ADR-0108-proposed-adr-sequencing.md) | Proposed-ADR Sequencing Post-ADR-0105 | Accepted | -| [ADR-0109](ADR-0109-lane-shape-aware-thresholds.md) | Lane-Shape-Aware Thresholds (ADR-0106 Amendment) | Accepted | -| [ADR-0110](ADR-0110-mathematics-logic-expert-demo-promotion.md) | `mathematics_logic` Expert-Demo Promotion | Accepted | -| [ADR-0111](ADR-0111-physics-expert-demo-promotion.md) | `physics` Expert-Demo Promotion | Accepted | -| [ADR-0112](ADR-0112-runnable-expert-demo-showcase.md) | Runnable Expert-Demo Showcase | Accepted | -| [ADR-0113](ADR-0113-rename-expert-demo-to-audit-passed.md) | Rename `expert-demo` → `audit-passed`; Reserve `expert` for Future Capability Tier | Accepted | -| [ADR-0114](ADR-0114-expert-capability-roadmap-gsm8k-first.md) | Expert-Capability Roadmap: GSM8K-Math First | Proposed | -| [ADR-0114a](ADR-0114a-anti-overfitting-proof-obligations.md) | Anti-Overfitting Proof Obligations for `expert` Promotion | Accepted (documentation-only; no code change) | -| [ADR-0114a.2](ADR-0114a.2-ood-ratio-auditor.md) | OOD-Ratio Auditor (Obligation #2 wired for B3) | Accepted | -| [ADR-0114a.5](ADR-0114a.5-perturbation-suite.md) | Reasoning-Isolation Perturbation Suite (Obligation #5, B3) | Accepted | -| [ADR-0114a.6](ADR-0114a.6-depth-curve-auditor.md) | Compositional-Depth Curve Auditor (Obligation #6 wired for B3) | Accepted (mechanism); coverage gap deferred to B3-owner follow-up | -| [ADR-0114a.8](ADR-0114a.8-adversarial-auditor.md) | Adversarial Generation Auditor (Obligation #8 wired) | Accepted (obligation passes; surfaces 2 known parser-layer gaps) | -| [ADR-0114a.10](ADR-0114a.10-pack-provenance-auditor.md) | Pack-Provenance Auditor (Obligation #10 wired for B3) | Accepted | -| [ADR-0115](ADR-0115-math-problem-parser-and-graph.md) | Math Problem Parser and Typed Proposition Graph | Phase 1.1 Accepted (schema + 5 seed cases + tests); Phases 1.2–1.4 In Progress | -| [ADR-0116](ADR-0116-deterministic-solver.md) | Deterministic Solver (`MathProblemGraph` → `SolutionTrace`) | Accepted | -| [ADR-0117](ADR-0117-solution-trace-verifier.md) | `SolutionTrace` Verifier | Accepted | -| [ADR-0118](ADR-0118-stepped-realizer.md) | Stepped Realizer (`SolutionTrace` → Prose) | Accepted | -| [ADR-0118a](ADR-0118a-ood-surface-generator.md) | OOD Surface Generator for GSM8K-Style Parser Dev | Accepted | -| [ADR-0119](ADR-0119-gsm8k-eval-lane-roadmap.md) | GSM8K Eval Lane Roadmap (Phase 5) | Proposed (roadmap-only) | -| [ADR-0119.1](ADR-0119.1-sealed-holdout-fabrication-control.md) | Seal fabrication_control Holdout (ADR-0105 Amendment) | Accepted | -| [ADR-0119.2](ADR-0119.2-gsm8k-eval-corpus-dev-public.md) | GSM8K Eval Corpus Dev/Public Splits | Accepted | -| [ADR-0119.3](ADR-0119.3-lane-runner.md) | gsm8k_math Lane Runner (Phase 5.3) | Accepted | -| [ADR-0119.4](ADR-0119.4-frontier-baseline-comparison.md) | GSM8K Math: Frontier-Baseline Comparison (ADR-0114a §Obligation #7) | Accepted | -| [ADR-0119.5](ADR-0119.5-adversarial-generation.md) | Adversarial Generation (ADR-0114a Obligation #8) | Accepted | -| [ADR-0119.6](ADR-0119.6-depth-curve-harness.md) | GSM8K Math Depth-Curve Measurement Harness | Accepted | -| [ADR-0119.7](ADR-0119.7-sealed-gsm8k-test.md) | Sealed GSM8K Test Set as gsm8k_math Holdout | Accepted | -| [ADR-0119.8](ADR-0119.8-lane-gate.md) | gsm8k_math Overall Lane Gate (`gsm8k_capability_shape`) | Accepted | -| [ADR-0120](ADR-0120-expert-promotion-contract.md) | First `expert` Promotion Contract | Proposed (contract-only; no domain promoted with this ADR) | -| [ADR-0120](ADR-0120-math-expert-ledger-flip.md) | ADR-0120 (math, ledger flip) — Mathematics-Logic Domain Promoted to `expert` | Accepted 2026-05-23; **auto-reverted to `audit-passed`** when evidence drifted — current status audit-passed (see [ADR-0200](ADR-0200-expert-claim-reconciliation.md)) | -| [ADR-0120](ADR-0120-math-expert-promotion-wireup.md) | ADR-0120 (math) — Math-Expert Promotion Composer Wire-Up | Accepted (technical pass on first evaluation; awaiting reviewer signature for ledger admission) | -| [ADR-0121](ADR-0121-mathematics-logic-expert-deferred.md) | `mathematics_logic` `expert` Promotion — Deferred (first attempt) | Accepted (the deferral is the decision) | -| [ADR-0122](ADR-0122-parser-rate-per-unit.md) | Parser Expansion: Rate / Per-Unit Reasoning (substrate-only; lift deferred) | Accepted (substrate landed; sealed-lift gate deferred — the | -| [ADR-0122](ADR-0122-systems-software-audit-passed-deferred.md) | `systems_software` Audit-Passed Promotion: Deferred | Accepted (decision: defer promotion) | -| [ADR-0123](ADR-0123-parser-comparison-phrasing.md) | Comparison-Phrasing Realizer (surface increment on the ADR-0123 substrate) | Accepted (surface increment; substrate landed in PR #155) | -| [ADR-0123](ADR-0123-symbolic-logic-shape-remap.md) | `symbolic_logic` Lane-Shape Remap (ADR-0109 Amendment) | Accepted | -| [ADR-0123a](ADR-0123a-inference-shape-synonym.md) | `all_three_pass_rate` Synonym in `inference_shape` (ADR-0109 Amendment) | Accepted | -| [ADR-0124](ADR-0124-systems-software-audit-passed-promotion.md) | `systems_software` Audit-Passed Promotion | Accepted | -| [ADR-0125](ADR-0125-reasoning-isolation-perturbation-suite.md) | Reasoning-Isolation Perturbation Suite | Accepted | -| [ADR-0126](ADR-0126-candidate-graph-parser.md) | Candidate-Graph Parser with Round-Trip Verifier-Filter | Proposed | -| [ADR-0127](ADR-0127-0128-RESULTS.md) | ADR-0127 + ADR-0128 Results — Path-B Triggered | Empirical result; load-bearing for the GSM8K-math arc decision | -| [ADR-0127](ADR-0127-units-pack-and-units-aware-parser.md) | `en_units_v1` Pack + Units-Aware Candidate Extractors | Proposed (scope-only; implementation follow-up to ADR-0126) | -| [ADR-0128](ADR-0128-numerics-pack.md) | `en_numerics_v1` Pack | Proposed (scope-only; sibling to ADR-0127) | -| [ADR-0129](ADR-0129-spaced-correction-replay-deferred.md) | Spaced Reviewed-Correction Replay (Deferred Proposal) | Proposed — Deferred (backlog item; no implementation | -| [ADR-0130](ADR-0130-pre-articulation-calibration-deferred.md) | Pre-Articulation Calibration Logging (Deferred Proposal) | Proposed — Deferred (backlog item; no implementation | -| [ADR-0131](ADR-0131-math-expert-rebench.md) | Re-Target Math Expert Promotion to Architecture-Aligned Benchmarks | Proposed | -| [ADR-0131.1.F](ADR-0131.1.F-frontier-baseline-comparison.md) | B1 Symbolic Equivalence: Frontier-Baseline Comparison | Proposed | -| [ADR-0131.1.S](ADR-0131.1.S-sealed-holdout.md) | Sealed Holdout for Benchmark 1 (Symbolic Equivalence v1) | Accepted | -| [ADR-0131.2](ADR-0131.2-teaching-corpus-eval.md) | Benchmark 2: CORE-native teaching-corpus eval (lane gate) | Accepted | -| [ADR-0131.2.B](ADR-0131.2.B-teaching-corpus-enrichment.md) | Benchmark 2: B2 teaching-corpus enrichment (load-bearing gate) | Accepted | -| [ADR-0131.3](ADR-0131.3-bounded-grammar.md) | Benchmark 3: Bounded-Grammar Word Problems | — | -| [ADR-0131.4](ADR-0131.4-composite-math-gate.md) | Composite Math-Expert Promotion Gate (wired) | Accepted | -| [ADR-0131.5](ADR-0131.5-gsm8k-probe-retirement.md) | GSM8K Coverage Probe: Retirement After G.x Axis Completion | Accepted | -| [ADR-0131.G](ADR-0131.G-gsm8k-coverage-probe.md) | GSM8K Coverage Probe: Honest Measurement Under the Safety Rail | Proposed | -| [ADR-0131.G.0](ADR-0131.G.0-probe-substrate.md) | Probe Substrate: Candidate-Graph Pipeline | Proposed | -| [ADR-0131.G.1](ADR-0131.G.1-verb-classes-initial-state.md) | Capability axis: state-introducing verb classes | Accepted | -| [ADR-0131.G.2](ADR-0131.G.2-comparatives.md) | Capability axis: comparative operations (additive + multiplicative) | Proposed | -| [ADR-0131.G.3](ADR-0131.G.3-numerics.md) | Numeric Literals (money + hyphenated cardinals) | Proposed | -| [ADR-0131.G.3.1](ADR-0131.G.3.1-numerics-extensions.md) | Numerics extensions (fractions + multi-currency + multi-token cardinals + word-num-adjective) | Proposed | -| [ADR-0131.G.4](ADR-0131.G.4-multi-clause.md) | Capability axis: multi-clause composition (conjoined subjects, conjoined objects, embedded quantifiers) | Proposed | -| [ADR-0131.G.5](ADR-0131.G.5-aggregate-answer-composition.md) | Aggregate Answer Composition | Accepted | -| [ADR-0132](ADR-0132-binding-graph-data-model.md) | Semantic-Symbolic Binding Graph: Phase 1 data model | Accepted (Phase 1 only; Phases 2–5 deferred) | -| [ADR-0133](ADR-0133-binding-graph-adapter.md) | Semantic-Symbolic Binding Graph: Phase 2 adapter from `MathProblemGraph` | Accepted (Phase 2 only; Phases 3–5 deferred) | -| [ADR-0134](ADR-0134-binding-graph-admissibility.md) | Binding Graph Phase 3: Unit-Aware Equation Admissibility | accepted | -| [ADR-0135](ADR-0135-binding-graph-question-target.md) | Binding Graph Phase 4: question-target binding refinement | Accepted. | -| [ADR-0136](ADR-0136-statement-layer-corridor.md) | Statement-Layer Corridor: Graduated GSM8K Admission via Parser Extension | Active — *Regex sentence-template prescription superseded by [ADR-0164](./ADR-0164-incremental-comprehension-reader.md) (2026-05-26). Empirical taxonomies preserved.* | -| [ADR-0136.S.1](ADR-0136.S.1-rate-event-statements.md) | Rate/Event Statement Parsing | Accepted — *regex patterns scheduled for removal under [ADR-0164](./ADR-0164-incremental-comprehension-reader.md) Phase 3; closed-set vocabulary preserved as lexicon seed* | -| [ADR-0136.S.2](ADR-0136.S.2-conditional-op-question.md) | Conditional-Op Question (Statement-Layer Corridor) | Active — *regex patterns scheduled for removal under [ADR-0164](./ADR-0164-incremental-comprehension-reader.md) Phase 3; closed-set vocabulary preserved as lexicon seed* | -| [ADR-0136.S2](ADR-0136.S2-post-rescan.md) | post-rescan — Refusal Rescan v2: Barrier-Shift Ledger | Accepted | -| [ADR-0136.S3](ADR-0136.S3-compound-initial-mutation.md) | Compound Initial-Mutation Extractor | Accepted — *regex patterns scheduled for removal under [ADR-0164](./ADR-0164-incremental-comprehension-reader.md) Phase 3; closed-set vocabulary preserved as lexicon seed* | -| [ADR-0136.S3](ADR-0136.S3-post-rescan.md) | post-rescan — Refusal Rescan v3: Barrier-Shift Ledger | Accepted | -| [ADR-0136.S.4](ADR-0136.S.4-novel-initial-form.md) | Novel Initial-Form Subject-Slot Widenings | Accepted — *regex patterns scheduled for removal under [ADR-0164](./ADR-0164-incremental-comprehension-reader.md) Phase 3; closed-set vocabulary preserved as lexicon seed* | -| [ADR-0138](ADR-0138-comparative-reference-layer.md) | Comparative-Reference Layer | Draft (design-only) | -| [ADR-0139](ADR-0139-arithmetic-as-versor-spike.md) | Arithmetic-as-Versor Spike: `add` Only | Draft | -| [ADR-0140](ADR-0140-core-trace-protocol-v0.md) | CORE Trace Protocol v0 | Proposed | -| [ADR-0140](ADR-0140-subtract-and-additive-group-closure.md) | `subtract` as Inverse Translator + Additive Group Closure | Draft | -| [ADR-0141](ADR-0141-multiply-as-dilator-positive-nonzero.md) | `multiply` as Dilator (Positive Non-Zero Multipliers Only) | Draft | -| [ADR-0142](ADR-0142-epistemic-state-taxonomy.md) | Epistemic State Taxonomy — First-Class Vocabulary | Accepted (integration deferred pending ADR-0144) | -| [ADR-0143](ADR-0143-recognition-spike-anti-unification.md) | Teaching-Derived Structural Recognition via Multi-Resolution Anti-Unification | Accepted | -| [ADR-0144](ADR-0144-proposition-graph-epistemic-carrier.md) | PropositionGraph — Epistemic Carrier and Recognition Integration Gate | Accepted | -| [ADR-0145](ADR-0145-energy-modulated-surface-readback.md) | Energy-Modulated Vault Surface Readback | Accepted | -| [ADR-0146](ADR-0146-l10-hybrid-engine-state-persistence.md) | L10 Shape B Hybrid Engine-State Persistence | Accepted | -| [ADR-0148](ADR-0148-vault-promotion-policy-wiring.md) | Wire VaultPromotionPolicy into turn boundary | Accepted | -| [ADR-0149](ADR-0149-derived-recognizer-pipeline-wiring.md) | Integrate DerivedRecognizer into CognitiveTurnPipeline | Accepted | -| [ADR-0150](ADR-0150-autonomous-inter-session-contemplation.md) | Autonomous Inter-Session Contemplation | Accepted | -| [ADR-0151](ADR-0151-auto-proposal-pipeline.md) | Auto-Proposal Pipeline at Load | Accepted | -| [ADR-0152](ADR-0152-learning-arc-demo.md) | Learning-Arc Demo (`core demo learning-arc`) | — | -| [ADR-0153](ADR-0153-turn-event-trace-hash-backstamp.md) | TurnEvent trace_hash back-stamp (W-020a) | accepted | -| [ADR-0154](ADR-0154-recognizer-producer-wiring.md) | DerivedRecognizer producer wiring (W-020b) | accepted | -| [ADR-0155](ADR-0155-ci-contemplation-runner.md) | CI contemplation runner (W-021) | scoping | -| [ADR-0156](ADR-0156-atomic-engine-state-checkpoint.md) | Atomic engine-state checkpoint writes (W-022 / L10b.1) | accepted | -| [ADR-0157](ADR-0157-revision-mismatch-warning.md) | Revision-mismatch warning on engine-state load (W-023 / L10b.2) | accepted | -| [ADR-0158](ADR-0158-reboot-event-audit.md) | reboot_event audit trail entry (W-024 / L10b.3) | accepted | -| [ADR-0159](ADR-0159-contemplation-quality-eval.md) | Contemplation Quality Eval Lane (W-025) | Accepted | -| [ADR-0160](ADR-0160-core-workbench-v1.md) | CORE Workbench v1: operator/auditor UI before public chat | proposed | -| [ADR-0161](ADR-0161-hitl-async-queue.md) | HITL Async Queue (W-009, L11) | Proposed | -| [ADR-0162](ADR-0162-workbench-design-system.md) | Workbench Design System (v1) | Proposed | -| [ADR-0163](ADR-0163-F2-confuser-corpus-spec.md) | F2 — Confuser Corpus: a discrimination probe, not a coverage target | Proposed (spec only — no code). Follow-on to ADR-0163 §F (the Track-B | -| [ADR-0163](ADR-0163-gsm8k-path-to-mastery.md) | Path to GSM8K mastery: candidate-graph admissibility via the contemplation/HITL corridor | Proposed — *Phases B–E prescription superseded by [ADR-0164](./ADR-0164-incremental-comprehension-reader.md) (2026-05-26)* | -| [ADR-0164](ADR-0164-incremental-comprehension-reader.md) | Incremental Comprehension Reader (replaces regex sentence-template parsing) | Partially implemented (Phase 1 + 2 shipped; eval delta pending lexicon expansion) | -| [ADR-0164.1](ADR-0164.1-lexical-primitive-scope.md) | Lexical Primitive Set Scope (seed registry for `en_core_math_v1`) | Proposed | -| [ADR-0164.2](ADR-0164.2-pronoun-entity-resolution.md) | Pronoun / Entity Resolution Policy | Proposed | -| [ADR-0164.3](ADR-0164.3-cross-sentence-state.md) | Cross-Sentence Reading State | Proposed | -| [ADR-0164.4](ADR-0164.4-phase2-statement-frame-reader.md) | Phase 2 Statement-Frame Reader | Proposed | -| [ADR-0165](ADR-0165-regex-scope-rule.md) | Regex Scope Rule: Lexemes Only, Never Grammar | Proposed | -| [ADR-0166](ADR-0166-measurement-capability-sequencing.md) | Measurement-Capability Sequencing Discipline | Proposed | -| [ADR-0167](ADR-0167-audit-as-teaching-evidence.md) | Audit-as-Teaching-Evidence (Math Reader → Contemplation) | Proposed (scoping ADR; no code in this PR) | -| [ADR-0168](ADR-0168-frameclaim-ratification.md) | FrameClaim Ratification Doctrine | Proposed (doctrine/scoping ADR; no runtime mutation in this PR) | -| [ADR-0168.1](ADR-0168.1-math-frameclaim-proposal-adapter.md) | MathFrameClaimProposal Adapter | Proposed (design bridge; no runtime FrameClaim admission in this PR) | -| [ADR-0169](ADR-0169-compositionclaim-ratification.md) | CompositionClaim Ratification Doctrine | Proposed (doctrine/scoping ADR; no runtime mutation in this PR) | -| [ADR-0169.1](ADR-0169.1-math-compositionclaim-proposal-adapter.md) | MathCompositionClaimProposal Adapter | Proposed (design bridge; no runtime CompositionClaim admission in this PR) | -| [ADR-0170](ADR-0170-injector-contract-widening.md) | Recognizer Injector Contract Widening | Proposed (scoping ADR; no runtime change in this PR) | -| [ADR-0172](ADR-0172-math-corpus-decomposition-mechanism.md) | Math-Domain Corpus-Decomposition Mechanism (Learning-Arc Analog) | Proposed (scoping ADR; no runtime change in this PR) | -| [ADR-0173](ADR-0173-workbench-ratification-trust-boundary.md) | Workbench Ratification Trust Boundary | Accepted (W0 of the workbench-UI wave; doctrine only — UI | -| [ADR-0174](ADR-0174-held-hypothesis-comprehension.md) | Held-Hypothesis Comprehension with Lookback and In-Loop Contemplation | Proposed | -| [ADR-0175](ADR-0175-calibrated-attempt-and-eliminate-learning.md) | Calibrated Attempt-and-Eliminate Learning: Two Regimes Under wrong=0 | Proposed | -| [ADR-0176](ADR-0176-multistep-composition-question-targeting.md) | Multi-Step Grounded Composition with Question-Targeting | Proposed | -| [ADR-0177](ADR-0177-cue-precision-learning.md) | Cue-Precision Learning: from practice eliminations to trusted cue→op patterns | Proposed | -| [ADR-0178](ADR-0178-GB3b-referent-accumulation-scope.md) | ADR-0178 GB-3b — referent-aware accumulation chaining (scope) | Proposed (scope only — no code). Sub-phase of | -| [ADR-0178](ADR-0178-compositional-structure.md) | Compositional Structure: Comprehension-Guided Multi-Step Derivation (Gap B) | Proposed | -| [ADR-0179](ADR-0179-extraction-richness.md) | Extraction Richness: feeding the comprehension composer real quantities | Proposed | -| [ADR-0180](ADR-0180-crdt-sharded-vault-concurrency.md) | Delta-CRDT Sharded Substrate for Multimodal Concurrency | Accepted (2026-05-31 — G1 reference-contract lock) | -| [ADR-0181](ADR-0181-audio-compiler-delta-crdt.md) | CORE-native Audio Compiler over the Delta-CRDT Substrate | Proposed | -| [ADR-0182](ADR-0182-cross-composer-disagreement-pooling.md) | Cross-composer disagreement pooling: refuse distractor-quantity confusers without a reactive cue rule | Proposed (spec only — no code). Follow-on to | -| [ADR-0183](ADR-0183-lawful-audio-lexeme-path.md) | Lawful Audio→Lexeme Path (stub) | Proposed (stub — placeholder to record the fork; not yet a full design) | -| [ADR-0184](ADR-0184-distinct-unit-product-rule.md) | Distinct-unit product rule: cut the product-of-all over-commit | Accepted / Implemented | -| [ADR-0185](ADR-0185-division-reading.md) | Division reading (rate / partition): eliminate-then-solve | Superseded by [ADR-0186](ADR-0186-sealed-candidate-graph-injector-lane.md) | -| [ADR-0186](ADR-0186-sealed-candidate-graph-injector-lane.md) | Sealed candidate-graph injector lane: resume ADR-0170 W2–W5 under the ADR-0175 seal | Proposed (scoping + seal-mechanism ADR; first injector ships behind the seal) | -| [ADR-0189](ADR-0189-comparative-verb-unit-widening.md) | Comparative reading: anchor-verb widening + multi-word units | Proposed (implemented in this PR) | -| [ADR-0191](ADR-0191-candidate-graph-completeness-guard.md) | Candidate-graph completeness guard (the missing wrong=0 leg) | Proposed (implemented in this PR) | -| [ADR-0192](ADR-0192-discrete-count-open-noun-class.md) | Open the discrete_count counted-noun class (firewall-backed) | Proposed (implemented in this PR) | -| [ADR-0193](ADR-0193-aggregate-existential-question-frame.md) | Aggregate total-across: the existential question frame | Proposed (implemented in this PR) | -| [ADR-0194](ADR-0194-labeled-container-subject.md) | Labeled-container subject entity shape | Proposed (implemented in this PR) | -| [ADR-0195](ADR-0195-product-promotion-bridge.md) | Product Promotion Bridge | Accepted / Implemented | -| [ADR-0196](ADR-0196-native-substrate-language-doctrine.md) | Native Substrate Language Doctrine (Python / Rust / Zig) | Accepted (2026-05-31) | -| [ADR-0197](ADR-0197-vision-compiler-delta-crdt.md) | CORE-native Vision Compiler over the Delta-CRDT Substrate | Proposed | -| [ADR-0198](ADR-0198-motor-efferent-decoder-spike.md) | Motor as Efferent Modality — Protocol Gap & Governance (Design Spike) | Proposed (design spike — no implementation) | -| [ADR-0199](ADR-0199-cross-domain-learning-arena-contract.md) | Cross-Domain Learning Arena Contract | Proposed | -| [ADR-0200](ADR-0200-expert-claim-reconciliation.md) | Expert-Claim Reconciliation: Record the Fail-Closed Revert as Designed Behavior | Accepted | -| [ADR-0201](ADR-0201-proposition-canonicalizer.md) | Propositional Canonicalizer (`proof_chain`) | Accepted | -| [ADR-0201.1](ADR-0201.1-out-of-regime-detector.md) | Principled Out-of-Regime Detector | Accepted | -| [ADR-0202](ADR-0202-proposition-representation-contract.md) | Proposition Representation Contract (`proof_chain`) | Accepted | -| [ADR-0203](ADR-0203-binding-graph-acyclicity-invariant.md) | Binding-Graph Acyclicity Invariant | Accepted | -| [ADR-0204](ADR-0204-proof-graph-builder.md) | Proof-Graph Builder | Accepted | -| [ADR-0205](ADR-0205-modus-ponens-disagreement-rule.md) | Modus Ponens + Disagreement Rule | Accepted | -| [ADR-0206](ADR-0206-response-governance-bridge.md) | Response Governance Bridge | Accepted | -| [ADR-0207](ADR-0207-gsm8k-substrate-ratification.md) | GSM8K Comprehension/Composition Substrate Ratification | Accepted | -| [ADR-0208](ADR-0208-environmental-sensorium-loop.md) | Environmental Sensorium Loop | Accepted | -| [ADR-0209](ADR-0209-sensorimotor-feedback-contract.md) | Sensorimotor Feedback Is Afferent | Accepted | -| [ADR-0210](ADR-0210-l10-grounding-pack.md) | L10 Finite Grounding Pack and Adversarial Wrong=0 Fixtures | Accepted | -| [ADR-0211](ADR-0211-conformal-falsification-bench.md) | Conformal Falsification Bench | Accepted | -| [ADR-0216](ADR-0216-motor-verdict-lowering.md) | Motor Verdict Lowering Prerequisite | Accepted | -| [ADR-0217](ADR-0217-r2-finite-integer-constraint-compiler.md) | R2 Finite-Integer Constraint Compiler | Accepted | -| [ADR-0218](ADR-0218-proof-carrying-coherence-promotion.md) | Proof-Carrying Coherence Promotion | Accepted | -| [ADR-0219](ADR-0219-generation-checkpoint-atomicity.md) | Generation-dir Atomic Checkpoint | Accepted | -| [ADR-0220](ADR-0220-engine-identity-vs-build-provenance.md) | Engine Identity vs. Build Provenance | Accepted | -| [ADR-0221](ADR-0221-codeowners-review-topology.md) | Codeowners Review Topology | Accepted | -| [ADR-0222](ADR-0222-frame-verdict-closed-world.md) | FrameVerdict — Frame-General Closed-World Verdict | Accepted | -| [ADR-0223](ADR-0223-semantic-substrate-affordance-audit.md) | Semantic Substrate Affordance Audit and Foundation Alignment | Accepted | -| [ADR-0224](ADR-0224-foundational-substrate-readiness-map.md) | Foundational Subject Substrate Readiness and Cross-Domain Affordance Map | Accepted | -| [ADR-0225](ADR-0225-adr-corpus-hygiene.md) | ADR Corpus Hygiene, Numbering Policy, and Cross-Reference Governance | Accepted (2026-06-30) | -| [ADR-0200](ADR-0200-expert-claim-reconciliation.md) | Expert-Claim Reconciliation: record the math fail-closed revert as designed behavior | Proposed | - ---- - -## Current frontier - -_Current as of 2026-05-29 (ADR-0183)._ - -The development frontier has moved beyond the audit-passed foundations (ADR-0091–0125) into native multi-modal execution and autonomous calibration. Key active arcs include: - -- **Auditory Modality & CRDT Substrate (ADR-0180, ADR-0181, ADR-0183)**: Shifting from text-only to concurrent multi-modal pipelines. Introduces a lock-free Delta-CRDT shared vault substrate to eliminate thread contention under continuous vision/audio ingestion, and ships `audio_core_v1` as a deterministic acoustic compiler lowerable to unit-versors. ADR-0183 stubs the serving-time ASR boundary, ensuring lexical extraction is either text-side or deterministically decoded under `wrong=0`. -- **Calibrated Attempt-and-Eliminate Learning (ADR-0175)**: Establishes a formal precision-only reliability ledger and ratio-gate using the one-sided Wilson lower bound (`conservative_floor`). It separates the safe serving regime (`wrong=0`) from a sealed practice regime where failures are treated as elimination signals to prune the solver's search. -- **Incremental Comprehension & Verification (ADR-0164, ADR-0174)**: Transitioned sentence extraction from brittle regex sentence templates to a deterministic incremental reader based on shift-reduce over semantic categories. The reader is backed by held-hypothesis evaluation, lookback, and in-loop contemplation. -- **Measurement & Evaluation Discipline (ADR-0166, ADR-0163-F2)**: Establishes the `capability-before-measurement` rule to ensure eval lanes are only built when operators exist and can admit at least one case. F2 defines a confuser corpus discrimination probe rather than a mere coverage target. - -### Proposed-but-unimplemented ADRs - -The following ADRs carry a status of **Proposed** in the Index: - -#### Core Infrastructure & Metadata -- [ADR-0084](ADR-0084-definitional-layer.md) — Definitional Layer for Lexicon Packs -- [ADR-0087](ADR-0087-rhetorical-style-axis.md) — Rhetorical Style Axis -- [ADR-0129](ADR-0129-spaced-correction-replay-deferred.md) — Spaced Reviewed-Correction Replay (Deferred Proposal) -- [ADR-0130](ADR-0130-pre-articulation-calibration-deferred.md) — Pre-Articulation Calibration Logging (Deferred Proposal) -- [ADR-0140](ADR-0140-core-trace-protocol-v0.md) — CORE Trace Protocol v0 - -#### Auditory Modality & Delta-CRDT Concurrency -- [ADR-0180](ADR-0180-crdt-sharded-vault-concurrency.md) — Delta-CRDT Sharded Substrate for Multimodal Concurrency -- [ADR-0181](ADR-0181-audio-compiler-delta-crdt.md) — CORE-native Audio Compiler over the Delta-CRDT Substrate -- [ADR-0183](ADR-0183-lawful-audio-lexeme-path.md) — Lawful Audio→Lexeme Path (stub) - -#### Expert Promotion & Evaluation (Math/GSM8K) -- [ADR-0114](ADR-0114-expert-capability-roadmap-gsm8k-first.md) — Expert-Capability Roadmap: GSM8K-Math First -- [ADR-0119](ADR-0119-gsm8k-eval-lane-roadmap.md) — GSM8K Eval Lane Roadmap (Phase 5) -- [ADR-0120](ADR-0120-expert-promotion-contract.md) — First `expert` Promotion Contract -- [ADR-0131](ADR-0131-math-expert-rebench.md) — Re-Target Math Expert Promotion to Architecture-Aligned Benchmarks -- [ADR-0131.1.F](ADR-0131.1.F-frontier-baseline-comparison.md) — B1 Symbolic Equivalence: Frontier-Baseline Comparison -- [ADR-0131.G](ADR-0131.G-gsm8k-coverage-probe.md) — GSM8K Coverage Probe: Honest Measurement Under the Safety Rail -- [ADR-0131.G.0](ADR-0131.G.0-probe-substrate.md) — Probe Substrate: Candidate-Graph Pipeline -- [ADR-0131.G.2](ADR-0131.G.2-comparatives.md) — Capability axis: comparative operations (additive + multiplicative) -- [ADR-0131.G.3](ADR-0131.G.3-numerics.md) — Numeric Literals (money + hyphenated cardinals) -- [ADR-0131.G.3.1](ADR-0131.G.3.1-numerics-extensions.md) — Numerics extensions (fractions + multi-currency + multi-token cardinals + word-num-adjective) -- [ADR-0131.G.4](ADR-0131.G.4-multi-clause.md) — Capability axis: multi-clause composition (conjoined subjects, conjoined objects, embedded quantifiers) -- [ADR-0163](ADR-0163-F2-confuser-corpus-spec.md) — F2 — Confuser Corpus: a discrimination probe, not a coverage target -- [ADR-0163](ADR-0163-gsm8k-path-to-mastery.md) — Path to GSM8K mastery: candidate-graph admissibility via the contemplation/HITL corridor - -#### Incremental Comprehension Reader & Skill Acquisition -- [ADR-0126](ADR-0126-candidate-graph-parser.md) — Candidate-Graph Parser with Round-Trip Verifier-Filter -- [ADR-0127](ADR-0127-units-pack-and-units-aware-parser.md) — `en_units_v1` Pack + Units-Aware Candidate Extractors -- [ADR-0128](ADR-0128-numerics-pack.md) — `en_numerics_v1` Pack -- [ADR-0164.1](ADR-0164.1-lexical-primitive-scope.md) — Lexical Primitive Set Scope (seed registry for `en_core_math_v1`) -- [ADR-0164.2](ADR-0164.2-pronoun-entity-resolution.md) — Pronoun / Entity Resolution Policy -- [ADR-0164.3](ADR-0164.3-cross-sentence-state.md) — Cross-Sentence Reading State -- [ADR-0164.4](ADR-0164.4-phase2-statement-frame-reader.md) — Phase 2 Statement-Frame Reader -- [ADR-0165](ADR-0165-regex-scope-rule.md) — Regex Scope Rule: Lexemes Only, Never Grammar -- [ADR-0166](ADR-0166-measurement-capability-sequencing.md) — Measurement-Capability Sequencing Discipline -- [ADR-0167](ADR-0167-audit-as-teaching-evidence.md) — Audit-as-Teaching-Evidence (Math Reader → Contemplation) -- [ADR-0168](ADR-0168-frameclaim-ratification.md) — FrameClaim Ratification Doctrine -- [ADR-0168.1](ADR-0168.1-math-frameclaim-proposal-adapter.md) — MathFrameClaimProposal Adapter -- [ADR-0169](ADR-0169-compositionclaim-ratification.md) — CompositionClaim Ratification Doctrine -- [ADR-0169.1](ADR-0169.1-math-compositionclaim-proposal-adapter.md) — MathCompositionClaimProposal Adapter -- [ADR-0170](ADR-0170-injector-contract-widening.md) — Recognizer Injector Contract Widening -- [ADR-0172](ADR-0172-math-corpus-decomposition-mechanism.md) — Math-Domain Corpus-Decomposition Mechanism (Learning-Arc Analog) -- [ADR-0174](ADR-0174-held-hypothesis-comprehension.md) — Held-Hypothesis Comprehension with Lookback and In-Loop Contemplation -- [ADR-0175](ADR-0175-calibrated-attempt-and-eliminate-learning.md) — Calibrated Attempt-and-Eliminate Learning: Two Regimes Under wrong=0 -- [ADR-0176](ADR-0176-multistep-composition-question-targeting.md) — Multi-Step Grounded Composition with Question-Targeting -- [ADR-0177](ADR-0177-cue-precision-learning.md) — Cue-Precision Learning: from practice eliminations to trusted cue→op patterns -- [ADR-0178](ADR-0178-GB3b-referent-accumulation-scope.md) — ADR-0178 GB-3b — referent-aware accumulation chaining (scope) -- [ADR-0178](ADR-0178-compositional-structure.md) — Compositional Structure: Comprehension-Guided Multi-Step Derivation (Gap B) -- [ADR-0179](ADR-0179-extraction-richness.md) — Extraction Richness: feeding the comprehension composer real quantities -- [ADR-0182](ADR-0182-cross-composer-disagreement-pooling.md) — Cross-composer disagreement pooling: refuse distractor-quantity confusers without a reactive cue rule - -#### Workbench UI -- [ADR-0160](ADR-0160-core-workbench-v1.md) — CORE Workbench v1: operator/auditor UI before public chat -- [ADR-0161](ADR-0161-hitl-async-queue.md) — HITL Async Queue (W-009, L11) -- [ADR-0162](ADR-0162-workbench-design-system.md) — Workbench Design System (v1) - -_Historical — accurate as of ADR-0125; see the Index for the complete, current list of domain promotions._ - -ADR-0080 (Contemplation Loop, Phase 1), ADR-0110 (math audit-passed), ADR-0111 (physics audit-passed), and ADR-0124 (systems_software audit-passed) have all landed — `mathematics_logic`, `physics`, and `systems_software` are at `audit_passed=true`; the contemplation loop emits read-only `SPECULATIVE` findings from `frontier_compare` reports. The remaining ratified domain (`hebrew_greek_textual_reasoning`) needs its own promotion ADR. - -ADR-0122 attempted `systems_software` promotion and deferred honestly on a lane-shape contract mismatch (`symbolic_logic` output shape vs registered checker), resolved by ADR-0123's shape remap and successfully promoted via ADR-0124. - -### Open candidate directions (no ADR yet) - -_Historical — accurate as of ADR-0125; see the Index for the complete, current list._ - -- **Multi-reviewer holdout governance and threshold signing.** ADR-0105 seals holdout payloads with a single recipient identity; multi-reviewer governance remains future work. - ---- - -## Accepted reasoning-capable domains - -_Historical — accurate as of ADR-0125; see the Index for the complete, current list of domain promotions._ - -Per ADR-0106, `audit_passed` is **contract-gated**, not threshold-only: a domain row may carry `audit_passed=true` only when a reviewer-signed `audit_passed_claims` entry exists whose evidence-bundle digest reproduces byte-for-byte. ADR-0107 attempted the first worked promotion and the contract refused; ADR-0109 amended the threshold rules; ADR-0110 then successfully promoted `mathematics_logic` (the first domain at `audit_passed=true`); ADR-0111 promoted `physics` second without further contract change, retiring the "math-only" objection. The other two ratified domains remain at `reasoning-capable` pending their own promotion ADRs. - -| Domain | Ratification ADR | Pack(s) | Evidence summary | -|---|---|---|---| -| `mathematics_logic` | ADR-0097 + ADR-0110 | `en_mathematics_logic_v1` | All nine ADR-0091 predicates pass; ledger row is **`audit-passed`** (first such promotion, ADR-0110); all three attached lanes meet ADR-0109 shape thresholds on public + holdout. | -| `physics` | ADR-0100 + ADR-0111 | `en_physics_v1` | All nine predicates pass; causal/modal operator coverage meets threshold; ledger row is **`audit-passed`** (second such promotion, ADR-0111); `foundational_physics_ood` 117/117 public + 39/39 holdout; shares `inference_closure` + `fabrication_control` results with math (distinct digest via `domain_id`). | -| `systems_software` | ADR-0101 + ADR-0124 | `en_systems_software_v1` | All nine predicates pass; transitive/causal operator coverage meets threshold; ledger row is **`audit-passed`** (third promotion, ADR-0124); all three attached lanes meet thresholds on public + holdout. | -| `hebrew_greek_textual_reasoning` | ADR-0102 + ADR-0103 | `grc_logos_micro_v1`, `grc_logos_cognition_v1`, `he_logos_micro_v1`, `he_core_cognition_v1` | First multi-pack ratification; all four packs carry uniform contract fields; causal/contradiction operator coverage meets threshold; ADR-0103 attaches Hebrew and Koine Greek fluency lanes with `dev/public/holdout` coverage. | - ---- - -## ADR chain notes - -### Forward Semantic Control closure — ADR-0022 through ADR-0026 - -ADR-0022 through ADR-0026 form a single coherent chain that closes forward semantic control as a non-stochastic, replay-deterministic, trace-evidenced mechanism. - -1. **ADR-0022** establishes `AdmissibilityRegion` and the contract that a region restricts the admissible token set at generation time. -2. **ADR-0023** records proof evidence that the admissibility region is honored at the region-intersection level. -3. **ADR-0024** adds destination-side per-step admissibility and honest `InnerLoopExhaustion` when all admissible candidates are rejected. -4. **ADR-0025** adds rotor/frame admissibility when a region carries a `frame_versor`. -5. **ADR-0026** replaces static threshold tuning with ranked admissibility and a scale-invariant margin gate. - -Runtime contracts for the chain are pinned in [`docs/runtime_contracts.md`](../runtime_contracts.md). - -### Pack-layer chain — ADR-0027 through ADR-0045 - -ADR-0027 through ADR-0045 establish the identity / safety / ethics pack architecture with deterministic remediation, audit completeness, telemetry, operator readout, audit-tour demo, pack measurements, a worked-example medical ethics pack, and long-context comparison measurements. - -### Evidence-governed domain chain — ADR-0091 through ADR-0111 - -ADR-0091 through ADR-0111 establish the current domain-ratification substrate and the audit-passed promotion gate that distinguishes contract-passing from demonstrated: - -```text -contract definition (0091) - ↓ -reviewer trust root (0092) - ↓ -validator / ledger enforcement (0093) - ↓ -negative-control fabrication lane (0096) - ↓ -reasoning-capable domain ratification (0097 / 0100 / 0101 / 0102) - ↓ -language-specific fluency lane attachment (0103) - ↓ -audit-passed promotion contract (0106 + 0109 amendment) - ↓ -worked audit-passed promotion (0110 — mathematics_logic, first) - ↓ -worked audit-passed promotion (0111 — physics, second; no contract change) -``` - -No domain claim should be treated as mature merely because a pack exists. `reasoning-capable` means the nine ADR-0091 predicates pass; `audit-passed` requires a reviewer-signed evidence-bundle digest that reproduces byte-for-byte from on-disk lane results. - -The contract has been demonstrated end-to-end: refused once honestly (ADR-0107), amended once cleanly (ADR-0109), succeeded against `mathematics_logic` (ADR-0110), and succeeded against `physics` without further contract change (ADR-0111). - ---- - -### Comprehension-reader pivot — ADR-0164 and ADR-0165 (2026-05-26) - -The GSM8K admissibility front-end is replaced. The regex sentence-template -parsing layer in `generate/math_candidate_parser.py` and -`generate/recognizer_match.py` is recognized as overfitting by -construction — it enumerates memorized surface shapes while pretending to -encode a closed grammar that English does not have. - -- **[ADR-0164](ADR-0164-incremental-comprehension-reader.md)** — - Incremental Comprehension Reader. Word-by-word state accumulation over a - closed set of semantic categories. The reader is a deterministic - shift-reduce parser over *categories*, not over tokens. Output type is - identical to the regex parser's output, so the binding-graph - admissibility (ADR-0132/0133/0134/0135) downstream is unchanged. - Operational lexicon lives in `language_packs/data/en_core_math_v1/` - alongside the existing packs. - -- **[ADR-0165](ADR-0165-regex-scope-rule.md)** — Regex Scope Rule. - Structural invariant: regex is permitted only at the lexeme level - (currency literal, fraction literal, percentage literal, time-amount, - closed-set unit-noun), never at the sentence-structure level. The - primitive set is a closed registry grown through the same contemplation - → proposal → HITL review corridor that grows vocabulary. - -These ADRs preserve every load-bearing piece of the prior work: the -binding graph (ADR-0132–0135), the solver / verifier / realizer -substrate (ADR-0116–0118), the capability-axis lanes G1–G5 and S1, the -HITL corridor (ADR-0150 / 0152 / 0155 / 0161), the `wrong = 0` doctrine -and the replay-equivalence gate (ADR-0057, ADR-0114a). The -contemplation → proposal → review corridor architecture is reaffirmed -and its scope is generalized: it now ratifies lexicon entries, -categories, and lexeme primitives — not regex recognizers. - -ADR-0163's *diagnosis* (the front-end is the bottleneck) is reaffirmed; -its *prescription* (Phases B–E recognizer production) is partially -superseded. ADR-0136 and its S-family have the same disposition. - -### Measurement-Capability Sequencing — ADR-0166 (2026-05-27) - -Establishes the structural sequencing invariant: capability (operators, rules) must land on `main` and admit at least one test case before the eval lanes that measure it can be authored. Prevents noise of 100% refusing lanes from masking actual development priorities. - -### Calibrated learning and reliability — ADR-0175 through ADR-0177 (2026-05-28) - -Establishes calibrated attempt-and-eliminate learning under a strict two-regime separation: -1. **Serving**: Safe production path requiring `wrong=0` via a strict, high-reliability Wilson lower bound gate. -2. **Practice**: Sealed evaluation path where mistakes serve as checkable elimination signals to prune solver paths. - -### Multimodal Audio modality & CRDT substrate — ADR-0180 through ADR-0183 (2026-05-29) - -Shifts the engine toward concurrent multi-modal pipelines. Decouples physical lock contention on vision/audio from the logical manifold using Delta-CRDT sharding in Rust (ADR-0180), implements `audio_core_v1` as a deterministic acoustic compiler (ADR-0181), and stubs ASR serving boundaries to prevent learned Whisper models from contaminating production serving paths (ADR-0183). - -### ADR Corpus Governance — ADR-0225 (2026-06-30) - -ADR-0225 makes this README the living ADR reference matrix and requires future ADRs touching runtime state, packs, teaching, memory, replay, or invariants to cite safety boundaries, versor closure (`versor_condition(F) < 1e-6`), reconstruction-over-storage, replay-equivalence gates, and mutation standing. The verified Phase 1 dependency map is `docs/analysis/adr-corpus-cohesion-dependency-map-2026-06-30.md`. - ---- - -## Session Logs - -Session logs record the decisions and rationale from individual working sessions. They are not ADRs — they are the narrative record that informed the ADRs. - -| Date | File | -|---|---| -| 2026-05-12 | [SESSION-2026-05-12.md](SESSION-2026-05-12.md) | -| 2026-05-12 (addendum) | [SESSION-2026-05-12-b.md](SESSION-2026-05-12-b.md) | -| 2026-05-12 (language packs) | [SESSION-2026-05-12-language-packs-addendum.md](SESSION-2026-05-12-language-packs-addendum.md) | -| 2026-05-13 | [SESSION-2026-05-13.md](SESSION-2026-05-13.md) | -| 2026-05-26 (comprehension reader) | [SESSION-2026-05-26-comprehension-reader.md](SESSION-2026-05-26-comprehension-reader.md) | -| 2026-05-27 (parallel dispatch) | [SESSION-2026-05-27-adr-0167-parallel-dispatch.md](SESSION-2026-05-27-adr-0167-parallel-dispatch.md) | -| 2026-05-27 (tier 3 sequencing) | [SESSION-2026-05-27-tier3-sequencing.md](SESSION-2026-05-27-tier3-sequencing.md) | diff --git a/docs/grokbuild/README.md b/docs/grokbuild/README.md deleted file mode 100644 index 4abfb262..00000000 --- a/docs/grokbuild/README.md +++ /dev/null @@ -1,270 +0,0 @@ -# Using Grok 4.3 + Grok Build with CORE — Mastery Guide - -This document defines the canonical, high-discipline way to use Grok 4.3 and Grok Build on the AssetOverflow/core repository. - -The goal is not to make the model "smarter." The goal is to make the **engineering process** more disciplined, reproducible, and resistant to architectural drift while leveraging powerful agentic tooling. - -Grok Build is treated as a **bounded engineering laboratory**, not an autonomous architecture mutator. - ---- - -## 1. Philosophy & Mental Model - -- Grok 4.3 is fast, high-context, and agentic. This is both its strength and its primary risk on CORE. -- The system must remain **coherent by construction**. Any change that weakens `||F * reverse(F) - 1||_F < 1e-6`, epistemic rigor, or trust boundaries is a defect, not an optimization. -- Human judgment remains the final authority. Grok proposes, sweeps, verifies, and documents. Humans decide. -- Statelessness is a feature, not a bug. We compensate for it structurally (bootstrap skill + handoff docs + prompt library). - -**Core Principle**: Prefer refusal over wrong. Prefer small, verifiable diffs over large ambitious changes. - ---- - -## 2. Initial Setup (One-Time) - -1. Clone the repo and checkout `main`. -2. Copy `docs/examples/grok43.env.example` to your local `.env` and fill in your `XAI_API_KEY`. -3. Install Grok Build CLI using the current official xAI instructions. - Do not pipe installer scripts into a shell unless the source and any available checksum/signature have been verified. -4. Run `grok inspect` inside the repo root to confirm skills are discovered. -5. (Optional but recommended) Create a personal `skills/` override directory if you want local custom skills. - ---- - -## 3. Standard Session Workflow (Recommended Loop) - -Every productive session follows this pattern: - -### Phase 0: Bootstrap + Workspace Hygiene (Mandatory) - -- Invoke `/core-bootstrap` or run the skill manually through Grok Build. -- Read `GROK.md` + `AGENTS.md` + `docs/runtime_contracts.md`. -- Confirm the current directory and repository root before any operation: - ```bash - pwd - git rev-parse --show-toplevel - test -f GROK.md - test -f AGENTS.md - ``` -- Inspect the local tree before any branch movement: - ```bash - git status --short --branch - git diff --stat - git diff --name-status - git diff --cached --name-status - git stash list - git worktree list - ``` -- If the tree is dirty, classify every loose file/change before switching branches: - - current task work; - - likely prior PR/branch work; - - accidental generated artifact; - - evidence/report file that should be restored; - - unknown. -- For unknown work, inspect history and open PR state before stashing or restoring: - ```bash - git diff -- - git log --oneline --decorate --all -- - git branch --sort=-committerdate | head -20 - gh pr list --state open --limit 20 - gh pr status - ``` -- Preserve unknown work with a descriptive stash; never destroy it blindly: - ```bash - git stash push -m "WIP unknown before : " -- - ``` -- Establish a clean, current baseline: - ```bash - git fetch origin --prune - git switch main - git pull --ff-only origin main - git status --short --branch - ``` -- For non-trivial implementation, create a fresh worktree from current `origin/main`: - ```bash - git worktree add ../core- origin/main -b - cd ../core- - ``` -- Run smoke suite, or record the exact local failure and use repo-native pytest lanes if the `core` CLI is unavailable. -- Read the most recent relevant `HANDOFF-*.md`. - -### Phase 1: Context & Scope - -- Paste the **Session Entry / Context Load** prompt from `docs/core-rd-base-prompts.md`. -- Clearly state the exact scope and the invariant(s) you will preserve. - -### Phase 2: Planning (Plan Mode Preferred) - -- Use **Plan Mode** for anything non-trivial. -- Produce a clear plan with: - - Modules affected - - Invariants touched - - Tests/evals that will be impacted - - Risk assessment - -### Phase 3: Sweep - -- Run full import/call-site/eval sweep before any edit (use `pre-edit-sweep` skill when available). -- Use the 1M context window aggressively. - -### Phase 4: Implementation - -- Make minimal, load-bearing changes. -- Write failing tests *before* behavior changes when possible. -- Prefer explicit refusal over silent wrong answers. - -### Phase 5: Verification - -- Run relevant test suites (smallest relevant first). -- Run **Versor Coherence Guardian** checks on any algebra/field/vault/generate changes. -- Run the **Standing Loop Axiom Check** (#7 from prompt library). -- Verify PR hygiene before opening: - ```bash - git status --short - git diff --check origin/main...HEAD - git diff --name-status origin/main...HEAD - git log --oneline --reverse origin/main..HEAD - ``` - -### Phase 6: Documentation, PR Summary & Handoff - -- Write/update the handoff document using `docs/handoff_template.md`. -- Record exact invariants verified, tests run, and open tasks. -- Every PR summary must include: - - branch name; - - commit list in order; - - exact changed files; - - exact tests/evals run and outputs; - - whether `wrong_total == 0` applies and held; - - known caveats; - - explicit non-goals; - - handoff content or handoff file path. - ---- - -## 4. Using Grok Build Features at Mastery Level - -### Plan Mode - -- Default for any change touching `algebra/`, `field/`, `vault/`, `generate/`, `teaching/`, `core/cognition/`, or `calibration/`. -- Use it even for "small" refactors in sensitive areas. -- Review the plan carefully before approval — this is your main defense against drift. - -### Arena / Parallel Subagents - -- Powerful but high-risk if not structured. -- Recommended pattern: Role separation - - **Agent A**: ADR / invariant auditor - - **Agent B**: Import + call-site sweeper - - **Agent C**: Test/eval designer + verifier - - **Agent D**: Minimal implementation proposer - - **Agent E**: Adversarial reviewer / confuser generator -- All subagent outputs are treated as **independent proposals**. -- Human (or a final reconciliation agent) merges the reconciled result. -- Every subagent must independently satisfy core invariants before its output is considered. - -### Skills System - -- Prefer skills over ad-hoc prompting for repeated patterns. -- Currently available high-value skills: - - `/core-bootstrap` - - `/versor-coherence-guardian` - - `/pre-edit-sweep` - - `/claim-proposal-guardian` -- Use `/skillify` after successful sessions to capture new reusable workflows. - ---- - -## 5. Prompt Library (`docs/core-rd-base-prompts.md`) - -This is the canonical set of phase-specific guardrails. - -**Key sections to use regularly**: -- #1 Session Entry / Context Load (start of almost every session) -- #7 Standing Loop Axiom Check (end of every session before commit) -- #8 PR Merge-Readiness Audit (before opening or merging any PR) -- #9 Grok Build Implementation Session (structured session protocol) - -The other sections (#2–#6) are used situationally depending on the type of work. - ---- - -## 6. Anti-Patterns to Avoid - -- Treating Grok as the final authority on architecture -- Running large changes without Plan Mode on sensitive modules -- Letting Arena subagents edit without role separation and reconciliation -- Skipping the bootstrap + smoke + handoff loop -- Switching branches before inspecting dirty state -- Deleting, resetting, or restoring unknown local work without classifying it -- Pulling `main` without first fetching/pruning and verifying fast-forward state -- Reusing stale branches for new tasks that should start from current `origin/main` -- Using statistical/approximate solutions for exact CGA or epistemic requirements -- Bypassing review gates for claim/pack/policy/identity mutations -- Assuming "it probably didn’t touch the invariant" without verification - ---- - -## 7. PR & Merge Discipline - -Before opening or merging any PR: - -1. Run the **PR Merge-Readiness Audit** prompt (#8). -2. Ensure the diff is minimal and load-bearing. -3. Verify all touched invariants have explicit checks. -4. Confirm relevant tests/evals are green with exact outputs recorded. -5. Write a high-quality handoff document. -6. Include a complete PR summary: branch, commits, changed files, tests/evidence, invariants, caveats, non-goals, and handoff. - -For docs/config/agent-governance PRs (like this one), smoke is usually sufficient. For runtime changes, full validation is required. - ---- - -## 8. Long-Term Maintenance of This Governance Layer - -- The files in this setup (`GROK.md`, `AGENTS.md`, skills, prompt library, handoff template) are living documents. -- When CORE’s architecture evolves (new invariants, new modules, new boundaries), update the relevant governance files in the same PR or a follow-up. -- Periodically review whether new high-value skills should be extracted from successful sessions. -- Treat this layer with the same rigor as runtime code — it protects the architecture. - ---- - -## 9. Quick Reference - -```text -# Bootstrap (in Grok Build TUI or via skill invocation) -/core-bootstrap - -# Confirm root -pwd -git rev-parse --show-toplevel - -# Inspect local state before branch movement -git status --short --branch -git diff --stat -git diff --name-status -git diff --cached --name-status -git stash list -git worktree list - -# Establish clean current main -git fetch origin --prune -git switch main -git pull --ff-only origin main - -# Create fresh worktree for non-trivial work -git worktree add ../core- origin/main -b -cd ../core- - -# Verify core invariant -core test --suite algebra -q - -# Start Grok Build -grok - -# Inspect current skills and config -grok inspect -``` - ---- - -This document, combined with the files it references, represents the current best-known method for using Grok 4.3 + Grok Build on CORE with high discipline and low risk of architectural regression. diff --git a/docs/handoff/BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md b/docs/handoff/BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md deleted file mode 100644 index 1e73e43e..00000000 --- a/docs/handoff/BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md +++ /dev/null @@ -1,300 +0,0 @@ -# Brief 11 — Phase 2 Reader Closure and Capability Snapshot - -**Status:** Active handoff -**Date:** 2026-05-27 -**Branch:** `docs/brief-11-handoff` -**Scope:** Private repo planning and execution handoff only. No public-safe disclosure. No runtime claim is made by this document. - ---- - -## Thesis - -Brief 11 should close the current comprehension-reader corridor before widening measurement or domain scope. - -The latest project state establishes three facts that must govern sequencing: - -1. `gsm8k_math` is not blocked by a lack of eval lanes. It is blocked by incomplete statement understanding. -2. The ADR-0164 reader is the correct replacement path for the brittle ADR-0163 recognizer/injector surface. -3. ADR-0166 now forbids authoring new canonical eval lanes ahead of the capability they measure. - -Therefore Brief 11 is not "make more benchmarks." Brief 11 is the bounded closure pass that turns the Phase 2 reader line into a reliable capability snapshot, then tells the next operator exactly what can safely happen after it. - ---- - -## Current operating facts - -Recent PR descriptions and session logs show the corridor clearly: - -- Phase 1 reader coexistence is additive and flag-gated. With the flag off, behavior should remain byte-identical. -- Phase 1 handles question sentences; statement sentences remained on the regex parser. -- Phase 2 statement-frame work is the dominant path because most refused cases are caused by recognized-but-skipped statements / incomplete solver graphs. -- Wrong-answer protection is currently more important than raising correct count by unsafe partial admission. The wrong=0 guard must remain non-negotiable. -- Main has ADR-0166, which states that measurement follows capability, not the other way around. - -Brief 11 must preserve those facts instead of drifting back into lane proliferation or superficial UI/demo work. - ---- - -## Goal - -Produce a mechanically useful handoff for the next engineering pass after Brief 10 / Phase 2 reader work: - -1. Define the closure gates for the Phase 2 statement reader. -2. Define the capability snapshot that should be run immediately after closure. -3. Define the no-go boundaries that prevent unsafe widening. -4. Define the next branch/PR sequence so a lead engineer can continue without re-litigating the strategy. - ---- - -## Non-goals - -Brief 11 does not: - -- add new OOD eval lanes; -- claim expert-level GSM8K capability; -- relax wrong=0; -- bypass the reader with broader regex patches; -- add public-facing disclosure material; -- promote any audit/expert/demo tier; -- mutate seed packs or teaching stores as a side effect of chat/runtime smoke tests. - ---- - -## Acceptance gates - -### Gate 1 — Reader completeness delta - -Run the canonical GSM8K train-sample measurement with the reader path enabled and disabled. - -Required outputs: - -- baseline regex-only result; -- reader-enabled result; -- refused/correct/wrong counts; -- per-case refusal reason taxonomy; -- explicit list of cases fixed by Phase 2 statement frames; -- explicit list of cases still refused and why. - -Hard invariant: - -- `wrong == 0` must hold. - -If `correct` rises while `wrong > 0`, the PR is not a success. It is a regression with useful diagnostics. - -### Gate 2 — Recognized-skipped statement audit - -For every still-refused case where the reader recognized tokens but did not inject a complete graph, emit a compact audit row: - -```text -case_id | sentence_index | recognized_terms | skipped_frame | missing_operator | refusal_reason -``` - -This is the main Brief 11 artifact because it turns the remaining GSM8K bottleneck into queued capability work instead of guesswork. - -### Gate 3 — Graph completeness proof - -For every admitted case, prove the solver graph is complete before candidate projection: - -- all quantities have owners or intentionally anonymous scope; -- all units are canonicalized; -- operations are typed; -- question target slot resolves to an entity/unit/kind; -- no recognized-but-uncommitted frame is present. - -This gate is the successor to the wrong=0 guard. The guard catches unsafe admission; graph completeness prevents unsafe admission from being attempted. - -### Gate 4 — Determinism and trace stability - -Run the reader-enabled measurement twice with identical input and config. - -Required: - -- identical case outcomes; -- identical trace hashes where applicable; -- stable refusal taxonomy ordering; -- no nondeterministic iteration over entity registries, frame sets, or lexicon categories. - -### Gate 5 — Feature-flag hygiene - -The reader path must remain explicitly controlled until the capability snapshot justifies default-on behavior. - -Required: - -- flag-off path remains byte-compatible with current main expectations; -- flag-on path produces trace evidence that reader code actually executed; -- fallback behavior is explicit: reader refusal may fall through only when doing so cannot hide a recognized-skipped statement. - -### Gate 6 — Capability snapshot, not promotion - -After the above gates pass, run the existing relevant lanes / tables to populate the current capability snapshot. - -Allowed: - -- rerun existing GSM8K / capability-axis lanes; -- update current metric artifacts; -- populate existing TBD rows only where the lane already exists and produces signal. - -Forbidden: - -- adding new canonical lanes just to make the table look complete; -- treating a snapshot as expert promotion; -- merging a measurement PR that conceals capability absence behind aggregate numbers. - ---- - -## Recommended branch / PR sequence - -### PR 11A — Reader Phase 2 closure audit - -**Branch:** `feat/brief-11-reader-closure-audit` - -Deliverables: - -- audit artifact for recognized-skipped statement cases; -- per-case refusal taxonomy; -- graph-completeness assertion helpers; -- tests around incomplete graph refusal. - -Exit condition: - -- measurement identifies the exact remaining missing operators without raising `wrong`. - -### PR 11B — Reader closure fixes - -**Branch:** `feat/brief-11-reader-closure-fixes` - -Deliverables: - -- minimal statement-frame fixes for the highest-leverage missing operators; -- no broad regex expansion unless proven temporary and fenced; -- deterministic tests for each newly admitted case; -- updated measurement artifact. - -Exit condition: - -- correct count improves or refusal taxonomy shrinks, while `wrong == 0`. - -### PR 11C — Existing-lane capability snapshot - -**Branch:** `eval/brief-11-capability-snapshot` - -Deliverables: - -- rerun existing relevant lanes only; -- update metric ledgers / result JSONs; -- summarize what changed after the reader closure; -- explicitly list deferred lanes that remain blocked by missing capability. - -Exit condition: - -- snapshot numbers are reproducible and do not claim promotion. - -### PR 11D — Next capability proposal - -**Branch:** `docs/brief-11-next-capability-proposal` - -Deliverables: - -- a concise proposal selecting the next capability after GSM8K reader closure; -- must pass ADR-0166's three-question test before any new lane is authored; -- should compare: continued GSM8K operator closure, cross-domain reader generalization, tool-use trace integration, and Workbench demo hardening. - -Exit condition: - -- lead engineer has a yes/no decision artifact, not another sprawling roadmap. - ---- - -## Failure modes to avoid - -### 1. Correct-count greed - -Raising correct count by allowing incomplete graph admission violates the project. Any such result should be treated as a failed experiment, not progress. - -### 2. Regex relapse - -ADR-0165 exists because regex can be useful at boundaries but dangerous as a semantic substitute. Brief 11 should not broaden regex to impersonate reader comprehension. - -### 3. Eval surface inflation - -New lanes before capability will generate uniform refusals and strategic noise. ADR-0166 forbids this. - -### 4. Snapshot-as-promotion - -A capability snapshot is a diagnostic state report. It is not an expert promotion, investor claim, or public disclosure. - -### 5. Hidden side effects - -Reader measurement must not mutate teaching stores, seed packs, runtime state, or public-facing artifacts unless the PR explicitly declares and tests those mutations. - ---- - -## Minimum evidence package for the final Brief 11 PR - -The final PR in this sequence should include: - -```text -- command(s) run -- environment/config flags -- baseline result path -- reader-enabled result path -- before/after correct/refused/wrong table -- still-refused taxonomy -- fixed-case taxonomy -- graph completeness assertion summary -- determinism rerun summary -- explicit deferred-work list -``` - -Suggested table: - -| Mode | Correct | Refused | Wrong | Notes | -|---|---:|---:|---:|---| -| regex-only baseline | TBD | TBD | TBD | current main behavior | -| reader Phase 1 | TBD | TBD | TBD | question-frame reader only | -| reader Phase 2 closure | TBD | TBD | TBD | statement-frame reader path | - ---- - -## Definition of done - -Brief 11 is done when the repo has a reproducible, reviewed capability snapshot after Phase 2 reader closure and a precise backlog of remaining missing operators. - -It is not done merely because a document exists. This document is the operator handoff; the engineering sequence above is the work. - ---- - -## Status update — 2026-05-27 EOD - -The Brief 11 sequence landed across the day. Completion path: - -| Sub-brief | Status | PR(s) | Notes | -|---|---|---|---| -| 11A — reader closure audit infrastructure | ✅ Merged | #343 | `generate/comprehension/audit.py` + 18 audit tests | -| 11B-step-1 — per-case audit artifact + extended taxonomy | ✅ Merged | #345 | 3 new missing-operator labels close the None-operator gap | -| 11B-step-2 — verb-vocabulary analysis (docs-only) | ✅ Merged | #347 | All "unknown verbs" found to be lexicon-present; pre_frame_filler is structural | -| 11B-step-2 — lexicon-entry closure | ✅ Merged | #348 | 12 drain_token lemmas + 1 alias; `unknown_word` row 11→5; wrong=0 preserved | -| 11C — capability snapshot rerun | ✅ Absorbed | (in W3-A) | Folded into ADR-0167 W3-A's Deliverable 2 (post-W2 baseline section in `audit_brief_11.md`) | -| 11D — next-capability proposal | ✅ Merged | #346 | Candidate A (continued GSM8K closure) recommended | -| 11D — Candidate E (audit-as-evidence) | ✅ Merged | #349 | ADR-0167 scoping ADR + parallel work plan | - -The bottleneck table after 11B-step-2 lexicon closure (current post-Brief-11 -baseline; W3-A will produce the post-ADR-0167-LexicalClaim baseline): - -| refusal_reason | count | Δ vs 11B-step-1 | -|---|---:|---:| -| incomplete_operation | 20 | +2 | -| unexpected_category | 17 | +3 | -| unknown_word | 5 | **−6** | -| unattached_quantity | 4 | +1 | -| unresolved_pronoun | 3 | 0 | -| no_question_target | 1 | 0 | - -`wrong == 0` held throughout. Case `gsm8k-train-sample-v1-0050` remains -refused at sentence_index=0 (pinned by multiple test suites). - -**Next:** ADR-0167 W3-A closes the LexicalClaim slice with an e2e test -that walks the full loop (refusal → evidence → ratification → row-moves), -plus a cognition-corridor regression pass. After W3-A, Brief 11 closes -and the engine can ratify math-domain lexical claims from its own -refusal evidence through the existing HITL teaching corridor. diff --git a/docs/handoff/ADR-0084-pack-content-brief.md b/docs/handoffs/ADR-0084-pack-content-brief.md similarity index 100% rename from docs/handoff/ADR-0084-pack-content-brief.md rename to docs/handoffs/ADR-0084-pack-content-brief.md diff --git a/docs/handoff/ADR-0085-content-style-pass-brief.md b/docs/handoffs/ADR-0085-content-style-pass-brief.md similarity index 100% rename from docs/handoff/ADR-0085-content-style-pass-brief.md rename to docs/handoffs/ADR-0085-content-style-pass-brief.md diff --git a/docs/handoff/ADR-0085-content-style-pass-v2-brief.md b/docs/handoffs/ADR-0085-content-style-pass-v2-brief.md similarity index 100% rename from docs/handoff/ADR-0085-content-style-pass-v2-brief.md rename to docs/handoffs/ADR-0085-content-style-pass-v2-brief.md diff --git a/docs/handoff/ADR-0167-FOLLOWUPS.md b/docs/handoffs/ADR-0167-FOLLOWUPS.md similarity index 100% rename from docs/handoff/ADR-0167-FOLLOWUPS.md rename to docs/handoffs/ADR-0167-FOLLOWUPS.md diff --git a/docs/handoff/ADR-0167-PARALLEL-WORK-PLAN.md b/docs/handoffs/ADR-0167-PARALLEL-WORK-PLAN.md similarity index 100% rename from docs/handoff/ADR-0167-PARALLEL-WORK-PLAN.md rename to docs/handoffs/ADR-0167-PARALLEL-WORK-PLAN.md diff --git a/docs/handoff/ADR-0167-W2C-cross-domain-audit.md b/docs/handoffs/ADR-0167-W2C-cross-domain-audit.md similarity index 100% rename from docs/handoff/ADR-0167-W2C-cross-domain-audit.md rename to docs/handoffs/ADR-0167-W2C-cross-domain-audit.md diff --git a/docs/handoff/ADR-0172-TIER1-BRIEF-PACK.md b/docs/handoffs/ADR-0172-TIER1-BRIEF-PACK.md similarity index 100% rename from docs/handoff/ADR-0172-TIER1-BRIEF-PACK.md rename to docs/handoffs/ADR-0172-TIER1-BRIEF-PACK.md diff --git a/docs/handoff/ADR-0174-PHASE-3B-4-COMBINED-SCOPE.md b/docs/handoffs/ADR-0174-PHASE-3B-4-COMBINED-SCOPE.md similarity index 100% rename from docs/handoff/ADR-0174-PHASE-3B-4-COMBINED-SCOPE.md rename to docs/handoffs/ADR-0174-PHASE-3B-4-COMBINED-SCOPE.md diff --git a/docs/handoff/AUDIT-ADR-0178-GB1-GB2.md b/docs/handoffs/AUDIT-ADR-0178-GB1-GB2.md similarity index 100% rename from docs/handoff/AUDIT-ADR-0178-GB1-GB2.md rename to docs/handoffs/AUDIT-ADR-0178-GB1-GB2.md diff --git a/docs/handoff/AUDIT-ADR-0179-EX-RECONCILE.md b/docs/handoffs/AUDIT-ADR-0179-EX-RECONCILE.md similarity index 100% rename from docs/handoff/AUDIT-ADR-0179-EX-RECONCILE.md rename to docs/handoffs/AUDIT-ADR-0179-EX-RECONCILE.md diff --git a/docs/handoff/BACKLOG-everyday-atoms-grounding-pack.md b/docs/handoffs/BACKLOG-everyday-atoms-grounding-pack.md similarity index 100% rename from docs/handoff/BACKLOG-everyday-atoms-grounding-pack.md rename to docs/handoffs/BACKLOG-everyday-atoms-grounding-pack.md diff --git a/docs/handoffs/BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md b/docs/handoffs/BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md index dcc8eb0c..1e73e43e 100644 --- a/docs/handoffs/BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md +++ b/docs/handoffs/BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md @@ -1,6 +1,6 @@ # Brief 11 — Phase 2 Reader Closure and Capability Snapshot -**Status:** Proposed handoff +**Status:** Active handoff **Date:** 2026-05-27 **Branch:** `docs/brief-11-handoff` **Scope:** Private repo planning and execution handoff only. No public-safe disclosure. No runtime claim is made by this document. @@ -264,29 +264,37 @@ It is not done merely because a document exists. This document is the operator h --- -## Suggested PR body template +## Status update — 2026-05-27 EOD -```markdown -## Summary +The Brief 11 sequence landed across the day. Completion path: -Brief 11 handoff: closes the ADR-0164 Phase 2 reader corridor before widening measurement scope. Defines gates for reader completeness, recognized-skipped statement audit, graph completeness, determinism, feature-flag hygiene, and existing-lane snapshot. +| Sub-brief | Status | PR(s) | Notes | +|---|---|---|---| +| 11A — reader closure audit infrastructure | ✅ Merged | #343 | `generate/comprehension/audit.py` + 18 audit tests | +| 11B-step-1 — per-case audit artifact + extended taxonomy | ✅ Merged | #345 | 3 new missing-operator labels close the None-operator gap | +| 11B-step-2 — verb-vocabulary analysis (docs-only) | ✅ Merged | #347 | All "unknown verbs" found to be lexicon-present; pre_frame_filler is structural | +| 11B-step-2 — lexicon-entry closure | ✅ Merged | #348 | 12 drain_token lemmas + 1 alias; `unknown_word` row 11→5; wrong=0 preserved | +| 11C — capability snapshot rerun | ✅ Absorbed | (in W3-A) | Folded into ADR-0167 W3-A's Deliverable 2 (post-W2 baseline section in `audit_brief_11.md`) | +| 11D — next-capability proposal | ✅ Merged | #346 | Candidate A (continued GSM8K closure) recommended | +| 11D — Candidate E (audit-as-evidence) | ✅ Merged | #349 | ADR-0167 scoping ADR + parallel work plan | -## Why +The bottleneck table after 11B-step-2 lexicon closure (current post-Brief-11 +baseline; W3-A will produce the post-ADR-0167-LexicalClaim baseline): -Recent PRs show the GSM8K bottleneck is incomplete statement understanding, not missing eval lanes. ADR-0166 requires capability before measurement expansion. +| refusal_reason | count | Δ vs 11B-step-1 | +|---|---:|---:| +| incomplete_operation | 20 | +2 | +| unexpected_category | 17 | +3 | +| unknown_word | 5 | **−6** | +| unattached_quantity | 4 | +1 | +| unresolved_pronoun | 3 | 0 | +| no_question_target | 1 | 0 | -## Deliverables +`wrong == 0` held throughout. Case `gsm8k-train-sample-v1-0050` remains +refused at sentence_index=0 (pinned by multiple test suites). -- docs/handoffs/BRIEF-11-phase-2-reader-closure-and-capability-snapshot.md - -## Test plan - -Docs-only. No runtime change. - -## Follow-up sequence - -- 11A: reader closure audit -- 11B: closure fixes -- 11C: existing-lane capability snapshot -- 11D: next capability proposal -``` +**Next:** ADR-0167 W3-A closes the LexicalClaim slice with an e2e test +that walks the full loop (refusal → evidence → ratification → row-moves), +plus a cognition-corridor regression pass. After W3-A, Brief 11 closes +and the engine can ratify math-domain lexical claims from its own +refusal evidence through the existing HITL teaching corridor. diff --git a/docs/handoff/CHATGPT-REMOTE-BRIEF.md b/docs/handoffs/CHATGPT-REMOTE-BRIEF.md similarity index 100% rename from docs/handoff/CHATGPT-REMOTE-BRIEF.md rename to docs/handoffs/CHATGPT-REMOTE-BRIEF.md diff --git a/docs/handoff/CLEANUP-C2-run-lane-migration.md b/docs/handoffs/CLEANUP-C2-run-lane-migration.md similarity index 100% rename from docs/handoff/CLEANUP-C2-run-lane-migration.md rename to docs/handoffs/CLEANUP-C2-run-lane-migration.md diff --git a/docs/handoff/CLEANUP-C4-compositions-compile.md b/docs/handoffs/CLEANUP-C4-compositions-compile.md similarity index 100% rename from docs/handoff/CLEANUP-C4-compositions-compile.md rename to docs/handoffs/CLEANUP-C4-compositions-compile.md diff --git a/docs/handoff/CODEX-domain-pack-closure-cleanup-brief.md b/docs/handoffs/CODEX-domain-pack-closure-cleanup-brief.md similarity index 100% rename from docs/handoff/CODEX-domain-pack-closure-cleanup-brief.md rename to docs/handoffs/CODEX-domain-pack-closure-cleanup-brief.md diff --git a/docs/handoff/CODEX-greek-hebrew-content-phase-ii-brief.md b/docs/handoffs/CODEX-greek-hebrew-content-phase-ii-brief.md similarity index 100% rename from docs/handoff/CODEX-greek-hebrew-content-phase-ii-brief.md rename to docs/handoffs/CODEX-greek-hebrew-content-phase-ii-brief.md diff --git a/docs/handoff/COMPOSITION-FRAME-CONSUMPTION-WIRING-BRIEF.md b/docs/handoffs/COMPOSITION-FRAME-CONSUMPTION-WIRING-BRIEF.md similarity index 100% rename from docs/handoff/COMPOSITION-FRAME-CONSUMPTION-WIRING-BRIEF.md rename to docs/handoffs/COMPOSITION-FRAME-CONSUMPTION-WIRING-BRIEF.md diff --git a/docs/handoff/COMPOSITIONCLAIM-BRIEF-PACK.md b/docs/handoffs/COMPOSITIONCLAIM-BRIEF-PACK.md similarity index 100% rename from docs/handoff/COMPOSITIONCLAIM-BRIEF-PACK.md rename to docs/handoffs/COMPOSITIONCLAIM-BRIEF-PACK.md diff --git a/docs/handoff/COMPREHENSION-READER-AUDIT.md b/docs/handoffs/COMPREHENSION-READER-AUDIT.md similarity index 100% rename from docs/handoff/COMPREHENSION-READER-AUDIT.md rename to docs/handoffs/COMPREHENSION-READER-AUDIT.md diff --git a/docs/handoff/CONSUMPTION-WIRING-DISPATCH-PACK.md b/docs/handoffs/CONSUMPTION-WIRING-DISPATCH-PACK.md similarity index 100% rename from docs/handoff/CONSUMPTION-WIRING-DISPATCH-PACK.md rename to docs/handoffs/CONSUMPTION-WIRING-DISPATCH-PACK.md diff --git a/docs/handoff/DCS-S1-FINDING.md b/docs/handoffs/DCS-S1-FINDING.md similarity index 100% rename from docs/handoff/DCS-S1-FINDING.md rename to docs/handoffs/DCS-S1-FINDING.md diff --git a/HANDOFF-gpt55-2026-06-03.md b/docs/handoffs/HANDOFF-gpt55-2026-06-03.md similarity index 98% rename from HANDOFF-gpt55-2026-06-03.md rename to docs/handoffs/HANDOFF-gpt55-2026-06-03.md index ca5a143a..230b4322 100644 --- a/HANDOFF-gpt55-2026-06-03.md +++ b/docs/handoffs/HANDOFF-gpt55-2026-06-03.md @@ -1,3 +1,6 @@ +> [!WARNING] +> [superseded by HANDOFF-gpt55-2026-06-20.md] + # HANDOFF gpt55 2026-06-03 Branch: `codex/ntimes-completeness-guard` diff --git a/HANDOFF-gpt55-2026-06-18.md b/docs/handoffs/HANDOFF-gpt55-2026-06-18.md similarity index 98% rename from HANDOFF-gpt55-2026-06-18.md rename to docs/handoffs/HANDOFF-gpt55-2026-06-18.md index e9d0640a..aff2badb 100644 --- a/HANDOFF-gpt55-2026-06-18.md +++ b/docs/handoffs/HANDOFF-gpt55-2026-06-18.md @@ -1,3 +1,6 @@ +> [!WARNING] +> [superseded by HANDOFF-gpt55-2026-06-20.md] + # HANDOFF — gpt55 — 2026-06-18 ## Agent and Session diff --git a/HANDOFF-gpt55-2026-06-20.md b/docs/handoffs/HANDOFF-gpt55-2026-06-20.md similarity index 100% rename from HANDOFF-gpt55-2026-06-20.md rename to docs/handoffs/HANDOFF-gpt55-2026-06-20.md diff --git a/docs/handoff/MATCHER-EXTENSION-DISPATCH-PACK.md b/docs/handoffs/MATCHER-EXTENSION-DISPATCH-PACK.md similarity index 100% rename from docs/handoff/MATCHER-EXTENSION-DISPATCH-PACK.md rename to docs/handoffs/MATCHER-EXTENSION-DISPATCH-PACK.md diff --git a/docs/handoff/ME1-ME5-MILESTONE.md b/docs/handoffs/ME1-ME5-MILESTONE.md similarity index 100% rename from docs/handoff/ME1-ME5-MILESTONE.md rename to docs/handoffs/ME1-ME5-MILESTONE.md diff --git a/docs/handoff/NEXT-SUBJECTS-CHATGPT-HANDOFF.md b/docs/handoffs/NEXT-SUBJECTS-CHATGPT-HANDOFF.md similarity index 100% rename from docs/handoff/NEXT-SUBJECTS-CHATGPT-HANDOFF.md rename to docs/handoffs/NEXT-SUBJECTS-CHATGPT-HANDOFF.md diff --git a/docs/handoff/PARALLEL-WORK-PLAN-2026-05-29.md b/docs/handoffs/PARALLEL-WORK-PLAN-2026-05-29.md similarity index 100% rename from docs/handoff/PARALLEL-WORK-PLAN-2026-05-29.md rename to docs/handoffs/PARALLEL-WORK-PLAN-2026-05-29.md diff --git a/docs/handoff/PHASE-3.1-FOLLOWUP-RECOGNIZER-EXPANSION.md b/docs/handoffs/PHASE-3.1-FOLLOWUP-RECOGNIZER-EXPANSION.md similarity index 100% rename from docs/handoff/PHASE-3.1-FOLLOWUP-RECOGNIZER-EXPANSION.md rename to docs/handoffs/PHASE-3.1-FOLLOWUP-RECOGNIZER-EXPANSION.md diff --git a/docs/handoff/POST-RAT1-PARALLEL-BRIEFS.md b/docs/handoffs/POST-RAT1-PARALLEL-BRIEFS.md similarity index 100% rename from docs/handoff/POST-RAT1-PARALLEL-BRIEFS.md rename to docs/handoffs/POST-RAT1-PARALLEL-BRIEFS.md diff --git a/docs/handoff/RB-GSM-SOLVER-DESIGN-INPUT.md b/docs/handoffs/RB-GSM-SOLVER-DESIGN-INPUT.md similarity index 100% rename from docs/handoff/RB-GSM-SOLVER-DESIGN-INPUT.md rename to docs/handoffs/RB-GSM-SOLVER-DESIGN-INPUT.md diff --git a/docs/handoff/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md b/docs/handoffs/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md similarity index 100% rename from docs/handoff/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md rename to docs/handoffs/SEMANTIC-STATE-TRANSITION-BLUEPRINT.md diff --git a/docs/handoff/TIER2-AND-FRAMECLAIM-BRIEF-PACK.md b/docs/handoffs/TIER2-AND-FRAMECLAIM-BRIEF-PACK.md similarity index 100% rename from docs/handoff/TIER2-AND-FRAMECLAIM-BRIEF-PACK.md rename to docs/handoffs/TIER2-AND-FRAMECLAIM-BRIEF-PACK.md diff --git a/docs/handoff/VERB-EXPANSION-DISPATCH-PACK.md b/docs/handoffs/VERB-EXPANSION-DISPATCH-PACK.md similarity index 100% rename from docs/handoff/VERB-EXPANSION-DISPATCH-PACK.md rename to docs/handoffs/VERB-EXPANSION-DISPATCH-PACK.md diff --git a/docs/handoff/WAVE-NEXT-REVISED.md b/docs/handoffs/WAVE-NEXT-REVISED.md similarity index 100% rename from docs/handoff/WAVE-NEXT-REVISED.md rename to docs/handoffs/WAVE-NEXT-REVISED.md diff --git a/docs/handoff/WORKBENCH-UI-WAVE-BRIEF-PACK.md b/docs/handoffs/WORKBENCH-UI-WAVE-BRIEF-PACK.md similarity index 100% rename from docs/handoff/WORKBENCH-UI-WAVE-BRIEF-PACK.md rename to docs/handoffs/WORKBENCH-UI-WAVE-BRIEF-PACK.md diff --git a/docs/handoff/WORKBENCH-UI-WAVE-SCOPING.md b/docs/handoffs/WORKBENCH-UI-WAVE-SCOPING.md similarity index 100% rename from docs/handoff/WORKBENCH-UI-WAVE-SCOPING.md rename to docs/handoffs/WORKBENCH-UI-WAVE-SCOPING.md diff --git a/docs/handoff/WORKBENCH-W3-RATIFICATION-CORRIDOR-BRIEF.md b/docs/handoffs/WORKBENCH-W3-RATIFICATION-CORRIDOR-BRIEF.md similarity index 100% rename from docs/handoff/WORKBENCH-W3-RATIFICATION-CORRIDOR-BRIEF.md rename to docs/handoffs/WORKBENCH-W3-RATIFICATION-CORRIDOR-BRIEF.md diff --git a/docs/handoff/arithmetic-comprehension-via-binding-graph-2026-06-05.md b/docs/handoffs/arithmetic-comprehension-via-binding-graph-2026-06-05.md similarity index 100% rename from docs/handoff/arithmetic-comprehension-via-binding-graph-2026-06-05.md rename to docs/handoffs/arithmetic-comprehension-via-binding-graph-2026-06-05.md diff --git a/docs/handoff/assets/workbench-truncated-cell/proposals_reveal.png b/docs/handoffs/assets/workbench-truncated-cell/proposals_reveal.png similarity index 100% rename from docs/handoff/assets/workbench-truncated-cell/proposals_reveal.png rename to docs/handoffs/assets/workbench-truncated-cell/proposals_reveal.png diff --git a/docs/handoff/assets/workbench-truncated-cell/proposals_table.png b/docs/handoffs/assets/workbench-truncated-cell/proposals_table.png similarity index 100% rename from docs/handoff/assets/workbench-truncated-cell/proposals_table.png rename to docs/handoffs/assets/workbench-truncated-cell/proposals_table.png diff --git a/docs/handoff/assets/workbench-truncated-cell/trace_edge_reveal.png b/docs/handoffs/assets/workbench-truncated-cell/trace_edge_reveal.png similarity index 100% rename from docs/handoff/assets/workbench-truncated-cell/trace_edge_reveal.png rename to docs/handoffs/assets/workbench-truncated-cell/trace_edge_reveal.png diff --git a/docs/handoff/assets/workbench-truncated-cell/trace_full.png b/docs/handoffs/assets/workbench-truncated-cell/trace_full.png similarity index 100% rename from docs/handoff/assets/workbench-truncated-cell/trace_full.png rename to docs/handoffs/assets/workbench-truncated-cell/trace_full.png diff --git a/docs/handoff/assets/workbench-truncated-cell/trace_rail_reveal.png b/docs/handoffs/assets/workbench-truncated-cell/trace_rail_reveal.png similarity index 100% rename from docs/handoff/assets/workbench-truncated-cell/trace_rail_reveal.png rename to docs/handoffs/assets/workbench-truncated-cell/trace_rail_reveal.png diff --git a/docs/handoff/b4-pr1-frameverdict-type-inv31-brief-2026-06-15.md b/docs/handoffs/b4-pr1-frameverdict-type-inv31-brief-2026-06-15.md similarity index 100% rename from docs/handoff/b4-pr1-frameverdict-type-inv31-brief-2026-06-15.md rename to docs/handoffs/b4-pr1-frameverdict-type-inv31-brief-2026-06-15.md diff --git a/docs/handoff/core-logos-W-Forge-brief-2026-06-14.md b/docs/handoffs/core-logos-W-Forge-brief-2026-06-14.md similarity index 100% rename from docs/handoff/core-logos-W-Forge-brief-2026-06-14.md rename to docs/handoffs/core-logos-W-Forge-brief-2026-06-14.md diff --git a/docs/handoff/core-logos-W-Holonomy-brief-2026-06-14.md b/docs/handoffs/core-logos-W-Holonomy-brief-2026-06-14.md similarity index 100% rename from docs/handoff/core-logos-W-Holonomy-brief-2026-06-14.md rename to docs/handoffs/core-logos-W-Holonomy-brief-2026-06-14.md diff --git a/docs/handoff/core-logos-studio-LG2-brief-2026-06-14.md b/docs/handoffs/core-logos-studio-LG2-brief-2026-06-14.md similarity index 100% rename from docs/handoff/core-logos-studio-LG2-brief-2026-06-14.md rename to docs/handoffs/core-logos-studio-LG2-brief-2026-06-14.md diff --git a/docs/handoff/core-logos-studio-LG3-brief-2026-06-14.md b/docs/handoffs/core-logos-studio-LG3-brief-2026-06-14.md similarity index 100% rename from docs/handoff/core-logos-studio-LG3-brief-2026-06-14.md rename to docs/handoffs/core-logos-studio-LG3-brief-2026-06-14.md diff --git a/docs/handoff/core-logos-studio-LG4-brief-2026-06-14.md b/docs/handoffs/core-logos-studio-LG4-brief-2026-06-14.md similarity index 100% rename from docs/handoff/core-logos-studio-LG4-brief-2026-06-14.md rename to docs/handoffs/core-logos-studio-LG4-brief-2026-06-14.md diff --git a/docs/handoff/core-logos-studio-readonly-briefs-2026-06-14.md b/docs/handoffs/core-logos-studio-readonly-briefs-2026-06-14.md similarity index 100% rename from docs/handoff/core-logos-studio-readonly-briefs-2026-06-14.md rename to docs/handoffs/core-logos-studio-readonly-briefs-2026-06-14.md diff --git a/docs/handoff/demo-capture-shotlist-2026-06-14.md b/docs/handoffs/demo-capture-shotlist-2026-06-14.md similarity index 100% rename from docs/handoff/demo-capture-shotlist-2026-06-14.md rename to docs/handoffs/demo-capture-shotlist-2026-06-14.md diff --git a/docs/handoff/discrete_count_statement-injector-spec.md b/docs/handoffs/discrete_count_statement-injector-spec.md similarity index 100% rename from docs/handoff/discrete_count_statement-injector-spec.md rename to docs/handoffs/discrete_count_statement-injector-spec.md diff --git a/docs/handoff/l10-continuity-hardening-briefs-2026-06-15.md b/docs/handoffs/l10-continuity-hardening-briefs-2026-06-15.md similarity index 100% rename from docs/handoff/l10-continuity-hardening-briefs-2026-06-15.md rename to docs/handoffs/l10-continuity-hardening-briefs-2026-06-15.md diff --git a/docs/handoff/logos-collapse-anchor-reconciliation-2026-06-14.md b/docs/handoffs/logos-collapse-anchor-reconciliation-2026-06-14.md similarity index 100% rename from docs/handoff/logos-collapse-anchor-reconciliation-2026-06-14.md rename to docs/handoffs/logos-collapse-anchor-reconciliation-2026-06-14.md diff --git a/docs/handoff/phase-3b-4-skeleton/README.md b/docs/handoffs/phase-3b-4-skeleton/README.md similarity index 100% rename from docs/handoff/phase-3b-4-skeleton/README.md rename to docs/handoffs/phase-3b-4-skeleton/README.md diff --git a/docs/handoff/phase-3b-4-skeleton/en_core_names_v1/gender.jsonl b/docs/handoffs/phase-3b-4-skeleton/en_core_names_v1/gender.jsonl similarity index 100% rename from docs/handoff/phase-3b-4-skeleton/en_core_names_v1/gender.jsonl rename to docs/handoffs/phase-3b-4-skeleton/en_core_names_v1/gender.jsonl diff --git a/docs/handoff/phase-3b-4-skeleton/en_core_names_v1/manifest.json b/docs/handoffs/phase-3b-4-skeleton/en_core_names_v1/manifest.json similarity index 100% rename from docs/handoff/phase-3b-4-skeleton/en_core_names_v1/manifest.json rename to docs/handoffs/phase-3b-4-skeleton/en_core_names_v1/manifest.json diff --git a/docs/handoff/phase-3b-4-skeleton/test_adr_0174_phase3b_compound_clause.py b/docs/handoffs/phase-3b-4-skeleton/test_adr_0174_phase3b_compound_clause.py similarity index 100% rename from docs/handoff/phase-3b-4-skeleton/test_adr_0174_phase3b_compound_clause.py rename to docs/handoffs/phase-3b-4-skeleton/test_adr_0174_phase3b_compound_clause.py diff --git a/docs/handoff/phase-3b-4-skeleton/test_adr_0174_phase4_contemplate.py b/docs/handoffs/phase-3b-4-skeleton/test_adr_0174_phase4_contemplate.py similarity index 100% rename from docs/handoff/phase-3b-4-skeleton/test_adr_0174_phase4_contemplate.py rename to docs/handoffs/phase-3b-4-skeleton/test_adr_0174_phase4_contemplate.py diff --git a/docs/handoff/proof-carrying-wiring-scope-2026-06-14.md b/docs/handoffs/proof-carrying-wiring-scope-2026-06-14.md similarity index 100% rename from docs/handoff/proof-carrying-wiring-scope-2026-06-14.md rename to docs/handoffs/proof-carrying-wiring-scope-2026-06-14.md diff --git a/docs/handoff/proofwriter-owa-and-relational-reader-briefs-2026-06-06.md b/docs/handoffs/proofwriter-owa-and-relational-reader-briefs-2026-06-06.md similarity index 100% rename from docs/handoff/proofwriter-owa-and-relational-reader-briefs-2026-06-06.md rename to docs/handoffs/proofwriter-owa-and-relational-reader-briefs-2026-06-06.md diff --git a/docs/handoff/sealed-measurement-obligation-2026-06-04.md b/docs/handoffs/sealed-measurement-obligation-2026-06-04.md similarity index 100% rename from docs/handoff/sealed-measurement-obligation-2026-06-04.md rename to docs/handoffs/sealed-measurement-obligation-2026-06-04.md diff --git a/docs/handoff/stage-c-composition-investigation-2026-06-03.md b/docs/handoffs/stage-c-composition-investigation-2026-06-03.md similarity index 100% rename from docs/handoff/stage-c-composition-investigation-2026-06-03.md rename to docs/handoffs/stage-c-composition-investigation-2026-06-03.md diff --git a/docs/handoff/step3-relational-reasoning-brief-pack-2026-06-15.md b/docs/handoffs/step3-relational-reasoning-brief-pack-2026-06-15.md similarity index 100% rename from docs/handoff/step3-relational-reasoning-brief-pack-2026-06-15.md rename to docs/handoffs/step3-relational-reasoning-brief-pack-2026-06-15.md diff --git a/docs/handoff/wave-1-evidence-spine-briefs-2026-06-12.md b/docs/handoffs/wave-1-evidence-spine-briefs-2026-06-12.md similarity index 100% rename from docs/handoff/wave-1-evidence-spine-briefs-2026-06-12.md rename to docs/handoffs/wave-1-evidence-spine-briefs-2026-06-12.md diff --git a/docs/handoff/wave-M-phaseB-calibration-briefs-2026-06-13.md b/docs/handoffs/wave-M-phaseB-calibration-briefs-2026-06-13.md similarity index 100% rename from docs/handoff/wave-M-phaseB-calibration-briefs-2026-06-13.md rename to docs/handoffs/wave-M-phaseB-calibration-briefs-2026-06-13.md diff --git a/docs/handoff/wave-R-mastery-briefs-2026-06-12.md b/docs/handoffs/wave-R-mastery-briefs-2026-06-12.md similarity index 100% rename from docs/handoff/wave-R-mastery-briefs-2026-06-12.md rename to docs/handoffs/wave-R-mastery-briefs-2026-06-12.md diff --git a/docs/handoff/wave-R2-backend-brief-2026-06-12.md b/docs/handoffs/wave-R2-backend-brief-2026-06-12.md similarity index 100% rename from docs/handoff/wave-R2-backend-brief-2026-06-12.md rename to docs/handoffs/wave-R2-backend-brief-2026-06-12.md diff --git a/docs/handoff/wave-R2-route-briefs-2026-06-12.md b/docs/handoffs/wave-R2-route-briefs-2026-06-12.md similarity index 100% rename from docs/handoff/wave-R2-route-briefs-2026-06-12.md rename to docs/handoffs/wave-R2-route-briefs-2026-06-12.md diff --git a/docs/handoff/wave-R2-route-briefs-part2-2026-06-12.md b/docs/handoffs/wave-R2-route-briefs-part2-2026-06-12.md similarity index 100% rename from docs/handoff/wave-R2-route-briefs-part2-2026-06-12.md rename to docs/handoffs/wave-R2-route-briefs-part2-2026-06-12.md diff --git a/docs/handoff/wave-R3-briefs-2026-06-13.md b/docs/handoffs/wave-R3-briefs-2026-06-13.md similarity index 100% rename from docs/handoff/wave-R3-briefs-2026-06-13.md rename to docs/handoffs/wave-R3-briefs-2026-06-13.md diff --git a/docs/handoff/workbench-catchup-PR2-construction-read-model-brief-2026-06-23.md b/docs/handoffs/workbench-catchup-PR2-construction-read-model-brief-2026-06-23.md similarity index 100% rename from docs/handoff/workbench-catchup-PR2-construction-read-model-brief-2026-06-23.md rename to docs/handoffs/workbench-catchup-PR2-construction-read-model-brief-2026-06-23.md diff --git a/docs/handoff/workbench-catchup-PR3-trace-construction-tab-brief-2026-06-23.md b/docs/handoffs/workbench-catchup-PR3-trace-construction-tab-brief-2026-06-23.md similarity index 100% rename from docs/handoff/workbench-catchup-PR3-trace-construction-tab-brief-2026-06-23.md rename to docs/handoffs/workbench-catchup-PR3-trace-construction-tab-brief-2026-06-23.md diff --git a/docs/handoff/workbench-catchup-PR4-generalization-audits-brief-2026-06-23.md b/docs/handoffs/workbench-catchup-PR4-generalization-audits-brief-2026-06-23.md similarity index 100% rename from docs/handoff/workbench-catchup-PR4-generalization-audits-brief-2026-06-23.md rename to docs/handoffs/workbench-catchup-PR4-generalization-audits-brief-2026-06-23.md diff --git a/docs/handoff/workbench-catchup-PR5-proposal-artifact-demo-brief-2026-06-23.md b/docs/handoffs/workbench-catchup-PR5-proposal-artifact-demo-brief-2026-06-23.md similarity index 100% rename from docs/handoff/workbench-catchup-PR5-proposal-artifact-demo-brief-2026-06-23.md rename to docs/handoffs/workbench-catchup-PR5-proposal-artifact-demo-brief-2026-06-23.md diff --git a/docs/handoff/workbench-truncated-cell-visual-evidence-2026-06-14.md b/docs/handoffs/workbench-truncated-cell-visual-evidence-2026-06-14.md similarity index 100% rename from docs/handoff/workbench-truncated-cell-visual-evidence-2026-06-14.md rename to docs/handoffs/workbench-truncated-cell-visual-evidence-2026-06-14.md diff --git a/docs/issues/README.md b/docs/issues/README.md new file mode 100644 index 00000000..6cc602a1 --- /dev/null +++ b/docs/issues/README.md @@ -0,0 +1,3 @@ +# Detailed Issue Analyses + +This directory contains detailed technical write-ups and reproductions for issues, not issue trackers (which should reside in GitHub Issues). diff --git a/docs/lab/README.md b/docs/lab/README.md new file mode 100644 index 00000000..b143ef38 --- /dev/null +++ b/docs/lab/README.md @@ -0,0 +1,4 @@ +# Lab + +> [!WARNING] +> [experimental] Contents are experimental, not ratified, and must not be referenced as authoritative in production PRs. diff --git a/docs/planning/DEMO-PACKAGING-CHECKLIST.md b/docs/plans/DEMO-PACKAGING-CHECKLIST.md similarity index 100% rename from docs/planning/DEMO-PACKAGING-CHECKLIST.md rename to docs/plans/DEMO-PACKAGING-CHECKLIST.md diff --git a/docs/planning/PUBLIC-DEMO-ROADMAP.md b/docs/plans/PUBLIC-DEMO-ROADMAP.md similarity index 100% rename from docs/planning/PUBLIC-DEMO-ROADMAP.md rename to docs/plans/PUBLIC-DEMO-ROADMAP.md diff --git a/docs/capability_roadmap.md b/docs/plans/capability_roadmap.md similarity index 100% rename from docs/capability_roadmap.md rename to docs/plans/capability_roadmap.md diff --git a/docs/formation_pipeline_plan.md b/docs/plans/formation_pipeline_plan.md similarity index 100% rename from docs/formation_pipeline_plan.md rename to docs/plans/formation_pipeline_plan.md diff --git a/docs/sessions/SESSION-2026-05-13.md b/docs/sessions/2026-05-13.md similarity index 100% rename from docs/sessions/SESSION-2026-05-13.md rename to docs/sessions/2026-05-13.md diff --git a/docs/sessions/SESSION-2026-05-15-capability-gates.md b/docs/sessions/2026-05-15-capability-gates.md similarity index 100% rename from docs/sessions/SESSION-2026-05-15-capability-gates.md rename to docs/sessions/2026-05-15-capability-gates.md diff --git a/docs/sessions/SESSION-2026-05-21-articulation-arc.md b/docs/sessions/2026-05-21-articulation-arc.md similarity index 100% rename from docs/sessions/SESSION-2026-05-21-articulation-arc.md rename to docs/sessions/2026-05-21-articulation-arc.md diff --git a/docs/sessions/SESSION-2026-05-22-contract-layer-arc.md b/docs/sessions/2026-05-22-contract-layer-arc.md similarity index 100% rename from docs/sessions/SESSION-2026-05-22-contract-layer-arc.md rename to docs/sessions/2026-05-22-contract-layer-arc.md diff --git a/docs/sessions/SESSION-2026-05-23-pedagogy-research-and-teaching-loop-pivot.md b/docs/sessions/2026-05-23-pedagogy-research-and-teaching-loop-pivot.md similarity index 100% rename from docs/sessions/SESSION-2026-05-23-pedagogy-research-and-teaching-loop-pivot.md rename to docs/sessions/2026-05-23-pedagogy-research-and-teaching-loop-pivot.md diff --git a/docs/sessions/SESSION-2026-05-26-corridor-closure.md b/docs/sessions/2026-05-26-corridor-closure.md similarity index 100% rename from docs/sessions/SESSION-2026-05-26-corridor-closure.md rename to docs/sessions/2026-05-26-corridor-closure.md diff --git a/docs/sessions/SESSION-2026-05-28-risk-reward-learning-architecture.md b/docs/sessions/2026-05-28-risk-reward-learning-architecture.md similarity index 100% rename from docs/sessions/SESSION-2026-05-28-risk-reward-learning-architecture.md rename to docs/sessions/2026-05-28-risk-reward-learning-architecture.md diff --git a/docs/sessions/SESSION-2026-05-29-comprehension-and-overfitting-discipline.md b/docs/sessions/2026-05-29-comprehension-and-overfitting-discipline.md similarity index 100% rename from docs/sessions/SESSION-2026-05-29-comprehension-and-overfitting-discipline.md rename to docs/sessions/2026-05-29-comprehension-and-overfitting-discipline.md diff --git a/docs/sessions/SESSION-2026-05-29-multistep-build-arc.md b/docs/sessions/2026-05-29-multistep-build-arc.md similarity index 100% rename from docs/sessions/SESSION-2026-05-29-multistep-build-arc.md rename to docs/sessions/2026-05-29-multistep-build-arc.md diff --git a/docs/sessions/SESSION-2026-06-04-deductive-pivot-and-universal-structure.md b/docs/sessions/2026-06-04-deductive-pivot-and-universal-structure.md similarity index 100% rename from docs/sessions/SESSION-2026-06-04-deductive-pivot-and-universal-structure.md rename to docs/sessions/2026-06-04-deductive-pivot-and-universal-structure.md diff --git a/docs/sessions/SESSION-2026-06-19-semantic-substrate-affordance-foundation.md b/docs/sessions/2026-06-19-semantic-substrate-affordance-foundation.md similarity index 100% rename from docs/sessions/SESSION-2026-06-19-semantic-substrate-affordance-foundation.md rename to docs/sessions/2026-06-19-semantic-substrate-affordance-foundation.md diff --git a/docs/sessions/gsm8k-train-proxy-rebaseline-2026-06-20.md b/docs/sessions/2026-06-20-gsm8k-train-proxy-rebaseline.md similarity index 100% rename from docs/sessions/gsm8k-train-proxy-rebaseline-2026-06-20.md rename to docs/sessions/2026-06-20-gsm8k-train-proxy-rebaseline.md diff --git a/docs/sessions/pr846-reconciliation-audit-2026-06-20.md b/docs/sessions/2026-06-20-pr846-reconciliation-audit.md similarity index 100% rename from docs/sessions/pr846-reconciliation-audit-2026-06-20.md rename to docs/sessions/2026-06-20-pr846-reconciliation-audit.md diff --git a/docs/sessions/quantity-entity-foundational-slice-authorization-2026-06-20.md b/docs/sessions/2026-06-20-quantity-entity-foundational-slice-authorization.md similarity index 100% rename from docs/sessions/quantity-entity-foundational-slice-authorization-2026-06-20.md rename to docs/sessions/2026-06-20-quantity-entity-foundational-slice-authorization.md diff --git a/docs/sessions/quantity-entity-implementation-preflight-2026-06-20.md b/docs/sessions/2026-06-20-quantity-entity-implementation-preflight.md similarity index 100% rename from docs/sessions/quantity-entity-implementation-preflight-2026-06-20.md rename to docs/sessions/2026-06-20-quantity-entity-implementation-preflight.md diff --git a/docs/sessions/workbench-proposal-first-alignment-scope-2026-06-20.md b/docs/sessions/2026-06-20-workbench-proposal-first-alignment-scope.md similarity index 100% rename from docs/sessions/workbench-proposal-first-alignment-scope-2026-06-20.md rename to docs/sessions/2026-06-20-workbench-proposal-first-alignment-scope.md diff --git a/docs/sessions/unary-state-change-delta-authorization-2026-06-21.md b/docs/sessions/2026-06-21-unary-state-change-delta-authorization.md similarity index 100% rename from docs/sessions/unary-state-change-delta-authorization-2026-06-21.md rename to docs/sessions/2026-06-21-unary-state-change-delta-authorization.md diff --git a/docs/sessions/unary-state-change-delta-conformance-decision-2026-06-21.md b/docs/sessions/2026-06-21-unary-state-change-delta-conformance-decision.md similarity index 100% rename from docs/sessions/unary-state-change-delta-conformance-decision-2026-06-21.md rename to docs/sessions/2026-06-21-unary-state-change-delta-conformance-decision.md diff --git a/docs/sessions/unary-state-change-delta-preflight-2026-06-21.md b/docs/sessions/2026-06-21-unary-state-change-delta-preflight.md similarity index 100% rename from docs/sessions/unary-state-change-delta-preflight-2026-06-21.md rename to docs/sessions/2026-06-21-unary-state-change-delta-preflight.md diff --git a/docs/sessions/README.md b/docs/sessions/README.md new file mode 100644 index 00000000..e744f969 --- /dev/null +++ b/docs/sessions/README.md @@ -0,0 +1,25 @@ +# Session Logs + +Chronological index of session logs. + +- [2026-05-13.md](2026-05-13.md) +- [2026-05-15-capability-gates.md](2026-05-15-capability-gates.md) +- [2026-05-21-articulation-arc.md](2026-05-21-articulation-arc.md) +- [2026-05-22-contract-layer-arc.md](2026-05-22-contract-layer-arc.md) +- [2026-05-23-pedagogy-research-and-teaching-loop-pivot.md](2026-05-23-pedagogy-research-and-teaching-loop-pivot.md) +- [2026-05-26-corridor-closure.md](2026-05-26-corridor-closure.md) +- [2026-05-28-risk-reward-learning-architecture.md](2026-05-28-risk-reward-learning-architecture.md) +- [2026-05-29-comprehension-and-overfitting-discipline.md](2026-05-29-comprehension-and-overfitting-discipline.md) +- [2026-05-29-multistep-build-arc.md](2026-05-29-multistep-build-arc.md) +- [2026-06-04-deductive-pivot-and-universal-structure.md](2026-06-04-deductive-pivot-and-universal-structure.md) +- [2026-06-08-epistemic-question-articulation-first-skill-of-contemplation.md](2026-06-08-epistemic-question-articulation-first-skill-of-contemplation.md) +- [2026-06-08-practice-attempts-and-servability-blade.md](2026-06-08-practice-attempts-and-servability-blade.md) +- [2026-06-19-semantic-substrate-affordance-foundation.md](2026-06-19-semantic-substrate-affordance-foundation.md) +- [2026-06-20-gsm8k-train-proxy-rebaseline.md](2026-06-20-gsm8k-train-proxy-rebaseline.md) +- [2026-06-20-pr846-reconciliation-audit.md](2026-06-20-pr846-reconciliation-audit.md) +- [2026-06-20-quantity-entity-foundational-slice-authorization.md](2026-06-20-quantity-entity-foundational-slice-authorization.md) +- [2026-06-20-quantity-entity-implementation-preflight.md](2026-06-20-quantity-entity-implementation-preflight.md) +- [2026-06-20-workbench-proposal-first-alignment-scope.md](2026-06-20-workbench-proposal-first-alignment-scope.md) +- [2026-06-21-unary-state-change-delta-authorization.md](2026-06-21-unary-state-change-delta-authorization.md) +- [2026-06-21-unary-state-change-delta-conformance-decision.md](2026-06-21-unary-state-change-delta-conformance-decision.md) +- [2026-06-21-unary-state-change-delta-preflight.md](2026-06-21-unary-state-change-delta-preflight.md) diff --git a/docs/runtime_contracts.md b/docs/specs/runtime_contracts.md similarity index 100% rename from docs/runtime_contracts.md rename to docs/specs/runtime_contracts.md