Canonical project documents
The portal is an entry point, not a replacement for the repository’s source of truth. Use this map when you need the full contract or historical context.
| Document | Use it for |
|---|---|
README.md |
Public/researcher-first orientation. |
SPEC.md |
Completed, active, and planned technical specifications. |
ARCHITECTURE.md |
Component boundaries, data flow, invariants, and external interfaces. |
ROADMAP.md |
Milestones, ordering, outputs, and exit criteria. |
CHANGELOG.md |
User-visible implementation history. |
LESSONS.md |
Verified recurring setup and debugging lessons. |
docs/goal.md |
Active agent/contributor goal prompt (source-only). |
AGENTS.md |
Repository-wide instructions for contributors and agents. |
| Documentation maintenance | Editorial contract, claim anchors, URL map, publication rules. |
Phase records (source-only; not Jekyll-published)
| Path | Status (see ROADMAP) |
|---|---|
docs/phase0/ |
Complete — feasibility, cohort/fields, evidence inventory |
docs/phase1/ |
Complete — synthesizer contract and capability report |
docs/phase2/ |
Complete — Evidence IR |
docs/phase3/ |
Complete — evidence corpus freeze |
docs/phase4/ |
Complete — calibration engine |
docs/phase5/ |
Complete — MVP calibrated multi-world family |
| Phase 6 | Active — independent evaluation; correctness hardening gates affirmative release claims |
| Phase 7A–7F | Planned — correctness, inferential IR, joint synthesis, continual calibration, base/world separation, scaling (see ROADMAP) |
Implementation walkthrough for the MVP worlds: Calibrated worlds.
Realignment and planned direction
The November 8 audit
is planning input, not a test or evaluation report. The canonical documents
adopt a planned shared, versioned Medicare-like population model whose outputs
are reproducible datasets and derived research worlds. The current product
remains the limited MVP; adjusted inferential calibration and general continual
model updates are not available yet. See SPEC.md and ROADMAP.md for audit
caveats, the bounded joint + adjusted-logistic experiment and acceptance gates.
Historical proposals
| Document | Role |
|---|---|
| Evidence-calibrated playground proposal | November 6 design history; November 8 canonical realignment supersedes conflicting strategy/ordering |
| Original project proposal | Earlier product motivation |
| Documentation reorganization plan | IA plan for this researcher-first docs site |
Older proposals preserve decisions and motivation; they are not current behavior when code or newer canonical documents disagree.
Evidence and source records
Source manifests and RKB evidence snapshots live under data/ and are tracked
without raw CMS data. The export and release guide
explains how to acquire, verify, normalize, and export a bounded slice.