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

792 B

Implementation Tasks

1. Define Convention

  • 1.1 Document @requirement marker syntax
  • 1.2 Define identifier naming guidelines
  • 1.3 Specify marker placement rules
  • 1.4 Add examples of proper usage

2. Create Specification

  • 2.1 Write openspec-conventions spec
  • 2.2 Include requirement marker section
  • 2.3 Add good and bad examples
  • 2.4 Document edge cases

3. Update Existing Specs

  • 3.1 Add @requirement markers to cli-init spec
  • 3.2 Add @requirement markers to cli-update spec
  • 3.3 Add @requirement markers to cli-view spec
  • 3.4 Review and update any other existing specs

4. Documentation

  • 4.1 Update README with marker convention
  • 4.2 Add marker usage to CLAUDE.md
  • 4.3 Create examples for AI assistants