Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

flag-cleanup

/flag-cleanup

Szuka, sprawdza i usuwa przestarzałe flagi funkcji w kodzie, na przykład Flipper, Pennant czy LaunchDarkly, gdy ich dług zaczyna przeszkadzać.

Licencja
MIT
Ostatnia zmiana repozytorium
05.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
7
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Szuka, sprawdza i usuwa przestarzałe flagi funkcji w kodzie, na przykład Flipper, Pennant czy LaunchDarkly, gdy ich dług zaczyna przeszkadzać.

Wyzwalacze z opisu

feature flag cleanupstale flagsdead flagsremove a flagrip out the flagflag debtFlipperFlipper.enabled?
Oryginalny opis (EN)

This skill should be used when the user wants to find, audit or remove feature flags or toggles, for example "feature flag cleanup", "stale flags", "dead flags", "remove a flag", "rip out the flag", "flag debt", "Flipper", "Flipper.enabled?", "waffle", "flag_is_active", "switch_is_active", "Laravel Pennant", "Feature::active", "LaunchDarkly variation", "Unleash isEnabled", "OpenFeature getBooleanValue", or when reviewing a branch that leaves a flag fully rolled out. Lists the flags and every call site, marks the likely-stale ones and writes a safe removal plan, from code only.

Jak działa

  1. Supported systems
  2. Workflow
  3. Rules for the plan
  4. The scanner
Sekcje z nagłówków SKILL.md, w oryginale · 37 linii, 545 słów
Podgląd SKILL.md
---
name: flag-cleanup
description: This skill should be used when the user wants to find, audit or remove feature flags or toggles, for example "feature flag cleanup", "stale flags", "dead flags", "remove a flag", "rip out the flag", "flag debt", "Flipper", "Flipper.enabled?", "waffle", "flag_is_active", "switch_is_active", "Laravel Pennant", "Feature::active", "LaunchDarkly variation", "Unleash isEnabled", "OpenFeature getBooleanValue", or when reviewing a branch that leaves a flag fully rolled out. Lists the flags and every call site, marks the likely-stale ones and writes a safe removal plan, from code only.
version: 1.0.0
---

# Feature Flag Cleanup

A flag that is fully rolled out, or abandoned, is dead weight: two code paths to read, a test matrix that doubles, and a flag record nobody dares delete. This skill finds the flags in code, shows every place each one is used, marks the ones that look stale, and plans the removal so each step can ship alone.

It works from code only. It never calls a flag service API and never reads the credentials of one. What a flag is set to in production is not visible in code: the plan always says where the owner must confirm it.

## Supported systems

| System | Call shapes the scanner recognises | Reference |
|---|---|---|
| Flipper (Rails) | `Flipper.enabled?(:x)`, `Flipper[:x].enabled?`, `Flipper.add`, `Flipper.enable`, `Flipper.remove` | `references/flipper.md` |
| django-waffle | `flag_is_active`, `switch_is_active`, `sample_is_active`, decorators, template tags, `override_flag` | `references/django-waffle.md` |
| Laravel Pennant | `Feature::define`, `Feature::active`, `@feature`, class-based features, `Feature::purge` | `references/laravel-pennant.md` |
| LaunchDarkly, Unleash, OpenFeature (Node) | `variation`, `isEnabled`, `getBooleanValue`, and the React hooks | `references/node-sdks.md` |

## Workflow

1. **Detect the system** from dependency files and imports. Several can coexist.
2. **List flags and call sites.** For each flag: every check, definition, toggle and removal with `file:line`, split into code and tests. Dynamic names (`Flipper.enabled?(name)`) are listed apart: they may touch any flag, so they weaken every "unused" conclusion.
3. **Mark likely-stale flags** with `references/stale-heuristics.md`.
4. **Plan the removal** per flag with `references/removal-plan.md`: confirm the live state, pick the branch to keep, edit the call sites, update the tests, remove the code definition, and delete the flag record last.
5. **Verify** by grepping the flag name again (including strings, YAML, docs and dashboards) and running the affected tests.

## Rules for the plan

- Never pick the branch to keep from the code alone. The branch to keep is the one production runs for everyone, and only the flag owner can confirm it. State it as a question to confirm.
- One flag per change. Order the steps so the application is correct after each one.
- The flag record goes last, in its own step, after the code that reads it is deployed everywhere.
- Say what code cannot show: the state in the flag service, other repositories or services reading the same flag, mobile or client builds still in the field.

## The scanner

`scripts/flag_scan.py` is a deterministic heuristic scan. It reads source and template files only, skips dotfiles, key and credential files, dot directories, dependency directories and symlinks, and never opens a network connection. Output is text or `--json`; `--framework` limits it to one system. Exit code 1 when it marks a flag stale.

Stale codes: `STALE-UNUSED`, `STALE-CONSTANT`, `STALE-UNDEFINED`, `STALE-SINGLE-REF`. Each is a lead, not a verdict. Limits: it matches flag names written as literals, it does not follow variables or constants, and it cannot see a flag set only in the flag service. Matching is line based: code inside Ruby `=begin` blocks, the middle of multiline comments, docstrings and string literals counts as real, and names containing both quote characters or written as `:"quoted-sym"` are missed. It skips Python settings modules (`settings.py`, `local_settings.py`, `prod_settings.py`, `settings_local.py`, files under a `settings/` directory), `database.php`, dotfiles and secret files. `references/stale-heuristics.md` explains each code and its false positives.
Pliki w paczce (7)
  • SKILL.md 4 KB
  • references/django-waffle.md 2 KB
  • references/flipper.md 2 KB
  • references/laravel-pennant.md 2 KB
  • references/node-sdks.md 2 KB
  • references/removal-plan.md 3 KB
  • references/stale-heuristics.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie flag-cleanup.

Migawka bazy z 13.11.2026 · wersja paczki 22c819d47fe3 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90launchdarkly-flag-discovery
    Audytuje flagi funkcji LaunchDarkly: przestarzałe, w pełni wdrożone i kandydatów do usunięcia, z oceną gotowości do sprzątania.
  • 90launchdarkly-flag-discovery
    Audytuje flagi funkcji LaunchDarkly, by poznać ich zasób, znaleźć flagi nieużywane lub już wdrożone i ocenić gotowość do usunięcia, czyli dług flag.
  • 95feature-flags
    Dodaje do usługi flagi funkcji, planuje wdrożenia procentowe i eksperymenty A/B, wybiera LaunchDarkly, Unleash lub OpenFeature.
  • 95cleaning-up-stale-feature-flags
    Wyszukuje przestarzałe flagi funkcji w PostHog i porządkuje kod, który je sprawdza, przez lokalne zmiany i szkice PR.
  • 100laravel-pennant
    Pomaga pracować z flagami funkcji w Laravel Pennant: stopniowe wdrożenia, testy A/B i flagi zakresowe, także gdy prośba brzmi „ukryj to za flagą”.
  • 100launchdarkly-flag-cleanup
    Usuwa z kodu flagę funkcji bezpiecznie, zachowując działanie produkcji, i tworzy PR z wygrywającym wariantem na stałe.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.