| 1 |
# Sprint 1 plan: Spectra 0.1, Talk |
| 2 |
|
| 3 |
Each loop iteration: pick the first unchecked item, implement it with tests, run the gated checks, commit with `oxy`, tick the box here with a one-line note, and commit again. Update `docs/spec.md` (and its changelog) whenever behaviour the spec describes changes. If an item cannot be finished in two iterations, note why under it and move on. The issues are on https://oxygenhub.io/projects/andymccall/7. |
| 4 |
|
| 5 |
## Rules |
| 6 |
|
| 7 |
- Never run `git init` in this directory or push this project anywhere but its `oxygenhub` remote. Commit with `OXY_HOME=~/.oxy-agents/claude oxy commit -m "..." PATHS..`, never with Andy's own key. |
| 8 |
- Tests are hermetic: a temporary data directory, a temporary socket, port 0; never `~/.local/share/spectra`, `~/.config` or the network. |
| 9 |
- Gate every commit on `make check` (changelog, fmt, clippy with warnings as errors, tests). |
| 10 |
- Every code change adds a CHANGELOG.md line under `## Unreleased`, or sets `NO_CHANGELOG=1`. |
| 11 |
- Never weaken a security goal of spec §5 to make a test pass. |
| 12 |
- Never act as Andy: owner-only steps (delegating to an agent key, the acceptance run) wait for him. |
| 13 |
|
| 14 |
## Items |
| 15 |
|
| 16 |
- [ ] #1 Project skeleton in Oxygen's shape |
| 17 |
- [ ] #2 CI on OxygenFlow |
| 18 |
- [ ] #3 The ledger |
| 19 |
- [ ] #4 Identities instead of tokens |
| 20 |
- [ ] #5 Projects, presence and sessions |
| 21 |
- [ ] #6 Channels, threads, messages, inbox and search |
| 22 |
- [ ] #7 Tuner: MCP over Streamable HTTP |
| 23 |
- [ ] #8 The 0.1 tools |
| 24 |
- [ ] #9 The stdio shim |
| 25 |
- [ ] #10 Radar |
| 26 |
- [ ] #11 JSON API and spectra-api types |
| 27 |
- [ ] #12 Human CLI |
| 28 |
- [ ] #13 Acceptance (with Andy) |
| 29 |
|
| 30 |
## Log |
| 31 |
|
| 32 |
- 2026-11-02 plan created; sprint adjusted to spec Draft 0.3 (identities and the ledger). |