# Architecture: {{project_name}}

## Overview
High-level description of the system: purpose, main users, and key constraints.

## Components

| Component | Responsibility | Tech |
|-----------|----------------|------|
| [Frontend/API/Worker] | [Brief responsibility] | [Stack] |

## Data Flow
- Describe request/response paths.
- Note async flows (queues, events) if any.

## Deployment
- **Runtime**: [Docker / K8s / Serverless]
- **Environments**: dev, staging, prod
- **Secrets**: env vars / vault; never in repo.

## Decisions
- **ADR-001**: [Title] – [One-line summary and link or short rationale.]

## Diagrams
Use Mermaid in this doc or link to `docs/diagrams/`. Keep node IDs safe (no spaces, quoted labels).