# Pattern: [Pattern Name]

## Metadata

| Field | Value |
|-------|-------|
| **Category** | api / data / ui / testing / security / performance |
| **Created** | YYYY-MM-DD |
| **Updated** | YYYY-MM-DD |
| **Author** | {{AUTHOR_NAME}} |
| **Status** | draft / approved / deprecated |

## Problem

Describe the problem this pattern solves.

- What symptoms indicate this problem?
- What are the consequences of not addressing it?

## Context

When should this pattern be applied?

### Use When

- Condition 1
- Condition 2
- Condition 3

### Don't Use When

- Condition 1
- Condition 2

## Solution

### Overview

Brief description of how the pattern works.

### Structure

```
[Diagram or structure description]
```

### Implementation Steps

1. Step 1
2. Step 2
3. Step 3

## Code Example

### Basic Usage

```{{LANGUAGE}}
// Example code demonstrating the pattern
```

### Advanced Usage

```{{LANGUAGE}}
// More complex example with edge cases
```

### Anti-Pattern (What NOT to Do)

```{{LANGUAGE}}
// Example of incorrect implementation
// Explain why this is wrong
```

## Codebase References

Where this pattern is used in our codebase:

| Location | Description |
|----------|-------------|
| `path/to/file.ext:123` | Brief description |
| `path/to/other.ext:456` | Brief description |

## Consequences

### Benefits

- Benefit 1
- Benefit 2
- Benefit 3

### Trade-offs

- Trade-off 1
- Trade-off 2

### Risks

- Risk 1 and mitigation
- Risk 2 and mitigation

## Related Patterns

| Pattern | Relationship |
|---------|--------------|
| [Pattern Name](./path.md) | How they relate |
| [Pattern Name](./path.md) | How they relate |

## References

- [External resource]()
- [Documentation]()
- [Original source]()

---

## Revision History

| Date | Author | Changes |
|------|--------|---------|
| YYYY-MM-DD | Name | Initial version |