core/docs
Claude e6a3038335
docs(assessment,governance): record the adopted docket and the standing philosophy
Shay adopted twelve rulings, struck two, and ratified the ADR-0252 §5 NO-GO.
For several hours afterwards the packet still said PENDING fourteen times,
while PR-3 and PR-3b had already executed against R-7. That is precisely the
failure this arc is about — a record contradicting reality at a load-bearing
point — committed inside the arc whose subject is that failure, and it was
caught by a question rather than by any instrument. Fixing it is the first
item here; the rest of the commit exists so the same gap cannot reopen by
context loss.

50-rulings.md
  All fourteen statuses replaced. Twelve carry RULED <choice> with the date
  and the deciding authority; R-10 (discharged before the arc) and R-14
  (dissolved by N-9) are struck. An adoption block at the head records the
  choices, the strikes, the §5 ratification, and the corrected execution
  order, plus which rulings have already executed.

50-execution-plan.md
  New §2.1 — the adopted docket. The twelve choices, and the execution order
  as a ranked table stating why each item sits where it does. The packet
  ordered by register number, which interleaves cheap record repairs with
  expensive capability work and puts the two zero-risk ADR amendments last;
  the corrected order is by what each item unblocks, cheapest first in tier.

  Three things that lived only in conversation are now written down:
  - the claims register is HELD, deliberately, with its entry criterion —
    G-22 showed CLAIMS.md can publish a superseded digest for two days, and
    an index over untrustworthy indexed things is the H-9 pattern;
  - gate width is promoted from a parenthetical to PR-4b, sized, with
    `teaching` recommended alone and the reason being evidence (G-22) rather
    than taste — a parenthetical is how fifteen suites became unreachable
    without anyone choosing it;
  - Track A's ratification creates an obligation the verdict document cannot
    discharge: ADR-0252 §6 retires the surface organs "until the
    structure-mapper proves out," names no replacement for the NO-GO branch,
    and is an instruction rather than a research note. A live instruction
    that can never fire is a dead instrument.

  Two places where I was about to state a ruling more strongly than it was
  made, corrected rather than smoothed over:
  - R-11 B is "measure, then re-ask." It authorizes no gate. It owes a
    measurement AND a second ruling, and a ruled-but-inert item looks exactly
    like a settled one at a glance.
  - R-8 C was recommended "with a floor from A applied to the entailed
    capability only" and N was never named. PR-14 must carry a proposed N with
    its consequence, or land entailed as explicitly unlicensable-pending-N.
    Shipping without a floor would license entailment on nine cases through an
    omission — the exact outcome C exists to prevent.

  Also: §0 corrected from seven corrections to nine (N-8, N-9 were added
  during execution and the heading never moved); definition-of-done item 5
  struck, because N-9 killed both its halves — smoke.yml parity is not a goal
  under AGENTS.md:280, and "no test file hides in full" is unreachable at 747
  files without ceremony that changes nothing about what executes.

30-gap-register.md
  G-7's open half is 15, not 19: PR-3b took it there by deletion, which costs
  no gate time. Points at PR-4b.

AGENTS.md
  Nine standing philosophies under the reasoning protocol, per CLAUDE.md's
  rule that governance and memory live here. They are the generalization of
  what this arc actually cost: less is more; master the small details and the
  large ones do not form; a mechanism whose failure state is indistinguishable
  from its success state is not a guarantee; a record that contradicts nothing
  beats one that impresses; consecutive unclear problems mean the frame is
  wrong, not the fix; be quick to investigate yourself, and record the error
  next to the fix rather than overwriting it; volume of work is not a licence
  for lower diligence; fix what you find or name why not; let the tree settle,
  then run the gate once.

Documentation only — no runtime behavior, no test, no pin changes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Wcw2pnMBwyvmNyQg4uPEt4
2026-07-28 05:57:11 +00:00
..
adr docs(adr): ratify ADR-0265 — Accepted, Joshua Shay 2026-07-27 2026-07-27 13:17:57 -07:00
agents/grok
analysis feat(coherence): grounded-open hedge arm — serve pack surfaces honestly hedged instead of over-refusing (ADR-0254) 2026-07-23 01:27:17 -07:00
architecture docs: apply the Wave 0 record amendments that need no ruling (N-1…N-7, H-12) 2026-07-27 17:38:12 -07:00
assessment docs(assessment,governance): record the adopted docket and the standing philosophy 2026-07-28 05:57:11 +00:00
audit feat(wave-1): retire the dead instruments, delete the aliases nobody calls (PR-3, PR-3b, R-7) 2026-07-28 05:40:45 +00:00
benchmarks
briefs docs(governance): weekly-audit rulings T1/T7/T8/T9 — INV-32/33/34 registration, ADR-0243 fold, residual escalation, path sweep, prune ledger 2026-07-22 19:18:59 -07:00
curriculum
decisions
evals
examples
handoff docs(arc): reconcile the arc's records with what the units measured 2026-07-26 12:33:30 -07:00
handoffs docs(paradigm): retire six competing unratified problem-solving paradigms under ADR-0252 2026-07-19 14:46:47 -07:00
implementation docs(paradigm): retire six competing unratified problem-solving paradigms under ADR-0252 2026-07-19 14:46:47 -07:00
issues fix(tests): session-scoped engine-state isolation baseline — close module-scope escape to the live life-store 2026-07-22 20:32:06 -07:00
lab
outreach
paradigm-archive docs(paradigm): retire six competing unratified problem-solving paradigms under ADR-0252 2026-07-19 14:46:47 -07:00
plans feat(evals): measure the reader/writer construction inventories against each other 2026-07-27 14:11:07 -07:00
research docs(assessment): re-anchor the §5 provenance SHAs to the commits that landed 2026-07-28 03:00:46 +00:00
sessions
specs docs(specs): the M2 trust-boundary table — measured, and three boundaries CLOSED (PR-7, H-7) 2026-07-28 04:30:00 +00:00
workbench docs(governance): weekly-audit rulings T1/T7/T8/T9 — INV-32/33/34 registration, ADR-0243 fold, residual escalation, path sweep, prune ledger 2026-07-22 19:18:59 -07:00
zig
3lang-depth-pr-plan.md
admissibility-exemplars.md
ci-optimization.md
conceptualizing_engineering_mastery.md docs(assessment): Phase 0 — ground truth, corpus triage, and the Phase 1 handoff 2026-07-27 15:19:54 -07:00
core-rd-base-prompts.md
ethics_packs.md
EVAL_AUDIT_2026-05-20.md
eval_methodology.md
frontier_baselines.md
gaps.md feat(wave-1): retire the dead instruments, delete the aliases nobody calls (PR-3, PR-3b, R-7) 2026-07-28 05:40:45 +00:00
handoff_template.md
hitl-backpressure.md
holdout_recipients.txt
identity_packs.md
master-plan-post-substrate-audit.md
memo.html
model_dependency_size_tally.md
pack_inventory_2026-05-21.md
position_paper.md
PROGRESS.md
README.md
recognizer-registry.md
refusal-taxonomy.md
reviewers.yaml
RUST.md
safety_packs.md
sponsors.md
teaching_order.md
test-debt-quarantine.md
testing-lanes.md
Whitepaper.md
Yellowpaper.md

CORE Documentation Index

This is the central index for all documentation in the CORE project.

Canonical Root Documents

Directories

Architecture & Design

  • adr/ - Architecture Decision Records (ADRs). The canonical history of all ratified engineering choices.
  • architecture/ - High-level architectural documents (e.g., pipelines, schemas).
  • analysis/ - Deep dives and master plans for structural changes.
  • specs/ - Detailed technical specifications and invariants.

Planning & Progress

  • plans/ - Capability roadmaps and implementation plans.
  • briefs/ - Project briefs and scoping documents for upcoming work.
  • issues/ - Detailed issue analyses and technical reproductions (not standard trackers).
  • audit/ - Audit reports and claims ledgers.

Operations & Usage

  • examples/ - Usage examples and reference integrations.
  • workbench/ - Documentation for the CORE workbench UI and related tooling.
  • agents/ - Agent-specific operational guides.

    Note regarding agents/grok/: Operational guide for using Grok 4.3 + Grok Build with CORE. This is not architecture documentation.

Learning & Evaluation

  • curriculum/ - Documentation on the teaching/learning order and knowledge progression.
  • evals/ - Evaluation methodology and performance criteria documentation.
  • benchmarks/ - Benchmark evidence and performance tracking logs.

Historical & Experimental

  • sessions/ - Chronological session logs documenting the "decision trail" and intellectual history of major choices.
  • handoffs/ - Legacy brief, audit, and investigation notes (historical; the formal HANDOFF mechanism is retired — see AGENTS.md for the current lightweight session-break-summary-<DATETIME>.md convention).
  • research/ - Raw research notes and preliminary findings.
  • lab/ - Experimental content (Warning: Not ratified; must not be referenced as authoritative in production PRs).

External

  • outreach/ - External communications and messaging.
  • zig/ - Scoped documentation for the Zig language components.