OXYGENHUB
# 366e358ff5e7 spectra / docs / plan.md
1.6 KiB · Markdown · last changed Project skeleton in Oxygen's shape: workspace, deps/oxygen pinned, make check, version, deps-check (#1) 2 days ago renderedsource blame history raw

Sprint 1 plan: Spectra 0.1, Talk

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.

Rules

  • 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.
  • Tests are hermetic: a temporary data directory, a temporary socket, port 0; never ~/.local/share/spectra, ~/.config or the network.
  • Gate every commit on make check (changelog, fmt, clippy with warnings as errors, tests).
  • Every code change adds a CHANGELOG.md line under ## Unreleased, or sets NO_CHANGELOG=1.
  • Never weaken a security goal of spec §5 to make a test pass.
  • Never act as Andy: owner-only steps (delegating to an agent key, the acceptance run) wait for him.

Items

  • #1 Project skeleton in Oxygen's shape
  • #2 CI on OxygenFlow
  • #3 The ledger
  • #4 Identities instead of tokens
  • #5 Projects, presence and sessions
  • #6 Channels, threads, messages, inbox and search
  • #7 Tuner: MCP over Streamable HTTP
  • #8 The 0.1 tools
  • #9 The stdio shim
  • #10 Radar
  • #11 JSON API and spectra-api types
  • #12 Human CLI
  • #13 Acceptance (with Andy)

Log

  • 2026-11-02 plan created; sprint adjusted to spec Draft 0.3 (identities and the ledger).