Files
Tabish Bidiwale 22134a603b feat: add @requirement markers convention for requirement identification
- Define @requirement marker syntax for identifying requirements in specs
- Each marker includes a kebab-case identifier before WHEN/THEN blocks
- Document convention in openspec-conventions spec
- Enables reliable extraction without brittle regex parsing
2025-08-13 14:50:24 +10:00

707 B

Add @requirement Markers for Requirement Identification

Why

Specs contain WHEN/THEN patterns that define system requirements, but extracting these programmatically requires brittle regex parsing that may miss edge cases or break with formatting changes.

What Changes

  • Define @requirement marker convention for identifying key requirements in specs
  • Each marker includes a brief identifier (e.g., @requirement user-register)
  • Markers appear directly before their WHEN/THEN blocks
  • Document convention in openspec-conventions spec

Impact

  • Affected specs: openspec-conventions (new)
  • Affected code: None initially - enables future tooling
  • Breaking changes: None - additive convention only