Restore the project launcher, creation wizard and loading shield with UI2 components. Coordinate real opening phases, a one-second minimum, pending session cleanup and per-project window geometry while retaining the Play slice. Keep global presentation controls in the project window, make the launcher frame resize with its window and prevent root run from chaining the foundation demo after the product exits. Update desktop/installed probes and documentation. Register the existing native bundle after capacity qualification, without changing native binaries or bypassing the execution guard. Validated with unit, desktop, native Play, headless, save, MCP and installed connector gates. Human-tested and accepted under WRK-0018.
Specification Guide
Specifications live under this tree and are organized by contract owner:
| Owner | Canonical corpus | Responsibility |
|---|---|---|
compiler/general |
General compiler | Shared compilation, linking, typed handoff, emission and acceptance |
compiler/pbs |
PBS language | PBS source, semantics, SDK and frontend projections |
packer |
Packer | Assets, artifacts, packing and diagnostics |
studio |
Studio | Shell, workspaces, adapters and visual/automation integration |
New compiler languages receive their own corpus under compiler-languages/.
Shared compiler policy stays in compiler/; PBS is not the root for other domains.
Each domain README provides a chapter index and reading order. Numbered chapters are normative within their stated scope. Feature chapters own their detailed contracts; cross-cutting chapters reference those rules rather than maintaining competing versions. Write specifications and durable lessons in English.
The runtime repository owns PBX, ISA, admission and VM execution. Studio's VM architecture references and catalog mirrors retain their separate provenance and synchronization policy. Roadmaps describe cross-domain planning, not an alternative contract source.
Engineering discussions, decisions, plans and execution evidence are maintained
in the enclosing workspace's AI Engineering project.
Published lessons and supporting assets remain in discussion/lessons/.
See repository instructions.
Navigation verification
Run ../tooling/.venv/bin/python ../tooling/scripts/documentation/verify.py --root .
from the Studio repository root to check local
links and anchors. Pass --runtime ../runtime to also check provider references
against an available read-only runtime checkout. The byte-exact architecture/ISA
mirrors retain the link context of their runtime originals; the checker resolves
them there. Ordinary builds and installed documentation reads do not require that
checkout.