diff --git a/docs/adr/0006-optional-ai-execution.md b/docs/adr/0006-optional-ai-execution.md index b254c356..38230799 100644 --- a/docs/adr/0006-optional-ai-execution.md +++ b/docs/adr/0006-optional-ai-execution.md @@ -3,6 +3,8 @@ Date: 2026-10-12 | Proposal updated: 2026-10-13 Status: Proposed; no product implementation authorization Amended by: [ADR 0009](0009-in-container-ai-agents.md) (in-container agents, wave one) +Superseded in part by: [ADR 0011](0011-readonly-spec-dashboard.md), for the first +increment only (read-only Spec Kit view) ## Context diff --git a/docs/adr/0011-readonly-spec-dashboard.md b/docs/adr/0011-readonly-spec-dashboard.md new file mode 100644 index 00000000..965d178c --- /dev/null +++ b/docs/adr/0011-readonly-spec-dashboard.md @@ -0,0 +1,49 @@ +# 0011: Read-only Spec Kit dashboard + +Date: 2026-10-13 +Status: Proposed; nothing is implemented +Supersedes in part: the first increment of +[ADR 0006](0006-optional-ai-execution.md#read-only-spec-kit-view-first) + +## Context + +ADR 0006 proposed an optional execution board whose first increment was a read-only +Spec Kit view. The owner decided (H8:a, H17:a) that the dashboard is itself the +read-only view and that it replaces that first increment. This ADR records the +dashboard decision only. It creates no approved product scope, task or +implementation, and does not change the constitution. + +## Decision + +- The dashboard is a read-only view over Spec Kit artifacts (specs, plans, tasks), + review evidence and workspace/agent status. +- The Phoenix control plane serves one owner-authenticated API over TLS, shared by + the CLI and the dashboard. The dashboard is a LiveView page of that API and the + CLI is a client of it. "Local" means owner-scoped, not loopback. Neither + surface owns state the other cannot see; the dashboard adds no separate data + path. +- Git stays authoritative for specifications. The dashboard shows a derived view + and evidence references, never a second editable copy. Unavailable or unknown + sources are shown as unavailable or stale, not inferred. +- Console access is intended as a reattachable workspace session (H18:a), using + the existing workspace terminal model rather than a dashboard-specific channel. + Details are left to the feature spec. + +## Non-goals + +- No editing of specs, plans, tasks or other artifacts. +- No task dispatch, approval, scheduling or retry from the dashboard. +- No guarded command buttons; any later control needs a new decision. +- No assumed Symphony adapter, tracker integration or Spec Kit command execution. + +## Relation to ADR 0006 + +ADR 0006 remains Proposed. Only its first increment (the read-only Spec Kit view) +is superseded by this ADR. Its later execution-board direction, integration +boundary and approval gates are unchanged and still unapproved. + +## Consequences + +Documentation only. API shape, authentication, parser capability and resource cost +are unmeasured design work for a later feature spec. Product reads still require +owner approval under the governance gates before any implementation. diff --git a/docs/index.md b/docs/index.md index 8a725414..22a8b7d5 100644 --- a/docs/index.md +++ b/docs/index.md @@ -26,6 +26,7 @@ - [Explicit CI acceptance (proposed)](adr/0007-explicit-ci-acceptance.md) - [In-container AI agents, wave one (proposed)](adr/0009-in-container-ai-agents.md) - [Go product code and whr CLI layout (proposed)](adr/0010-go-whr-cli-layout.md) +- [Read-only Spec Kit dashboard (proposed)](adr/0011-readonly-spec-dashboard.md) - [Persistent workspace console (proposed)](adr/0012-persistent-workspace-console.md) ## Background and references