# Architecture

> Analyze, design and improve software architecture without unnecessary rewrites.

- Skill: `roadofriot/architecture` (Agent Skill)
- Install (CLI): `npx skillmds@latest add roadofriot/architecture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/roadofriot/architecture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: roadofriot (https://skillmd.com/u/roadofriot)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/roadofriot/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