What problem does it solve? Writing code that merely works is easy; writing code that stays maintainable across multi-file changes, refactors, and reviews is hard. This Skill gives an AI agent a disciplined engineering framework so code changes match existing conventions, avoid speculative abstractions, and leave the codebase in a safer state. ## Core Features & Use Cases - Design Heuristics: Applies an ordered priority of Separation of Concerns, KISS, YAGNI, DRY, Fail Fast, and SOLID when tradeoffs appear during implementation. - Structured Debugging Model: Enforces reproduce-first debugging, reading actual errors, one-variable-per-attempt fixes, and tests that pin every resolved bug. - On-Demand References: Loads a clean-code checklist before finalizing structural changes and a design-pattern catalog only when a real pattern decision arises. - Use Case: When asked to refactor a tangled service module, the agent reads existing conventions first, makes coherent milestone-sized changes, applies guard clauses and fail-fast validation, and verifies with the project's own tests and formatters. ## Quick Start Ask the agent to refactor the payment module for better separation of concerns and have it validate the result with the project's existing test suite.
