Command

/flag-cleanup

Run the quarterly feature-flag cleanup workflow on the current repo

shell

$ npx -y skills add alirezarezvani/claude-skills --agent claude-code

Ships with claude-skills. Installing the plugin gets this command.

How it fires

How this command gets triggered: by you, by Claude, or both.

Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/flag-cleanup

Context preview

What this command does when you run it.

Run the quarterly feature-flag cleanup workflow on the current repo

Stats

Stars23,062

Forks3,139

LanguagePython

LicenseMIT

Ships with claude-skills

Command definition

flag-cleanup.md

---
description: Run the quarterly feature-flag cleanup workflow on the current repo
---

# /flag-cleanup

Run the full feature-flag cleanup workflow:

1. Scan for stale flags (older than 90 days, used in ≤2 places)
2. For each candidate, identify the introducing PR/issue and current owner
3. Generate a removal plan grouped by owner
4. Run kill-switch audit against the flag-doc registry
5. Output a markdown report ready to share with the team

## Usage

```
/flag-cleanup
/flag-cleanup --max-age-days 60
/flag-cleanup --flag-doc runbooks/flags.md
```

## Implementation

This command dispatches to the `feature-flags-architect` skill:

```bash
SKILL=engineering/feature-flags-architect/skills/feature-flags-architect

# Step 1: scan for debt
python "$SKILL/scripts/flag_debt_scanner.py" --repo . --max-age-days "${MAX_AGE_DAYS:-90}" --format json > .flag-debt.json

# Step 2: audit kill switches
python "$SKILL/scripts/kill_switch_audit.py" --repo . --flag-doc "${FLAG_DOC:-docs/feature-flags.md}" --format json > .kill-switch-audit.json

# Step 3: synthesize a markdown report
# (Claude reads both JSON files, groups by owner, drafts the cleanup plan)