so-many-crows/docs/SCOPE.md

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.