From fbafcce9194ec6abf1126456f0786046f2fad300 Mon Sep 17 00:00:00 2001
From: Smokey <150986568+jacisjake@users.noreply.github.com>
Date: Tue, 27 Oct 2026 23:13:50 -0600
Subject: [PATCH] docs: SCOPE.md for the chatroom pivot (epic root citation)

---
 docs/SCOPE.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 docs/SCOPE.md

diff --git a/docs/SCOPE.md b/docs/SCOPE.md
new file mode 100644
index 0000000..42faa0d
--- /dev/null
+++ b/docs/SCOPE.md
@@ -0,0 +1,35 @@
+# Scope: Crows Chatroom Pivot
+
+Goal citation for every epic. Source docs: `CHATROOM_SPEC.md` (design), `GROKBOT_NOTES.md` (evidence), `JEV_STRATEGIES.md` (classifier capabilities), `CLAUDE.md` (founding rules, section 8 = roadmap order).
+
+## Goal
+
+Turn So Many Crows from a fixed triage pipeline (Sentry -> crows -> Elder) into a conversation-driven chatroom: crows claim work in a nest, two new roles (assistant crow, Chief of Staff crow) orchestrate, and Jev audits expectations and nudges stalled work. The owner approves by trust level plus explicit `ask_owner` decisions.
+
+## Non-goals (this round)
+
+- Native apps, login/real identity, hosting (GCP), web-search or any new capability.
+- Replacing the working pipeline app until the chatroom demonstrably covers it.
+- Copying Grok Bot: the spec is clean-room, built from black-box observations only.
+
+## Constraints (hard)
+
+- Go backend, standard library only; Vite + TypeScript front end, no framework.
+- Guardrails before capability, always. Every model call goes through `Flock.ask`/`Flock.classify`.
+- Contracts first: `EVENTS.md` changes before server or UI code for any message kind or event.
+- Approvals fail safe; Jev never blocks work; nudges count against the nest exchange budget (loop guard).
+- Art direction is fixed (CLAUDE.md section 3): pen and ink on cream, no box outlines, Smokey's crow art untouched.
+- UI renders text via `textContent` only; test at ~400px and desktop widths.
+
+## Delivery slices
+
+| Slice | Contents | Spec reference |
+|---|---|---|
+| S1 Contracts + Jev foundation | message kinds in `EVENTS.md`; Jev probes; `mode` escape option | CHATROOM_SPEC 4, JEV_STRATEGIES 1-4 |
+| S2 The nest conversation loop | `say`/`request`/`claim`/`deliver` with @-addressing, event-driven, mock brain first, live models after | CHATROOM_SPEC 12 step 1 |
+| S3 Trust-gated speaking | who may speak unprompted per trust level; claim arbitration | CHATROOM_SPEC 5, 10 |
+| S4 Expectation ledger + nudges | extraction, checks (promise kept, single owner first), nudge as event, budget guard, log-only calibration experiment | CHATROOM_SPEC 7, JEV_STRATEGIES 5 |
+| S5 Assistant crow | owner's default chat, reads the nest before answering status, relays, `ask_owner` | CHATROOM_SPEC 6 |
+| S6 COS crow + debate + visible budgets | spin up crows, moderate opt-in debates, show remaining exchanges/tokens | CHATROOM_SPEC 8, 9, 12 steps 4-6 |
+
+Epic 0 (spec blockers) is not a slice: the open questions in CHATROOM_SPEC 13 are the owner's decisions and gate S2/S4 work.