# Architecture Documentation - {{project_name}}

System architecture and design decisions for {{project_name}}.

---

## Table of Contents

- [System Overview](#system-overview)
- [Architecture Pattern](#architecture-pattern)
- [Component Diagram](#component-diagram)
- [Data Flow](#data-flow)
- [Technology Decisions](#technology-decisions)
- [Security Architecture](#security-architecture)
- [Scalability](#scalability)
- [Architecture Decision Records](#architecture-decision-records)

---

## System Overview

{{system_overview}}

**Architecture Pattern:** {{architecture_pattern}}

---

## Architecture Pattern

{{architecture_pattern_description}}

### Layers

{{layers_description}}

---

## Component Diagram

```mermaid
{{component_diagram}}
```

### Component Responsibilities

{{component_responsibilities}}

---

## Data Flow

### Key Workflows

#### {{workflow_1_name}}

```mermaid
{{workflow_1_sequence_diagram}}
```

{{workflow_1_description}}

---

## Technology Decisions

{{tech_stack_rationale}}

### Technology Stack

| Component | Technology | Rationale |
|-----------|------------|-----------|
{{tech_stack_table}}

---

## Security Architecture

{{security_architecture_description}}

### Authentication

{{authentication_architecture}}

### Authorization

{{authorization_architecture}}

### Data Protection

{{data_protection}}

---

## Scalability

### Horizontal Scaling

{{horizontal_scaling}}

### Performance Considerations

{{performance_considerations}}

---

## Architecture Decision Records

{{adr_list}}

For complete ADRs, see [devforgeai/specs/adrs/](../devforgeai/specs/adrs/).

---

**Last Updated:** {{last_updated}}
**Version:** {{version}}
