Software Feature Sunset and Migration Planning Brief
Plan the phased deprecation, customer migration, and operational safeguards for retiring legacy software capabilities.
Use this template when planning the end-of-life cycle for a cloud or enterprise software feature. It guides product and engineering leaders through customer impact mapping, technical migration paths, and risk mitigation.
Role: Principal Product Operations Lead specializing in software lifecycle governance and enterprise customer retention.
Context
- SaaS Platform: {{product_name}}
- Retiring Capability: {{deprecated_feature}}
- Replacement Architecture: {{migration_path}}
- Deprecation Schedule: {{sunset_timeline}}
- Impacted User Tier: {{impacted_customer_tier}}
- Maintenance Burden: {{technical_debt_impact}}
Task
Author an executive deprecation planning brief detailing migration milestones, client transition requirements, and operational fail-safes to retire {{deprecated_feature}} safely without customer attrition.
Method
- Evaluate current usage telemetry for {{deprecated_feature}} across {{impacted_customer_tier}} to identify high-risk accounts.
- Map functional discrepancies between the legacy component and {{migration_path}} to identify workflow gaps.
- Establish phased transition gates across {{sunset_timeline}}, balancing release velocity against customer change fatigue.
- Quantify operational savings and system stability gains tied to resolving {{technical_debt_impact}}.
- Define high-touch outreach playbooks for enterprise accounts alongside self-serve guidance for standard tiers.
- Specify telemetry triggers, API sunset warning headers, and hard cutover verification checks.
- Formulate escalation protocols and temporary rollback criteria for critical production blockers.
Constraints
- MUST specify explicit, quantifiable rollback triggers for technical failure.
- MUST NOT propose indefinite dual-stack maintenance or open-ended grace periods.
- All milestones must fit strictly inside {{sunset_timeline}}.
- Keep recommendations prioritized by customer churn exposure.
Output format
Executive brief containing the following sections:
- Deprecation Overview (max 100 words)
- User Impact Assessment (3 key segments evaluated)
- Milestone Execution Roadmap (table: Phase, Date, Deliverable, Owner)
- Account Migration Playbook (step-by-step workflow)
- Safeguards and Rollback Criteria (3 clear threshold triggers)
Self-review
- Ensure all 6 context variables are actively integrated into the plan.
- Verify rollback triggers have objective, measurable operational metrics.
- Confirm deprecation timelines align with enterprise notice norms.
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.