architecture-principles

What problem does it solve?

Provides concise, actionable architecture and design guidance to avoid fragile, tightly-coupled code and to make codebases easier to understand, modify, and automate with AI-assisted tooling.

Core Features & Use Cases

• Function Design & Naming: Guidance on single responsibility, purity, and descriptive names to make functions predictable and testable.
• Module/File Design & API Surface: Advice on small focused files, minimal public APIs, and grouping by domain to reduce cognitive load.
• Decoupling & Composition: Patterns for dependency injection, avoiding circular dependencies, and composing simple functions into robust behavior.
• AI-Readability: Recommendations to structure code and naming so AI tools can more reliably edit, refactor, and reason about the code.
• Use Case: Apply these principles when refactoring a legacy feature to improve testability, reduce bugs, and enable safe AI-assisted edits.

Quick Start

Ask the agent to review the user module and propose concrete refactorings that apply single responsibility, improve decoupling, and optimize AI-readability.