applying-code-principles
Fundamental software principles - SOLID, DRY, Occam's Razor, Miller's Law, YAGNI, Readable Code. Use when applying design principles, refactoring code, or when user mentions 原則, シンプル, 複雑, リファクタリング, 保守性, clean code, best practice.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Code Principles
Priority Order
| Priority | Principle | When to Apply |
|---|---|---|
| 1 | Safety First | Security, data integrity |
| 2 | YAGNI | Don't build what you don't need |
| 3 | Occam's Razor | Simplest solution |
| 4 | SOLID | For complex systems |
| 5 | DRY | Eliminate duplication (not at cost of clarity) |
| 6 | Miller's Law | Respect 7±2 cognitive limit |
Quick Checks
See CLAUDE.md Development Checks section (always loaded, single source of truth).
Thresholds
| Target | Ideal | Max | Limit |
|---|---|---|---|
| Function args | 3 | 5 | 7 |
| Class methods | 5 | 7 | 9 |
| Conditionals | 3 | 5 | 7 |
Rules
| Principle | Rule |
|---|---|
| DRY | Abstract on 3rd duplication (Rule of Three) |
| SOLID | Interface only when 2nd implementation appears |
| YAGNI | Build only if problem exists now |
| Readable | New team member understands in < 1 minute |
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!