OpenFeature Feature Flag SDK Migration Checklist Builder
Plan a migration from a vendor-specific feature flag SDK to OpenFeature with provider setup, parity testing, rollout controls, observability, and rollback criteria.
Prompt Template
You are a senior platform engineer helping a team migrate feature flag calls to OpenFeature. Build a technical migration checklist for: Current flag system: [LaunchDarkly, ConfigCat, Unleash, Split, homegrown, multiple providers] Target runtime: [Node.js, browser, React, Next.js, Java, Go, Python, mobile, edge] Application architecture: [monolith, microservices, frontend app, shared SDK, serverless, background workers] Flag usage patterns: [boolean flags, variants, experiments, kill switches, entitlements, percentage rollout] Context model: [user, account, tenant, anonymous visitor, device, region] Provider plan: [existing provider adapter, custom provider, multi-provider, evaluation proxy] Environments: [local, test, staging, production, preview apps] Constraints: [PII limits, latency, offline mode, edge compatibility, audit logging, compliance] Testing tools: [unit tests, integration tests, contract tests, Playwright, observability platform] Rollout appetite: [single service first, library wrapper first, strangler migration, big-bang avoided] Rollback needs: [revert SDK, provider toggle, compatibility layer, emergency kill switch] Create: 1. Current-state inventory for SDK calls, flag keys, context fields, variants, defaults, and ownership. 2. OpenFeature architecture decision record outline. 3. Provider configuration checklist for each environment. 4. Context mapping plan that avoids leaking unnecessary personal data. 5. Code migration steps for wrappers, hooks, server-side evaluation, client-side evaluation, and tests. 6. Parity test suite comparing old and new evaluations across representative contexts. 7. Observability plan for evaluation errors, latency, default fallbacks, provider readiness, and stale flags. 8. Progressive rollout plan by service, team, or route. 9. Rollback and incident response checklist. 10. Cleanup plan for deprecated SDKs, environment variables, docs, and ownership metadata. Assume production safety matters. Do not remove the old SDK until parity, rollback, and owner signoff are clear.
Example Output
Migration Checklist
Inventory
| Area | Current | Migration Note |
|---|---|---|
| SDK calls | 143 LaunchDarkly calls | Start with shared flag helper and checkout service. |
| Context fields | userId, accountId, plan, country | Remove email from evaluation context before provider handoff. |
| Variants | pricing_page_layout, onboarding_flow | Add typed enum tests for variant fallbacks. |
Parity Test
Create fixtures for anonymous visitor, free tenant, enterprise admin, EU tenant, and missing context. For each fixture, compare old SDK result, OpenFeature result, default value, and reason metadata.
Rollout Gate
Move one low-risk service first. Watch provider readiness, evaluation latency p95, fallback rate, and flag mismatch logs for 48 hours before migrating checkout or billing flags.
Tips for Best Results
- 💡Inventory context fields early; feature flag migrations often become privacy and identity-model migrations.
- 💡Ask for parity tests across real flag variants, not just boolean happy paths.
- 💡Keep rollback explicit because a flag SDK migration can affect every guarded release path.
Related Prompts
Feature Flag Rollout and Rollback Plan Builder
Design a safe production rollout plan with feature flags, exposure stages, monitoring thresholds, and rollback triggers.
Code Review Assistant
Get a thorough, senior-level code review with actionable feedback on quality, security, performance, and best practices.
Debugging Detective
Systematically debug errors and unexpected behavior with root cause analysis and fix suggestions.