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