# Feature: [Feature Name]

> Living documentation for the [feature name]

**Status:** [Draft | In Development | Production]
**Version:** [Version number]
**Last Updated:** [Date]

---

## Overview

[High-level description of what this feature does and why it exists]

**Key Capabilities:**
- [Capability 1]
- [Capability 2]
- [Capability 3]

## Current Implementation

### How It Works Today

[Describe the current behavior from user and system perspective]

### Architecture Overview

[Technical architecture - components, data flow, integration points]

```
[Optional ASCII diagram of architecture]
```

### Key Components

**[Component 1]:**
- Location: `[file path]`
- Purpose: [What it does]
- Key functions: [List]

**[Component 2]:**
- Location: `[file path]`
- Purpose: [What it does]
- Key functions: [List]

## Usage

### Basic Usage

[How to use this feature - commands, API calls, etc.]

```[language]
[Code example]
```

### Advanced Usage

[More complex scenarios]

```[language]
[Code example]
```

## API Reference

### [Function/Endpoint 1]

**Signature:** `[function signature or HTTP endpoint]`

**Parameters:**
- `[param1]` ([type]): [Description]
- `[param2]` ([type]): [Description]

**Returns:** [Return type and description]

**Example:**
```[language]
[Usage example]
```

### [Function/Endpoint 2]

[Same structure...]

## Business Rules & Edge Cases

### Business Logic
- **[Rule 1]:** [Description and behavior]
- **[Rule 2]:** [Description and behavior]

### Edge Cases
- **[Edge case 1]:** [How the system handles it]
- **[Edge case 2]:** [How the system handles it]

### Validation Rules
- [Validation 1]
- [Validation 2]

## Testing

### Test Coverage
- Unit tests: [Location and coverage %]
- Integration tests: [Location and coverage %]

### Key Test Scenarios
- [Scenario 1]
- [Scenario 2]

## Dependencies

### Required Dependencies
- [Dependency 1]: [Version and purpose]
- [Dependency 2]: [Version and purpose]

### Integration Points
- [System/Module 1]: [How it integrates]
- [System/Module 2]: [How it integrates]

## Performance & Scalability

[Performance characteristics, limits, optimization notes]

## Security & Compliance

[Security considerations, data handling, compliance requirements]

## Future Enhancements

[Planned improvements, known limitations, roadmap items]

## Related Documentation

- [Link to related features]
- [Link to guides]
- [Link to API docs]

---

*Last updated: [Date] | Status: [Status] | Version: [Version]*
