Claude
Skills
Sign in
Back

hard-cut

Included with Lifetime
$97 forever

Remove a feature completely with no backward compatibility; delete surfaces, callers, tests, docs, fallbacks, stubs, and dead exports.

General

What this skill does


# Hard Cut

Use this when a feature should die, not linger.

## Rules

- Delete the surface. Do not deprecate it.
- Do not leave `throw new Error("Not implemented")`, placeholder notices,
  "feature removed" banners, or TODOs about bringing it back unless the user
  explicitly asks.
- Do not keep compatibility aliases, deprecated shims, fallback parsing,
  migration bridges, or dead exports.
- Delete tests for deleted behavior. Keep tests only for the behavior that
  still exists.
- Delete comments that describe deleted code or mourn the old feature.
- If removal exposes adjacent dead code, keep cutting until the graph is clean.

## Sweep

1. Find the real surface area:
   - exports
   - commands and flags
   - routes
   - UI entrypoints
   - feature flags
   - docs and examples
2. Trace references with `rg`.
3. Delete the implementation and the glue:
   - call sites
   - types
   - state
   - tests
   - docs
   - comments
4. Grep again for the removed name and obvious aliases.
5. Run the narrowest honest verification for the surviving product.

## Smells

- deprecated notices
- not-implemented throws
- stub handlers
- dead enum or union members
- permanently-false feature-flag branches
- unused env vars and config
- tests that only prove the deleted feature used to exist

## Bias

If the choice is between deleting more code and leaving a zombie surface, delete
more code.
Files: 1
Size: 1.5 KB
Complexity: 4/100
Category: General

Related in General