Skip to content

docs: Session Dashboard PRD, ADR 0006, and glossary terms#110

Merged
ThomasK33 merged 1 commit into
mainfrom
docs/session-dashboard
Jun 2, 2026
Merged

docs: Session Dashboard PRD, ADR 0006, and glossary terms#110
ThomasK33 merged 1 commit into
mainfrom
docs/session-dashboard

Conversation

@ThomasK33
Copy link
Copy Markdown
Member

What

Lands the planning docs for the read-only Session Dashboard feature (agent-tty dashboard) — a human-facing TUI to watch what agents are doing in their shells. Docs only; no production code.

  • CONTEXT.md — new glossary terms Session Dashboard, Live View, Event Log Follow (+ relationships) and the "agent" flagged-ambiguity note (the domain stays agent-neutral; "agent" is product copy only).
  • ADR 0006 — the Session Dashboard follows the Event Log rather than the live host; file-tail transport for v1 behind a seam so a future streaming subscribe RPC can replace it without UI changes; libghostty-vt backend.
  • docs/prd/session-dashboard/PRD.md — the v1 PRD (problem, solution, user stories, implementation/testing decisions, out of scope).

Why

Shaped via the usual flow: deep research → throwaway prototype → grilling (CONTEXT.md/ADR) → PRD. The prototype validated the approach (file-tail → libghostty-vt reconstruction, byte-identical to snapshot including alt-screen apps, ~2.3 ms p95 frame work at 30 fps).

Scope

Docs only. Implementation is tracked in #109 (labeled ready-for-human).

Refs #109

🤖 Generated with Claude Code

Shape the read-only Session Dashboard feature ahead of implementation:
- CONTEXT.md: add Session Dashboard, Live View, and Event Log Follow
  terms, their relationships, and the agent-overload ambiguity note
- ADR 0006: Session Dashboard follows the Event Log rather than the live
  host (file-tail v1 behind a subscribe-RPC seam; libghostty-vt backend)
- docs/prd/session-dashboard/PRD.md: the v1 PRD

Refs #109

Change-Id: Id2eea299fb77f753370778ca9d3d3cabaf01c588
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Thomas Kosiewski <tk@coder.com>
@ThomasK33 ThomasK33 force-pushed the docs/session-dashboard branch from 3310a20 to 14c785d Compare June 2, 2026 18:02
@ThomasK33 ThomasK33 merged commit d183cf6 into main Jun 2, 2026
11 checks passed
@ThomasK33 ThomasK33 deleted the docs/session-dashboard branch June 2, 2026 18:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant