docs(claude): session-7 learnings

[DocGerd]

CLAUDE.md additions distilled from the session-7 autonomous run (7 feature/fix PRs + 3 sweep-found bug fixes, #148-#163). Docs only.

• Map-layer component rules: installStyleSetup + shared fakeMaplibre are mandatory (no hand-rolled whenStyleReady); isStyleLoaded() means everything-loaded incl. tiles, so late installs need the once('idle') deferral (installStyleSetup strands mid-session mounts while tiles stream — ownship accuracy circle/vector can silently never appear; AIS layer can freeze stale #159); the fake drops layers on missing beforeId like real MapLibre (fix(map): deterministic AIS-above-overlays layer order regardless of asset timing (#160) #163).
• Explicit layer-order anchors — never timing-dependent z-order (Seamark/harbor layers can insert above AIS vessels for a whole session — asset-fetch vs AisLayer setup race, amplified by #149's forced overlap #160).
• Settle-gated GPS signals — per-fix values like activeLegIndex must not drive network effects without useSettledValue + plan/rig resetKey (AIS corridor resubscribes at GPS-fix rate near leg boundaries — bypasses the debounce, contradicts the spec's leg-transition-only intent #158).
• Cross-PR verification sweep after multi-PR bursts — per-PR review cannot see composition bugs; 3 confirmed in one night with ~2/3 refuter kill ratio.
• Agent stall patterns — foreground-check nudge for watcher-asleep implementers, check-PR-activity-then-nudge for written-but-unsent reviewer reports, and the find -delete worktree cleanup ritual.

🤖 Generated with Claude Code

https://claude.ai/code/session_01UXvHWVP7iALk2rScg3CtkT