# Specifications

This folder contains feature specifications and their implementation plans.

## Structure

Each feature has:
- `<feature>.md` - Specification document
- `<feature>-implementation-plan.md` - Implementation tasks

## Spec Template

```markdown
<!--
Copyright (c) 2025 {{projectName}}. All rights reserved.
SPDX-License-Identifier: Proprietary
-->

# Feature Name Specification

**Status:** Planned | In Progress | Completed
**Version:** 1.0
**Last Updated:** YYYY-MM-DD

## Purpose
[One paragraph explaining why this feature exists]

## User Stories
- As a [user], I want [action] so that [benefit]

## Requirements
- [ ] Requirement 1
- [ ] Requirement 2

## Technical Notes
- Uses: [existing patterns/components]
- Location: [where code should live]

## Visual Requirements
(For UI features - delete if backend-only)
- **Layout:** [Grid/Stack/Sidebar, responsive behavior]
- **Components:** [shadcn components to use]
- **Chart Types:** [If applicable]
- **States:** [Empty, loading, error handling]
- **Mobile:** [What changes on small screens]
- **Reference:** [Similar page in app or shadcn docs]

## Acceptance Criteria
- [ ] Criteria 1
- [ ] Criteria 2
```

## Active Specs

| Spec | Status | Last Updated | Implementation Plan |
|------|--------|--------------|---------------------|
| (Your specs will appear here) | Planned | YYYY-MM-DD | - |