Baseline: distribution workspace before observability redesign

.agents/subplans/README.md

@@ -0,0 +1,44 @@
+# Detailed Subplan Index
+
+These subplans break `PLAN.md` into implementation slices that can be handed to
+Snarky and Opus without reloading the whole plan every time.
+
+## Reading Order
+
+1. `01-language-and-stdlib.md`
+2. `02-domain-and-storage.md`
+3. `03-cli-and-ci.md`
+4. `04-http-api-and-install.md`
+5. `05-artifact-validation.md`
+6. `06-admin-ui.md`
+7. `07-packaging-nas.md`
+8. `08-orchestration-and-qa.md`
+
+## Session Contract
+
+- Read `PLAN.md`, `.agents/ORCHESTRATION.md`, `.agents/CHECKPOINT.md`, and
+  the active subplan before doing work.
+- Keep work sequential. Do not use parallel implementation agents.
+- Use git branches for implementation. Do not use worktrees.
+- For product or UX scope, Snarky writes acceptance criteria and has final say.
+- For layout and visual design, Opus has final say.
+- For technical problems, consult Opus and resolve by consensus.
+- Opus is the only role that writes application code during Opus phases.
+- Update `.agents/CHECKPOINT.md` and `.agents/checkpoint.json` after every
+  completed slice, before any risky handoff, and after validation.
+
+## Slice Exit Criteria
+
+Every slice should finish with:
+
+- Changed files listed.
+- Tests/checks run listed.
+- Known risks listed.
+- Next slice named.
+- Checkpoint updated.
+
+## Current Priority
+
+The first blocking priority is `01-language-and-stdlib.md`. Product code should
+wait until the required `sx` primitives exist or an explicit temporary shim is
+approved.