grug-brain-development

What problem does it solve?

This Skill helps you simplify software decisions and code by fighting unnecessary complexity, premature abstraction, and scattered logic that makes maintenance and debugging painful.

Core Features & Use Cases

• Code review for complexity: Use it when you suspect over-engineering, clever but confusing abstractions, or “too many layers” that obscure what the code actually does.
• Architecture decision guidance: Use it to choose simple, concrete designs (often “monolith first”), and to identify natural cut points only after real patterns emerge.
• Refactoring principles to reduce mental load: Apply locality of behavior, keep expressions debuggable, respect existing code as “Chesterton’s fence,” and keep refactors small so the system stays working.

Use Case Examples

• You’re reviewing a PR that introduces multiple layers of generic types and interfaces for a problem that only has one or two real use cases.
• You need to refactor a feature where one button click now requires jumping across many files and concepts to understand behavior.
• You’re deciding whether to extract services, build reusable frameworks, or keep a simple 80/20 implementation until more evidence exists.

Quick Start

Use the grug-brain-development skill when you are looking to simplify code or reduce complexity so the solution is easier to debug and maintain.