# docs/ index

`docs/` has accumulated many per-session records.  This index points to
the **load-bearing** documents; everything else is history (useful for
bisecting *why* a decision was made, not for reading end-to-end).

## Start here

- **`STATUS.md`** — current state, architecture, what remains.
- **`plan.md`** — the phased plan (Blaise-adapted).
- **`features.md`** — the feature list.
- **`analysis_gaps.md`** — language gaps + corpus notes.

## Designs / running records

- `analysis_generics.md` — generics (chosen ISO 10514-2 form, mechanism,
  increments).
- `plan-two-phase.md`, `plan-two-phase-parse.md` — the AST/`Lower` split
  and the two-phase (deferred-body) parse.
- `plan-resolve-check.md` — the resolve/check thread (now concluded; the
  pass was deleted).
- `plan-lower.md` — the `Lower` emitter.
- `blaise-phases-map.md`, `language-report.md`, `grammar.md` — the
  grammar/phases reference.

## Recent session summaries (newest first)

- `summary_dlist-showcase-2026-10-16.md` — showcase23 + limitation fixes.
- `summary_generics-limitations-fixed-2026-10-16.md` — the two
  template/proc-param limitations, fixed.
- `summary_showcase23-dlist-2026-10-16.md` — the DList showcase + the
  global-record data-size bug.
- `summary_generics-closed-2026-10-16.md` — generics: what works, what
  does not (generic classes: via generic modules; dedup: N/A).
- `summary_generics-inc3-2026-10-16.md` — value params, kind
  constraints, proc params, constraint model.
- `summary_two-phase-complete-2026-10-16.md` — two-phase complete,
  `Check` removed.

Everything else (`summary_stepN.md`, `summary_two-phase-sliceN.md`,
`summary_<topic>.md`, `session-*.md`, `session-handoff-*.md`) is a
chronological record kept for provenance.