distribution/.agents/subplans/README.md

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.