Kiro Spec File

A .kiro/specs/[feature-name].md file that defines the requirements, design, and constraints for a single feature. Used as the authoritative source when instructing Bolt to implement a feature — creates an auditable implementation trail.

Syntax

bolt-new

# Feature: [Name]

## Requirements
- [Testable requirement 1]
- [Testable requirement 2]

## Design
[Description of UI/UX behavior and visual layout]

## Technical Notes
[Implementation constraints, library choices, or hints]

## Out of Scope
[What this feature does NOT include]

Example

bolt-new

# Feature: Task Filtering

## Requirements
- User can filter by status: All, Active, Complete
- User can filter by priority: All, Low, Medium, High
- Filters are combinable
- Filter state persists in URL params
- Filtered results show matching task count

## Design
- Filter controls above task list as horizontal bar
- Status: 3 segmented buttons
- Priority: 4 pill toggles (independent)
- Active filters highlighted in blue-600
- "Clear filters" link appears when any filter active

## Technical Notes
- Client-side filtering only (no Supabase query changes)
- URL params: ?status=active&priority=high

## Out of Scope
- Saved filter presets
- Date range filtering