uhc-feature-flag-reviewer
Review UHC Mobile feature flag additions and usage for enable-prefixed naming, selector naming, default values, internal and platform-specific overrides, alphabetical ordering, product coordination, rollout safety, dead-flag cleanup, and removal planning. Use when feature flag types, selectors, defaults, overrides, or flag-gated UI logic changes.
UHC Feature Flag Reviewer
Use this skill to review UHC Mobile feature flags for safe rollout, consistent naming, predictable defaults, and planned cleanup.
Workflow
- Find every touched feature-flag surface: type definitions, initial state, selectors, internal overrides, iOS/Android overrides, remote config, tests, and gated usage.
- Require enable-prefixed flag names that describe the feature positively and match local casing conventions.
- Require selector names such as selectIsFeatureEnabled rather than direct state reads scattered through UI code.
- Verify defaults are conservative, usually false, unless local guidance or an already-launched feature justifies otherwise.
- Check alphabetical ordering and consistency across all flag files.
- Check rollout ownership, product coordination, observability, and a removal/debt plan for temporary flags.
- Report any flag that changes behavior without defaults, selectors, tests, or cleanup intent.
Review Focus
- enable* naming, positive semantics, and selector-based access.
- Defaults, internal build overrides, platform overrides, and remote config consistency.
- Alphabetical ordering in flag maps, types, selectors, and override files.
- Flag-gated UI that leaves both enabled and disabled paths testable.
- Cleanup tickets or removal criteria for launch-only flags.
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 originalmobile-ai-skillsagent definition. Read it when you need the full checklist, example report shape, or grep patterns.
Related Assets
dependency-management-reviewer
Review React Native and UHC Mobile dependency additions for maintenance status, React Native compatibility, New Architecture readiness, security vulnerabilities, bundle impact, license and ownership risk, justification, alternatives, and approved federation package usage. Use when package.json, lockfiles, native modules, or third-party package choices change.
Owner: optum-tech-compute
file-structure-auditor
Review React Native and UHC Mobile code for file structure, file naming, related-file grouping, folder organization, modal placement, utility extraction, and package boundary standards. Use when asked to audit directories, organize components, review screen/package layout, or clean up UHC Mobile file structure.
Owner: optum-tech-compute
react-native-performance-review
Review React Native code for performance issues including unnecessary re-renders, inline functions, missing memoization, inefficient lists, context overuse, missing cleanup, and other mobile-specific performance problems. Use when asked to check performance, optimize React Native code, reduce jank, or review performance-critical mobile changes.
Owner: optum-tech-compute
react-native-security-review
Review React Native code for security vulnerabilities including PII/PHI storage, authorization bypass risks, secrets handling, token exposure, unvalidated identifiers, unsafe logging, mobile storage risks, and other security-critical mobile issues. Use when asked to check security, sensitive data handling, authentication, authorization, storage, logging, or network-related React Native changes.
Owner: optum-tech-compute
uhc-analytics-reviewer
Review UHC Mobile analytics implementations for .analytics.ts isolation, track-prefixed functions, Adobe payload casing, analytics constants, screenNameMapEntries updates, route mapping, A/B test tracking, event placement, and federated analytics events. Use when adding or changing mobile analytics, tracking hooks, navigation tracking, or Adobe payloads.
Owner: optum-tech-compute
uhc-code-organization-auditor
Audit UHC Mobile code organization, naming conventions, file structure, import/export patterns, component section ordering, selector and analytics naming, feature-flag naming, and module boundaries before feature merges or cleanup work. Use when reviewing UHC Mobile React Native packages for maintainability and repository convention drift.
Owner: optum-tech-compute