agent-orchestrator/docs
Dhruv Sharma 86f3f0880c
docs: document AO technical stack (#25)
* docs: document AO technical stack

* docs: update stack decisions from review
2026-06-04 02:24:19 +05:30
..
agent Add agent adapters and wire per-session agents into the session manager (#65) 2026-06-02 16:51:32 +05:30
cli refactor: simplify session lifecycle and zellij runtime (#62) 2026-06-01 08:42:49 +05:30
README.md docs: document AO technical stack (#25) 2026-06-04 02:24:19 +05:30
architecture.md refactor: move session status assembly to service (#62) (#67) 2026-06-01 23:31:21 +05:30
stack.md docs: document AO technical stack (#25) 2026-06-04 02:24:19 +05:30
status.md refactor: move session status assembly to service (#62) (#67) 2026-06-01 23:31:21 +05:30

README.md

agent-orchestrator rewrite docs

The agent-orchestrator is being rebuilt as a long-running Go backend daemon
(backend/) plus an Electron + TypeScript frontend (frontend/). The backend
supervises coding-agent sessions and exposes daemon control, project/session
state, terminal streaming, and CDC/event infrastructure.

Start with architecture.md for the current backend model and
cli/README.md for the CLI surface.

Reference docs

Doc What it covers
architecture.md Current backend model, package layout, status derivation, persistence/CDC, and load-bearing rules.
cli/README.md CLI commands and daemon control surface.
status.md Current implementation shape, build/test command, and next integration work.
stack.md Accepted library/runtime choices, pending stack decisions, and dependencies explicitly avoided for V1.

Mental model

Persist durable facts, derive display status:

  • session table: activity_state, is_terminated, identity, metadata
  • PR tables: PR/CI/review facts
  • derived read model: service.Session computes display status from session + PR facts