pi-remote-control/docs
jay 126c96e9ad docs: Phase 0.5 complete - control mode recommended
Comprehensive report answers all R-CC-1 through R-CC-5 criteria.

Key findings:
- Control mode reliably survives alternate-screen transitions
- Latency comparable to pipe-pane (real-time streaming)
- Parallel SSH attach verified (P-2 requirement)
- Parser complexity reasonable (~200 lines production)

VERDICT: Path B (control mode) recommended for Phase 1.
2026-05-15 04:17:54 +02:00
..
reference docs: Phase 0.5 complete - control mode recommended 2026-05-15 04:17:54 +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 docs: reorganise — implementation plans + sync, archive spec to reference/ 2026-05-15 03:33:51 +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: add Phase 0.5 — spike tmux control mode 2026-05-15 04:06:25 +02:00
SYNC.md docs: claim Phase 0.5 spike tmux control mode 2026-05-15 04:07:57 +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/.

File Purpose
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.