# [Component/Feature] Architecture

Last updated: YYYY-MM-DD

Maintenance: When revising this doc you must follow instructions in
@shortcut-revise-architecture-doc.md.

## Overview

[1-2 paragraphs describing what this architecture document covers and why it exists]

**Scope**: [Brief description of what’s in scope vs out of scope]

**Related Documents:**

- [Link to related architecture docs]

- [Link to feature specs or research briefs]

## Terminology

[Define key terms or link to docs that define them]

## Topic 1

**File(s)**: `path/to/main/file.ts`

[High-level description of the architectural solution]

### Key Components

#### 1. [Component Name]

[Description of this component’s responsibility]

```typescript
// Example usage or interface
```

**What it does:**

1. [Responsibility 1]

2. [Responsibility 2]

**Benefits:**

- [Benefit 1]

- [Benefit 2]

## Implementation

**Created**: `path/to/files` (Month Year)

- [List of new files or functions created]

**Migrated from**: `path/to/old/files` (if applicable)

- Removed: [List deprecated code]

## Architecture Diagram

```
[ASCII diagram showing component relationships and data flow]
```

## Usage Guidelines

### DO: [Best Practices]

```typescript
// ✅ CORRECT: Example of proper usage
```

### DON’T: [Anti-patterns]

```typescript
// ❌ WRONG: Example of what to avoid
```

## References

[Key links to relevant docs, APIs, libraries, etc.]
