pi-remote-control/docs
jay 0882ef8038 docs: bring NEXT-STEPS + SYNC up to current state (2026-05-16)
Phase 2 reality vs plan:
- Done: T-2.0..T-2.6, T-2.8, T-2.9, T-2.11
- Bonus done: XCUITest target + 8/8 tests, idb automation guide
- Open: T-2.7, T-2.10, T-2.12, T-2.13
- Bug backlog: 4 Keychain entitlements failures + 4 Pairing http-scheme tests

Also documented conventions: async subagent dispatch, reviewer fan-in,
--uitest mode + idb workflow, sidecar manual restart pattern.

Replaced obsolete Phase-1 orchestration instructions with current
priorities.
2026-05-16 22:20:55 +02:00
..
reference feat(T-1.8/1.9): stream integration smoke, operator guide, Phase 1 complete 2026-05-15 11:43:59 +02:00
NEXT-STEPS.md docs: bring NEXT-STEPS + SYNC up to current state (2026-05-16) 2026-05-16 22:20:55 +02:00
PHASE-0-spike-stream.md docs: reorganise — implementation plans + sync, archive spec to reference/ 2026-05-15 03:33:51 +02:00
PHASE-0.5-spike-tmux-control-mode.md docs: add Phase 0.5 — spike tmux control mode 2026-05-15 04:06:25 +02:00
PHASE-1-sidecar.md chore: freeze IC-1..IC-4 interface contracts 2026-05-15 06:56:38 +02:00
PHASE-2-ios-mvp.md docs: reorganise — implementation plans + sync, archive spec to reference/ 2026-05-15 03:33:51 +02:00
PHASE-3-ios-augmentation.md docs: reorganise — implementation plans + sync, archive spec to reference/ 2026-05-15 03:33:51 +02:00
README.md docs: incorporate Phase 0.5 verdict (Path B), prep Phase 1 2026-05-15 04:48:20 +02:00
SYNC.md docs: bring NEXT-STEPS + SYNC up to current state (2026-05-16) 2026-05-16 22:20:55 +02:00

README.md

Implementation Docs

This folder drives the implementation work for the pi-remote iOS app and its sidecar. Background / spec / audit material lives in reference/.

Start here when resuming work: NEXT-STEPS.md.

File Purpose
NEXT-STEPS.md Resume pointer — state of play, next orchestrator actions, open questions. Read first.
PHASE-0-spike-stream.md Stream PoC — verify tmux + pipe-pane + WebSocket. ~1 day, single agent. Done, see reference/PHASE-0-report.md.
PHASE-0.5-spike-tmux-control-mode.md Follow-up spike: tmux control mode (-CC) vs pipe-pane + watchdog. Decides Phase 1 streaming path. ~2h, single agent.
PHASE-1-sidecar.md Sidecar production-ready: all S-features, multi-agent parallel work. Blocked on Phase 0.5.
PHASE-2-ios-mvp.md iOS app MVP — Groups A, B, C-01/02, D, E, F. Multi-agent parallel.
PHASE-3-ios-augmentation.md iOS feature polish — slash palette, voice, thumbnails, search, etc.
SYNC.md Live multi-agent coordination — claims, file ownership, contract changes.

Order of work

  1. Phase 0 first, single agent.
  2. Phase 1 starts after Phase 0 green-lights; multi-agent parallel.
  3. Phase 2 starts after Phase 1 is production-ready; multi-agent parallel.
  4. Phase 3 is continuous after Phase 2 MVP ships.

See SYNC.md for the current state.