React Gradual Architecture

Lightweight guidance for organizing React code without over-structuring. The core idea: start small, minimum necessary (one file), extract only when it improves clarity or reuse. Contains 12 rules across 5 categories, prioritized by when to apply them in the development lifecycle.

When to Use This Skill

Reference these guidelines when:

• Creating new React features or components
• Organizing component files and folders
• Refactoring a growing component
• Deciding when to extract hooks, UI, or utils
• Structuring feature directories and shared code
• Creating feature documentation (README.md)

Rule Categories by Priority