Grug Brain

grug-brain is a skill for keeping software decisions simple, local, and easy to change. Use it when architecture, refactors, abstractions, APIs, testing strategy, or performance plans are starting to get more complicated than they need to be, and you want the simplest viable default before adding more layers.

How to install

Install it with the skills CLI from skills.sh:

npx skills add DrSh4dow/grug-brain-skill

When to use it

• reviewing an architecture before it grows extra layers
• pushing back on premature abstraction or generic frameworks
• choosing between monolith vs microservices
• shaping testing strategy around stable boundaries
• sanity-checking performance work before optimizing

Example prompts

• "Use grug-brain to review this refactor plan."
• "Is this service split too complex? Apply the grug-brain lens."
• "Help me simplify this API design before I build it."

License

MIT. See LICENSE.

For the full guidance, see SKILL.md.