What problem does it solve?
It prevents fragile or inconsistent Python changes by forcing a predictable workflow for planning, environment setup, and peer review.
Core Features & Use Cases
- Reproducible environment management: Uses the repository-root
.venv to reduce “works on my machine” issues.
- Plan-first change discipline: Requires an
implementation_plan.md before executing any code changes, improving review quality.
- Review-focused safety checks: Enforces a checklist covering potential issues, explicitly listing affected scripts/modules, and explaining each significant change.
- Code quality standards: Applies PEP 8 plus expectations for logging and error handling, aligned with repository architecture patterns.
Quick Start
Use this skill when preparing to modify Python files so you create an implementation plan, ensure the .venv is active, and run a review checklist that documents affected modules and possible side effects.