This directory contains durable implementation notes for PiNative. For the
product north star / craft principles that should guide decisions here, see
AGENTS.md at the repo root.
- Code Architecture Walkthrough — visual, source-linked tour of features, navigation, persistence, Pi communication, chat lifecycle, and supporting surfaces. See the walkthrough maintenance notes when refreshing it.
- Native Shell Architecture — deeper layout, navigation, pane-state, runtime-ownership, and transcript-grouping details not repeated in the walkthrough.
- Build & Run — Xcode setup, command-line builds, internal DMGs, and stale-build troubleshooting.
- Requirements and Testing — RFC 2119 workflow, CI gate, and automated test commands.
- Smoke Test — agent-assisted real-Pi verification scenarios for behavior that mocks do not fully cover.
- Third-Party Licenses — licenses for bundled assets that differ from this project's MIT license.
Keep this docs/ directory focused on decisions, architecture, and implementation references that describe how the app currently works and should stay accurate as it evolves. Record only durable outcomes here; keep exploratory planning outside the tracked repository.