s-hiraoku Simplify
Use this workflow after a feature or bug fix works, but before review or release, to reduce unnecessary complexity introduced during the change.
Workflow
- Identify the changed files and public behavior that must remain unchanged.
- For each non-trivial changed file, check whether the change added:
- helpers used only once
- abstractions without a second caller
- validation for impossible states
- unused imports, variables, branches, flags, or configuration
- comments that restate code instead of explaining intent
- duplicated logic that an existing local helper already handles
- Search before introducing or keeping a helper; prefer established project patterns.
- Apply minimal cleanup only when behavior is clearly unchanged.
- Leave risky cleanup as a proposal instead of applying it.
- Re-run targeted tests for each touched area.
Final Report
Include:
- files simplified
- specific complexity removed
- behavior-preservation checks run
- cleanup proposals intentionally left unapplied
- residual risks