core/docs
Shay 4c342cdc02 docs(assessment): Phase 4 — the gap register and the hindrance audit
30-gap-register.md — CORE's first LIVE gap register since docs/gaps.md
closed its 26th entry (supersession proposed for ruling). 20 entries in
four tiers, each with evidence, deciding authority, and leverage rank:

- Tier A (frontier-blocking): G-1 the unrun ADR-0252 §5 experiment
  (leverage 1 — authorized, scaffolded, verdict-less; the paradigm governs
  ALL future comprehension); G-2 the #138 fabrications (pre-labeled
  measured-and-pinned, held for ADR + ratification); G-3 reader 19 vs
  writer 1739; G-4 CR-2 no-chooser (the AGI-grade conceptual absence);
  G-5 L10 proof debt (no artifact, no suite, no cadence); G-6 the
  half-gated lived learning loop.
- Tier B (enforcement debt): G-7 orphaned-pin meta-check (the highest-
  leverage single mechanical change); G-8 flag-default register; G-9 three
  doctrine laws without verified failing pins; G-10 curriculum scoping +
  absent ledger; G-11 identity authorization bar unstated.
- Tier C (one-line rulings): CR-3 efferent, CR-4 temporal stance, CR-1
  attention ADR, the daemon's owning ADR.
- Tier D (latent/carried): aspect-arm defect class (generate/templates.py
  :79, unreachable today), sensorium entry criterion, curriculum-formation
  bypass (unverified carry), Wilson evidence debt, refusal materialisation.
- Plus what is NOT in the register and why (deferred-with-ruling is the
  scripture model; benchmarks excluded by the completeness criterion).

31-hindrance-audit.md — 11 entries ranked by leverage, each with fitness
verdict, evidence, proposed better home, deciding authority; decides
nothing. Headliners: H-1 Wilson/replay counting basis (wrong-solution in
the counting, not the gating — 21/25 bands short; the re-count may demote
licenses and that is the mechanism working); H-2 decoration as testimony
(DriveGradientMap, InhibitionMask — deletion per mastery step 2); H-3 the
typed refusal discarded at the public boundary; H-4 extend the resolver's
declared-precedence pattern upstream; H-8 three record/code contradictions
(each one paragraph to fix); H-9 dead instruments standing as if live.
Plus five examined-and-CLEARED candidates (the 18 organs' continued
service is governance working; pure-Python-by-default is measured-correct;
flag-gated conservatism is not hindrance — unregistered darkness is).
2026-07-27 16:04:22 -07:00
..
adr docs(adr): ratify ADR-0265 — Accepted, Joshua Shay 2026-07-27 2026-07-27 13:17:57 -07:00
agents/grok
analysis
architecture
assessment docs(assessment): Phase 4 — the gap register and the hindrance audit 2026-07-27 16:04:22 -07:00
audit
benchmarks
briefs
curriculum
decisions
evals chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
examples
handoff docs(arc): reconcile the arc's records with what the units measured 2026-07-26 12:33:30 -07:00
handoffs
implementation
issues
lab
outreach
paradigm-archive
plans fix(generate): a proposition graph must be able to represent denial (ADR-0265) 2026-07-27 13:08:17 -07:00
research Merge pull request 'Rust parity: cargo green, lane parity unfalsifiable — plus core rust build was broken (plan §6A)' (#124) from fix/rust-build-env-and-parity-report into main 2026-07-26 20:20:16 +00:00
sessions
specs fix(runtime): defer the turn-event sink emission to the serve boundary (R7) 2026-07-26 10:56:03 -07:00
workbench
zig chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
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
handoff_template.md
hitl-backpressure.md
holdout_recipients.txt
identity_packs.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
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 chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
test-debt-quarantine.md
testing-lanes.md
Whitepaper.md chore: Refactor CLI and Governance Anchors (#926) 2026-07-03 12:34:56 -07:00
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.