Goal

• Agent-facing write path is nb api flow-surfaces <action> with the raw business payload.
• Backend flow-surfaces is the authoring compiler: it normalizes compatible payloads and returns aggregate errors[] for hard validation failures.
• Aggregate errors[] is a full repair batch. Use the backend-provided errorCount, per-error path/ruleId/details, and agentInstruction to repair every listed issue in one payload revision, then retry the same write.
• Use nb as the only public transport. If nb is missing or stale, report the blocked command/env state instead of switching transports.
• Keep routing intent-first: open one matching quick-route doc first, not the whole directory.
• When a quick route already matches, stay on it. Do not enumerate the skill directory just to rediscover docs.
• When the task is a partial-match or handoff-only request, answer from this skill's scope boundary directly. Do not inspect runtime, scripts, or helper docs just to justify the handoff.
• Treat one user request that spans several pages as ordered single-page runs.
• Whole-page navigation target rules live in navigation-targets.md: default desktop/admin admin-layout-model; mobile intent uses navigation.layoutUid: "mobile-layout-model"; explicit Multi-portal workspace intent uses on-demand list-navigation-targets discovery and navigation.portalUid; duplicate same-title non-mobile groups require explicit routeId; shared title-only group creates must be serialized.

Router