/technical-deslop

Technical Deslop

Purpose

Clean branch/staged diffs by removing AI-style slop and restoring repo-consistent style without changing behavior.

When to use

• A diff feels over-explained, overly defensive, or inconsistent with surrounding code.
• You need a final cleanup pass before review/PR.
• You want to normalize style after automated generation.

Workflow

1. Capture scope with git diff --cached and git diff $(git merge-base origin/main HEAD)..HEAD.
2. Focus only on changed hunks (or user-scoped files).
3. Apply the cleanup sequence in references/playbook.md.
4. Remove slop patterns: redundant comments, unnecessary defensive branches, non-idiomatic casts, and style drift.
5. Re-check behavior boundaries: no logic changes unless the user explicitly requested them.
6. Report a short 1-3 sentence summary of cleanup performed.

Read references/slop-patterns.md for detection rules and references/playbook.md for execution order.

Inputs

• Optional file scope (FILES) or explicit user file targets.
• Current branch diff and staged diff.
• Repository conventions from local instructions/config.

Outputs

• Behavior-preserving cleanup in touched files.
• Minimal summary of what was normalized and where.