feature-retirement-flow

Guides measured, classified, and provable removal of shipped features across repositories.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/eeemzs/aops --skill feature-retirement-flow-eeemzs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: feature-retirement-flow
Source: https://github.com/eeemzs/aops/tree/main/assets/skills/feature-retirement-flow
Command: npx skills add https://github.com/eeemzs/aops --skill feature-retirement-flow-eeemzs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Removing a shipped feature is riskier than it looks: half-removed concepts leave behind tables, routes, published types, and agent assets that still instruct users to use the retired capability. This Skill turns feature removal into a measured, classified, and provable process so nothing stale survives the release. ## Core Features & Use Cases - Residue Inventory: Run calibrated grep-based inventories from inside each repository root, with exclusion patterns that correctly handle root-level build directories, and record per-extension breakdowns before editing anything. - Three-Class Classification: Sort every hit into live code (deleted with reference scans), shipped documentation and agent assets (updated or deleted), and historical records (never rewritten), with rules for detecting misclassified derived artifacts. - Gated Irreversible Changes: Handle schema drops and data migrations on a separate approval track, sequenced after the code that reads them is gone. - Republish Cascade and Zero-Residue Proof: Bump and republish dependent workspace packages, then prove completion by re-running the opening inventory plus a reference scan for every deleted file and script name at the final commit. - Use Case: When retiring a domain capability from a multi-repository product, follow this flow to produce a tracking record with before/after inventory numbers, class breakdowns, schema decisions, and a closing record a reviewer can independently verify. ## Quick Start Use the feature-retirement-flow skill to plan and execute the removal of the retired feature from this repository set, starting with a residue inventory.

Frequently Asked Questions about feature-retirement-flow

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

FAQPage Schema
How do I safely remove a feature from a codebase?▼

Start by running a calibrated grep inventory from inside each repository root and record the totals before editing. Classify every hit as live code, shipped documentation, or historical record, gate schema changes separately, then prove zero residue by re-running the same inventory at the final commit.

What is the difference between feature retirement and deprecation?▼

Retirement means the capability goes away entirely with no consumer migration to a replacement inside the change. If a replacement exists and consumers must move to it, that is a migration requiring a deprecation window, which follows a different flow.

Why does a grep search for a concept miss or over-match files?▼

Word-boundary patterns miss camelCase usages like RepositoryFactoryMission, while bare substring searches over-match words like permission when searching for mission. The flow uses a pattern requiring a non-letter before the lowercase form and avoids case-insensitive flags.

Should historical records be updated when retiring a feature?▼

No. Review requests, changelogs, decision logs, and migration journals are Class C records that are never rewritten, because they record what was true when written. If annotation is needed, append rather than revise to preserve the audit trail.

When should database schema changes land during feature removal?▼

A migration that drops storage must land after the code that reads it is gone and published, never in the same step. Otherwise a rollback of the code lands on a schema that can no longer serve it, and the drop decision requires its own explicit approval.

Why does a clean concept search not prove a feature removal is complete?▼

A concept search measures content, not references. Deleted file names, script keys, and workflow steps can still be invoked by name without mentioning the concept, so a second probe searching for every deleted name is required to catch residual references.