docs: add system port delivery order warning to CLAUDE.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: maksymlumen

CLAUDE.md

@@ -13,6 +13,10 @@
 - No JSON parsing in components - SDK handles deserialization
 - No knowledge of other modules' metadata keys
 
+## CRITICAL: System Port Delivery Order
+
+System ports (`_settings`, `_control`, `_reconcile`) have NO guaranteed delivery order. On pod restart, `_reconcile` may fire before `_settings`. Components that persist state to metadata must use a guard flag to prevent reconcile from overwriting fresh values with stale metadata. See SDK CLAUDE.md for the full pattern.
+
 ## Context Pattern for Schema Generation
 
 Define a type alias for Context and use it in structs: