What problem does it solve? Working code often accumulates complexity—deep nesting, unclear naming, duplicated logic—that makes it slow and risky to maintain. This Skill provides a disciplined process for reducing that complexity without changing behavior or breaking tests. ## Core Features & Use Cases - Behavior-Preserving Simplification: Applies five principles (preserve behavior, follow conventions, prefer clarity, maintain balance, scope changes) so refactors never drift from existing functionality. - Structured Four-Step Process: Understand the code first, identify concrete complexity signals, apply changes incrementally, and verify the result against tests and conventions. - Repository-Aware Guardrails: Respects AGENTS.md contracts, security invariants, and scaffold truth in the opencode-setup repository, with verification via npm run ci. - Use Case: After landing a feature with nested conditionals and generic variable names, run a simplification pass to flatten logic, rename for clarity, and keep all tests passing unchanged. ## Quick Start Ask the agent to simplify the recently changed module for readability without changing its behavior, then verify tests still pass.
