# Feature Specification Template

> Reference from SKILL.md: `See [references/specification-template.md](references/specification-template.md)`

---

## Specification Structure

```markdown
# Feature Specification: {Feature Title}

> Feature ID: FEATURE-XXX  
> Version: v1.0  
> Status: Refined  
> Last Updated: MM-DD-YYYY

## Version History

| Version | Date | Description |
|---------|------|-------------|
| v1.0 | MM-DD-YYYY | Initial specification |

## Linked Mockups

| Mockup | Type | Path | Description |
|--------|------|------|-------------|
| Dashboard Main | HTML | [mockups/dashboard-v1.html](mockups/dashboard-v1.html) | Main dashboard layout |

> **Note:** UI/UX requirements below are derived from these mockups.

## Overview
[2-3 paragraph description: what, why, who]

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

## Acceptance Criteria
[Testable, measurable conditions]

## Functional Requirements
[FR-N: Requirement with Input/Process/Output]

## Non-Functional Requirements
[Performance, Security, Scalability]

## UI/UX Requirements
[Wireframes, User Flows, UI Elements]

## Dependencies
[Internal and External]

## Business Rules
[BR-N: Clear rule statements]

## Edge Cases & Constraints
[Scenarios with expected behavior]

## Out of Scope
[What is NOT included]

## Technical Considerations
[Hints for technical design - WHAT not HOW]

## Open Questions
[What needs clarification]
```

---

## Version History Rules

MANDATORY: Maintain ONE specification file per feature with version history inside.

- Keep single `specification.md` file with Version History table
- Do NOT create versioned files like `specification-v2.md`
- Increment version in document header (v1.0 -> v2.0)
- Update content in place with new version

---

## Specification Quality Checklist

- [ ] All acceptance criteria are testable
- [ ] User stories provide clear value
- [ ] Functional requirements are complete
- [ ] Non-functional requirements defined
- [ ] Dependencies clearly stated
- [ ] Edge cases identified
- [ ] Out of scope explicitly listed
- [ ] Mockups linked and analyzed (if applicable)
