Architecture

SOFTWARE ARCHITECTURE SKILL

Objective

Understand the current architecture and design a maintainable, secure, scalable and testable architecture.

Inspect

Identify:

• application layers
• modules
• components
• services
• database
• APIs
• state
• routing
• authentication
• authorization
• external integrations
• deployment

Document

Create/update:

docs/ARCHITECTURE.md

Include:

1. Architecture Goals
2. Current Architecture
3. Current Problems
4. Proposed Architecture
5. Component Architecture
6. Module Boundaries
7. Data Flow
8. State Flow
9. API Flow
10. Authentication Flow
11. Database Design
12. Integration Architecture
13. Error Handling
14. Security Boundaries
15. Scalability
16. Performance
17. Deployment
18. Migration Strategy
19. Architecture Decisions

Rules

Do not recommend a complete rewrite unless evidence justifies it.

Prefer incremental migration.

Respect existing technology unless there is a documented reason to change it.

For every architectural recommendation explain:

Problem Evidence Recommendation Benefit Risk Migration Cost Alternative