app development context

docs/migration/native-poc-results.md

@@ -1,5 +1,10 @@
 # Native macOS POC Results
 
+> This document records capability evidence, not the production product specification.
+> Canonical direction is defined by [`../../CONTEXT.md`](../../CONTEXT.md),
+> [`../product/mastermind-product-brief.md`](../product/mastermind-product-brief.md), and
+> [`../architecture/native-mastermind.md`](../architecture/native-mastermind.md).
+
 ## Implemented
 
 - SwiftPM-based macOS POC under `native/MastermindPOC`.
@@ -42,3 +47,19 @@
 ## Boundary
 
 This POC is not a stealth or anti-detection system. It shows a menu bar item while running, requests normal macOS permissions, and only excludes its own overlay from the context it captures for itself.
+
+## Role in production migration
+
+`native/MastermindPOC` proves that AppKit windowing, ScreenCaptureKit screen and system-audio capture, AVAudioEngine microphone capture, current-process exclusion, and 16 kHz PCM conversion are viable.
+
+Production development moves to `native/Mastermind`. Validated capability code may be ported behind production boundaries, but the POC is not renamed into the product and is retired after parity checks pass.
+
+The production design intentionally differs from the POC:
+
+- the Companion Island is hidden at launch and anchored to the primary display's top center;
+- enabled Collectors start continuously after onboarding instead of through manual start menu items;
+- the Menu Bar Item uses a stable glyph with detailed states inside its menu;
+- screen, microphone, and system-audio states are simultaneous per-Collector states rather than one `TrustStatus`;
+- settings and management live inside the expanded Companion Island;
+- screen context follows the active display rather than always selecting the main display;
+- the Context Graph, Local Provider, local ASR client, retention, encryption, Context Receipts, and Activity Log are production requirements not implemented by the POC.