Simplify

Simplify

Use this workflow after a feature is functionally complete but before review or merge, to remove avoidable complexity introduced during implementation.

Workflow

1. List changed files: git diff origin/main...HEAD --stat and git diff origin/main...HEAD --name-only.
2. For each meaningful file, ask:
   • Is there an existing helper, type, or constant in the codebase that does this already? Search before adding.
   • Are there abstractions or layers that the change does not actually need yet?
   • Is there error handling for cases that cannot occur?
   • Are there comments restating what the code already says?
   • Are there unused variables, imports, or branches?
3. Apply minimal, behavior-preserving cleanups. Do not rewrite working code for stylistic reasons.
4. Re-run targeted tests for each touched module to confirm behavior is unchanged.

Constraints

• Never introduce new abstractions during simplify — that is a separate refactor task.
• Preserve public APIs and observable behavior exactly.
• If a cleanup is risky, propose it in the final report instead of applying it.

Final Report

Include:

• files cleaned up
• specific reductions (lines removed, helpers reused)
• tests run and result
• proposals not applied (with reasoning)