053-design-simple-rules

Featured

Use when Java design, refactoring, or implementation tradeoffs should be evaluated with Kent Beck's simple design rules, including passes the tests, reveals intention, has no duplication, and has the fewest elements. This should trigger for requests such as Apply simple design rules; Review this design with Beck's rules; Choose between these refactoring options; Keep this Java design simple. Part of Plinth Toolkit

Code & Development 423 stars 89 forks Updated 3 days ago Apache-2.0

Install

View on GitHub

Quality Score: 93/100

Stars 20%
87
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Simple Design Rules Guide Java developers through Kent Beck's simple design rules when evaluating design and refactoring choices. **This is an interactive SKILL**. **What is covered in this Skill?** - Using tests as the first correctness boundary before design cleanup - Revealing intention and maximizing clarity before abstraction pressure - Reducing duplication without hiding domain meaning or worsening readability - Treating fewer elements as the final simplification pressure after correctness, clarity, and duplication - Comparing Java design and refactoring options with the ordered rules - Reporting the chosen option, tradeoffs, validation signal, and remaining risk ## Constraints Apply simple design rules in priority order, and do not optimize later rules by weakening earlier rules. - **MUST** read `references/053-design-simple-rules.md` before applying the rules - **MUST** evaluate the rules in this order: passes the tests, reveals intention, has no duplication, has the fewest elements - **MUST** treat passing tests as the correctness boundary before design cleanup - **MUST** prefer clear intention over abstraction for its own sake - **MUST** reduce duplication only when the result preserves or improves clarity - **MUST** consider fewer elements only after correctness, clarity, and duplication have been addressed ## When to use this skill - Apply simple design rules - Use Beck's simple design rules - Review this design with simple design rules - Choose between ...

Details

Author
jabrena
Repository
jabrena/plinth
Created
1 years ago
Last Updated
3 days ago
Language
Java
License
Apache-2.0

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

Web & Frontend Featured

054-design-tdd

Use when Java implementation work should be guided by Test-Driven Development, including maintaining a test list, choosing the next behavior, writing a failing test first, implementing only enough production code to pass, and refactoring while keeping tests green. This should trigger for requests such as Apply TDD; Use test-driven development; Drive this Java change with tests; Write the failing test first; Red-green-refactor this feature. Part of Plinth Toolkit

423 Updated 3 days ago
jabrena
Code & Development Listed

code-design-refactor

Design-level refactoring rules — extraction, decoupling, SRP, encapsulation, primitive obsession. Language-agnostic. Sits between logic-cleaner (expression-level) and improve-codebase-architecture (system-level). Use when restructuring existing code at the module/class/function level.

2 Updated 3 days ago
ralvarezdev
AI & Automation Featured

122-java-type-design

Use when you need to review, improve, or refactor Java code for type design quality — including establishing clear type hierarchies, applying consistent naming conventions, eliminating primitive obsession with domain-specific value objects, leveraging generic type parameters, creating type-safe wrappers, designing fluent interfaces, ensuring precision-appropriate numeric types (BigDecimal for financial calculations), and improving type contrast through interfaces and method signature alignment. This should trigger for requests such as Review Java code for type design; Improve type design in Java code; Fix primitive obsession in Java code; Create value objects in Java code. Part of Plinth Toolkit

423 Updated 3 days ago
jabrena