Skip to content

Engine Separation

Source: Captainswords.app/docs/adr/ADR-001-learning-engine-isolation.md · docs/adr/ADR-005-numbers-engine-isolation.md


Learning engine (Words)

Location: /lib/learning-engine

Must not import React, Phaser, or Supabase. Plain JSON in/out so it stays testable and portable.

Numbers engine

Location: /lib/numbers-engine + /lib/numbers-data

Isolated from Words learning engine. Separate database (ADR-006). Shared platform identity only where explicitly decided (ADR-007).

Captain Engine

Orchestrates scene specs and reactions — does not replace learning validation or persistence.

Rule

Educational logic lives in engines, not in renderers or Phaser scenes alone.