UHC Federation Integration Reviewer

Use this skill to review whether a UHC Mobile federated module integrates with the host app through approved V2 contracts.

Workflow

1. Inspect the federated package boundary, package.json, imports, host integration points, route configuration, API clients, analytics, and accessibility usage.
2. Require V2 package imports from @uhg-uhc-mobile/federation for host data and host events, @uhg-uhc-mobile/uhc-mobile-api for backend calls, and @uhg-uhc-mobile/accessibility for accessibility helpers when applicable.
3. Flag deprecated @optum-mobile-fmd/* package usage and direct host-app internal coupling.
4. Check data access patterns: use hooks in components and getters/utilities in non-component code according to local package conventions.
5. Check outgoing events: navigation, analytics, SSO, and other host events should use the federation contract rather than bespoke event emitters.
6. Check session behavior, route mapping, error handling, and token handling at the boundary.
7. Report blocking integration issues before style or cleanup findings.

Review Focus

• Deprecated @optum-mobile-fmd/user, config, event-hub, analytics, or navigation imports.
• Direct imports from host internals instead of the federation contract.
• API calls that bypass the approved @uhg-uhc-mobile/uhc-mobile-api client or token injection pattern.
• Missing or inconsistent route mapping, session handling, host navigation events, or analytics events.
• Accessibility gaps in federated UI where the approved package should be used.

Output

• Lead with findings ordered by severity, with file and line references when possible.
• Separate blocking issues from high, medium, and low priority recommendations.
• Explain impact in mobile-user terms: security exposure, broken rollout, jank, inaccessible flow, analytics drift, build/runtime failure, or maintainability risk.
• Include specific remediation guidance. Keep code snippets small unless the user asks for an implementation.
• If no issues are found, say so clearly and note any meaningful test or verification gaps.

References

• references/review-guide.md: Migrated detailed review guide from the original mobile-ai-skills agent definition. Read it when you need the full checklist, example report shape, or grep patterns.