Skip to content

Technical docs

Full-detail reference for engineers working in this repo. For the non-technical version, see ../plain/README.md. Both tracks are required to stay in sync — see ../README.md for the index of both.

  • ARCHITECTURE.md — containers and data flow, the key "dispatch by repo name" request-path sequence, the SignalR live-update path, the responsive-layout decision logic, the write-surface auth model, the session-tree/repo-registry/artifact-run/availability features, the solution layout, and every CI gate. Start here.
  • getting-started.md — prerequisites, running the backend/frontend locally, tests, client regeneration, running CI checks locally, diagram regeneration, building the IDE extensions.
  • contributing.md — branch/worktree conventions, scope-discipline norms, contract-freezing rules, and the pre-PR checklist.
  • references.md — every library, framework, and API this repo depends on (with links to source and docs), plus "learn more" reading on the architectural patterns in play.
  • making-of.md — LIVING build journal, checked against git log/git show/the repo's own build reports as it grows.