sandi-metz

What problem does it solve?

Provides a disciplined, test-first workflow for designing and refactoring object-oriented code using Sandi Metz principles so teams can change behavior safely, reduce long methods and large classes, and keep codebases easy to extend.

Core Features & Use Cases

• Build or Refactor Modes: Decide whether to build a new component from tests (Shameless Green) or iteratively refactor existing code based on file/class input or recent git churn.
• TDD-Driven Rounds: Enforces red → green → refactor cycles, writing minimal tests first, making the smallest change to pass, and then cleaning up with one small refactoring per round.
• Rule-Guided Assessment: Automatically assess rule violations and code smells (class length, method length, parameter counts), propose a safe refactoring sequence, and summarize each round with metrics.
• Practical Safety Nets: Requires a green test baseline before refactoring, uses git diffs and greps to scope work, and includes revert guidance if tests break.

Quick Start

Ask the skill to refactor by supplying a file path or class name, or describe a new feature to build from tests.