ai-era-architecture-principles

What problem does it solve?

Traditional software architecture decisions often struggle to balance the use of large frameworks against custom implementations in the Claude Code era, leading to dependency bloat, opacity, and slower delivery.

Core Features & Use Cases

• Decision principles: Micro-Dependencies Principle, Perfect Fit Principle, and Full Control Principle to guide framework choices.
• Framework vs. custom decision matrix: structured steps to assess dependencies, risk, and maintainability.
• Real-world guidance: practical example comparing LangChain-like solutions and domain-specific abstractions (pdf2anki) to illustrate trade-offs.
• When to use or avoid large frameworks: criteria to decide whether a framework adds value or unnecessary complexity.

Quick Start

Review the Three Principles and apply the decision framework to your Claude Code project to determine whether a large framework or a custom implementation best fits your needs.