python-plan-optimization

This skill analyzes Python code blocks embedded in Markdown planning files to identify design-principle violations, code smells, and modernization opportunities. It performs a read-only 6-phase analysis that flags SOLID, DRY, KISS, and YAGNI violations without modifying source files, delivering actionable recommendations per document.

Yes. This skill scans planning Markdown documents containing Python code blocks and produces a non-destructive analysis report. It respects your stated architecture and tooling choices, providing recommendations for design improvements while keeping all source files untouched.

The skill identifies opportunities for type hints, dataclasses, and modern Python idioms aligned with your project type—POC, MVP, Private, Enterprise, or Open Source. It also detects common code smells and design-principle violations specific to your project's context and constraints.

The analysis applies project-type thresholds (POC through Open Source) and respects explicit architectural decisions documented in your planning files. Recommendations are calibrated to your project's maturity level and toolchain, not imposed uniformly across all contexts.

Provide planning Markdown documents with embedded Python code blocks. The skill reads these files to detect design opportunities and generate per-document analyses with a summary report. No additional setup or source code files are required.

Use this skill during planning phases to surface design-debt opportunities before implementation, or to validate architectural decisions in existing documentation. It's a read-only analysis tool best suited for identifying patterns and gathering data to inform future refactoring decisions.