improve-architecture

name	improve-architecture
description	Refactoring phase. Identifies opportunities to make the codebase more modular and AI-friendly. Trigger: "/improve-codebase-architecture", "improve architecture", "refactor for better structure".

Improve Architecture Skill

Analyze the codebase for "deepening" opportunities and modularity.

Focus Areas

1. Decoupling: Reduce tight coupling between unrelated modules.
2. Abstractions: Introduce clean interfaces for external dependencies.
3. AI-Navigability: Structure the code so it's easier for AI agents to understand and edit safely.
4. DRY (Don't Repeat Yourself): Consolidate duplicate logic into reusable components.

Rules

• Prioritize readability and maintainability over clever optimizations.
• Suggest incremental refactors that don't break existing functionality.
• Document the "Why" behind each architectural change.