speckit-deprecate

Manage a three-phase software feature deprecation workflow from warnings to removal.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/refactory-lang/refactory-template --skill speckit-deprecate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-deprecate
Source: https://github.com/refactory-lang/refactory-template/tree/main/.claude/skills/speckit-deprecate
Command: npx skills add https://github.com/refactory-lang/refactory-template --skill speckit-deprecate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of deprecating features within a project, ensuring a structured and phased approach to removal that minimizes disruption to users and the codebase.

Core Features & Use Cases

  • Phased Sunset: Manages a three-phase deprecation process: Warnings, Disabled, and Removed.
  • Dependency Analysis: Automatically scans for and reports on code that depends on the feature being deprecated.
  • Use Case: A product team decides to remove an underutilized feature. This Skill helps them plan and execute the removal by notifying users, disabling the feature, and finally removing the code, all while ensuring dependent systems are accounted for.

Quick Start

Initiate a deprecation workflow for feature 014 with the reason "low usage and high maintenance burden".

Frequently Asked Questions about speckit-deprecate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a phased deprecation workflow for software features?

A phased deprecation workflow manages software feature sunset through three stages: warnings, disabled, and removed. This structured approach minimizes codebase disruption by gradually removing features while tracking dependent systems throughout the process.

How do I plan a feature sunset with dependency analysis?

Feature sunset planning uses dependency analysis to automatically scan and report code relying on the deprecated feature. This identifies affected systems before removal, generating a comprehensive deprecation plan that safely transitions through warning and disabling phases.

Can I deprecate multiple features using direct mode commands?

Yes, direct mode supports deprecating features by specifying feature numbers as arguments. Alternatively, interactive mode allows manual feature selection from a list, providing flexibility when initiating the phased sunset workflow for single or multiple features.

What is the best way to notify users before removing a feature?

The best way to notify users before feature removal is implementing a three-phase sunset process. It starts with warnings to alert users, proceeds to disabling the feature, and concludes with complete code removal while dependency scans ensure system stability.

When should I not use an automated feature deprecation process?

Automated feature deprecation may be unnecessary for trivial code deletions with zero dependencies. If a feature has no dependent systems and requires no user notification, a phased sunset workflow adds overhead compared to immediate removal.

Does the deprecation workflow generate a removal plan from dependency scans?

Yes, the deprecation workflow runs dependency scans to identify affected code and generates a comprehensive removal plan. This plan structures the three-phase sunset process, ensuring all dependent systems are accounted for before final code removal.