Files
Tabish Bidiwale fa5df9a329 feat: apply structured spec format to all specifications
- Add Specification Format section to openspec-conventions with:
  - Requirement headers for consistent structure
  - Scenario headers with bold WHEN/THEN/AND keywords
  - Format flexibility for different content types

- Update all CLI command specs to use structured format:
  - cli-init: Convert all behavioral sections
  - cli-list: Apply structured format throughout
  - cli-update: Restructure requirements and edge cases
  - cli-diff: Update all behavior sections
  - cli-archive: Convert complex behaviors to scenarios

- Update openspec-conventions spec itself to follow its own format
- Mark all tasks as completed
2025-08-13 22:26:03 +10:00

909 B

1. Update OpenSpec Conventions Spec

  • 1.1 Add "Specification Format" section to openspec-conventions
  • 1.2 Document structured format with Requirement/Scenario headers
  • 1.3 Define bold keyword usage (WHEN/THEN/AND) for scenarios
  • 1.4 Include examples demonstrating the format within the spec itself

2. Update Documentation

  • 2.1 Update the "Why This Approach" section with structured format benefits
  • 2.2 Ensure spec follows its own format as a demonstration

3. Update Existing Specs

  • 3.1 Update cli-init spec to use structured format in Behavior section
  • 3.2 Update cli-list spec to use structured format in Behavior section
  • 3.3 Update cli-update spec to use structured format in Behavior section
  • 3.4 Update cli-diff spec to use structured format in Behavior section
  • 3.5 Update cli-archive spec to use structured format in Behavior section