# Architecture
Status: DRAFT | Owner: [name] | Reviewed: [date] | PRD revision: [id]

## Current vs proposed
- Evidence inspected (paths):
- Existing system:
- Proposed changes and reasons:

## Stack and runtime
| Layer | Choice / version source | Reason | Constraint |
| --- | --- | --- | --- |
| [layer] | [manifest/lockfile or proposal] | [reason] | [constraint] |

## Boundaries and data flow
- Client responsibilities:
- Server responsibilities:
- Persistence and external services:
- Authentication/authorization boundary:

## Folder ownership
- [Path]: [responsibility; existing or planned]

## User Flow & Navigation
- [Entry -> action -> result]
- Loading / empty / error / permission states:

## Interfaces
- [Method/path or server action]: input, output, access, errors, retries
- Link to schema.md:

## AI Agent Architecture
- None, or: purpose, inputs, outputs, tools, approval gates, limits, fallback

## Operations
- Environment names only:
- Local/test/production separation:
- Performance targets and measurement method:
- Logging, failure handling and rollback:

## Decisions and open questions
- [Choice, rationale, alternative, date, owner, status]