reflect
Installation
SKILL.md
Reflect
The first implementation is a draft. Now that the code exists, review and re-think whether it was done in the best way. Ask questions of the code and context. Act on improvements that do not depend on a product decision. Raise the rest.
Goal: a higher-quality first pass before the user looks in detail. This is not a code review. Formal review comes later.
"Best" means:
- Simplest solution that solves the problem
- The domain model is clearly expressed
- Coherent and consistent with the existing codebase
- Re-uses existing objects, helpers, conventions when appropriate
- Isn't contorted around existing code that wasn't built with the new requirements in mind
- Comments explain the intent and rationale for the code
- Raises the average quality of the codebase, sets examples that others can follow
- The right long-term architecture, not the smallest change