# Architecture Design

> Design system architecture with components, data flow, and boundaries. Use for non-trivial features.

- Skill: `amattas/architecture-design` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add amattas/architecture-design`
- Raw SKILL.md: https://api.skillmd.com/api/skills/amattas/architecture-design/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: amattas (https://skillmd.com/u/amattas)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/amattas/architecture-design

---


# Architecture Design

Design the component structure and interactions for a feature or system.

## Process

1. Review spec.md requirements
2. Identify components and their responsibilities
3. Define data flow between components
4. Establish boundaries (APIs, databases, external services)
5. Document patterns and trade-offs

## Output

Create `architecture.md` using the template in `templates/architecture.md`.

## Tips

- Use Mermaid diagrams for visual clarity
- Keep components single-responsibility
- Consider existing patterns in the codebase
- Document why decisions were made, not just what
- Identify integration points with existing code