Internal notes¶

Maintainer material, not user docs

The pages linked below are maintainer notes and design history kept in the repository but intentionally left out of the public navigation. They are aimed at contributors, may be incomplete, and can be outdated. Treat them as background, not as authoritative user documentation.

Agent and domain guidance¶

The authoritative guide for working in this codebase (human or AI) is AGENTS.md at the repository root. Deep, per-domain references live in the skill files under .agents/skills/ (Moodle internals, WP Playground & php-wasm, WASM & browser runtime, blueprint provisioning, unit testing, and E2E testing).

Architecture Decision Records¶

Significant technical decisions are recorded as ADRs in docs/decisions/ (0001 through 0016). Each ADR captures the context, options considered, rationale, and consequences of a decision — read them before changing the request pipeline, the storage model, the build, or blueprint semantics.

Design history and deep dives¶

SQLite + php-wasm migration notes — how Moodle runs against the experimental SQLite PDO driver in WASM, and the invariants to preserve.
Moodle WASM plan — original plan for running Moodle in the browser.
Implementation status — progress snapshot of the WASM port.
Plugin install notes — notes on the plugin/theme installation path.
PHP process manager evaluation — research on rotatePHPRuntime and process management options.

Troubleshooting and known issues¶

Troubleshooting — developer-oriented debugging guide.
Known issues — current limitations and open problems.

For user-facing setup and tasks, start from the Home page and the Contributing guide.