---
# =============================================================================
# REQUIREMENTS SPECIFICATION
# =============================================================================
# Schema Version: 1.0 (STORY-435)
# Purpose: Structured requirements for cross-session AI consumption
#
# IMPORTANT: This YAML frontmatter contains ALL structured data.
# The markdown body below is for human readability only - do not duplicate data.

schema_version: "1.0"
document_id: "REQ-XXX"
title: "[Project/Feature Title]"
created: "YYYY-MM-DD"
last_updated: "YYYY-MM-DD"
status: "Draft"

# DECISIONS (locked choices with excluded options)
decisions:
  - id: "DR-1"
    domain: "[domain]"
    decision: "[The chosen approach - no hedging language]"
    rejected:
      - option: "[Alternative not chosen]"
        reason: "[Why this was rejected]"
    rationale: "[Why this choice was made]"
    locked: true

#
# SCOPE (explicit boundaries with deferral targets)
#
scope:
  in:
    - "[Feature/requirement included]"
  out:
    - item: "[Feature/requirement excluded]"
      deferral_target: "[Phase 2|Post-MVP|Never]"

#
# SUCCESS CRITERIA (quantified, measurable)
#
success_criteria:
  - id: "SC-1"
    metric: "[What to measure]"
    target: "[Quantified target with numbers/comparators]"
    measurement: "[How to verify]"

#
# CONSTRAINTS (technical, business, regulatory)
#
constraints:
  - type: "technical"
    constraint: "[Constraint statement]"
    source: "[Reference/source]"

#
# NON-FUNCTIONAL REQUIREMENTS
#
nfrs:
  - category: "performance"
    requirement: "[NFR statement]"
    priority: "High"

#
# STAKEHOLDERS
#
stakeholders:
  - role: "[Role/Title]"
    goals:
      - "[Goal 1]"
    decision_authority:
      - "[Decision area]"

#
# PROVENANCE
#
source_brainstorm: "BRAINSTORM-XXX"

---

# Requirements: [Project/Feature Title]

## Overview

This document captures the structured requirements produced by the ideation phase.
All data is stored in the YAML frontmatter above for cross-session AI consumption.

## Reading This Document

- **Decisions:** See `decisions` in frontmatter - locked choices with explicit excluded options
- **Scope:** See `scope.in` (included) and `scope.out` (excluded with deferral targets)
- **Success Criteria:** See `success_criteria` - quantified metrics with targets
- **Constraints:** See `constraints` - technical, business, regulatory limits
- **NFRs:** See `nfrs` - performance, security, scalability requirements
- **Stakeholders:** See `stakeholders` - roles, goals, decision authority

## Next Steps

1. Review locked decisions in frontmatter
2. Validate scope boundaries
3. Proceed to `/create-epic` with this requirements document

---

*Generated by spec-driven-ideation skill | Schema v1.0*
