Skip to main content

Spec And Plan

The docs site is the reader-friendly entry point, but the current source documents for the project still live in the repository root and remain authoritative.

Specification

The language specification is indexed from SPEC.md and split across the spec/ directory.

Recommended starting points:

  • spec/00-status.md
  • spec/01-overview.md
  • spec/05-type-model.md
  • spec/06-syntax-draft.md
  • spec/12-external-services-and-fetch-nodes.md

Plan

The implementation plan is indexed from PLAN.md and split across the plan/ directory.

Recommended starting points:

  • plan/overview.md
  • plan/architecture.md
  • plan/roadmap.md
  • plan/testing.md

Current State

  • the spec is modularized and serves as the source of truth
  • the bootstrap compiler is implemented in TypeScript
  • the current implementation plan tracks Phases 0 through 5 as complete
  • the docs site is being introduced now as the initial long-term documentation surface

Practical Reading Order

For language shape:

  1. SPEC.md
  2. spec/00-status.md
  3. spec/01-overview.md
  4. spec/05-type-model.md
  5. spec/06-syntax-draft.md

For compiler implementation direction:

  1. PLAN.md
  2. plan/overview.md
  3. plan/architecture.md
  4. plan/roadmap.md