Reshape code for readability, naming, structure, TODOs, and reduced surface area across any language
Reshape code quality across eight dimensions. Scope to branch changes by default (git diff main...HEAD), or accept explicit file/directory targets.
Philosophy: Write code for the next reader (human or agent). Minimize cognitive load. Prefer boring, obvious code over clever code. Every change must preserve business logic unless explicitly told otherwise.
git diff main...HEAD --name-onlygit diff --cached --name-onlyreferences/python.md for language-specific guidance.file_path:line_number.data, temp, result, x, val, info without contextrepo/repository, config/configuration)if not items: over if len(items) == 0, but never at the cost of clarityis_valid, has_permission, should_retrymap/filter in JS where idiomatic)Apply the project's TODO prefix standards:
TODO: — general future workTODO_IMPROVE: — code quality improvementsTODO_OPTIMIZE: — performance improvementsTODO_TECHDEBT: — technical debt to address laterTODO_REVISIT: — design decisions that may need revisitingTODO_IDEA: — potential features to considerTODO_IN_THIS_PR: — must complete before mergeTODO_REMOVE_LATER: — temporary code with removal conditionFIXME: — known bugsHACK: — temporary workaroundsEach TODO must include:
Add missing TODOs for: known shortcuts, deferred work, temporary workarounds, and obvious improvement opportunities spotted during review. Remove stale or resolved TODOs.
# increment counter above counter += 1)IMPORTANT, NOTE, CRITICAL, DEV_NOTE markers — clean up the text, not the tagFor each file changed, show:
### file_path
**Changes made:**
- [dimension] description of change (line X)
- [dimension] description of change (line Y)
End with a summary: files touched, lines removed, TODOs added/removed, helpers extracted.