core/docs
Shay 54e6bfc0d0
docs: reorganize docs landscape
Implements the 4-phase documentation reorganization master plan.

- Consolidation: Merged brief/, handoff/, planning/, and decisions/ into briefs/, handoffs/, plans/, and adr/ respectively (101 ADRs relocated)
- Root Cleanup: Relocated HANDOFF-gpt55-*.md and key top-level docs (runtime_contracts.md, etc.) to canonical folders. Added superseded alerts.
- Indices & Navigation: Created docs/README.md navigation document, docs/sessions/README.md index, docs/adr/README.md index
- Note: Also includes prior commit adding ADR-0200+ corpus hygiene governance (ADR-0225, dependency map, backfilled cross-references)
2026-06-30 16:59:36 -07:00
..
adr docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
agents/grok docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
analysis docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
architecture docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
audit docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
benchmarks feat(bench): add MLX exact CGA recall experiment (#909) 2026-06-24 13:53:50 -07:00
briefs docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
curriculum
evals
examples
handoffs docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
implementation
issues docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
lab docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
outreach feat(bench): add Apple UMA demo package builder (#913) 2026-06-24 15:51:45 -07:00
plans docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
research
sessions docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
specs docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
workbench feat(workbench-ui): add Apple UMA report card route (#912) 2026-06-24 15:33:42 -07:00
zig
admissibility-exemplars.md
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
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 docs: reorganize docs landscape 2026-06-30 16:59:36 -07:00
recognizer-registry.md
refusal-taxonomy.md
reviewers.yaml
RUST.md
safety_packs.md
sponsors.md docs: remove unestablished NSF SBIR and DARPA claims from Path B 2026-06-25 14:36:12 -07:00
teaching_order.md
test-debt-quarantine.md
testing-lanes.md
Whitepaper.md docs: rename CORE-Sopher to CORE-PersonaMotor in Whitepaper §XIV 2026-06-24 20:30:39 -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/ - Handoff documents transferred between agent sessions.
  • 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.