mirror of
https://github.com/Fission-AI/OpenSpec.git
synced 2026-09-14 20:16:53 +08:00
Tabish Bidiwale
25 lines
1.0 KiB
Markdown
25 lines
1.0 KiB
Markdown
# Adopt Future State Storage for OpenSpec Changes
|
|
|
|
## Why
|
|
|
|
The current approach of storing spec changes as diff files (`.spec.md.diff`) creates friction for both humans and AI. Diff syntax with `+` and `-` prefixes makes specs hard to read, AI tools struggle with the format when understanding future state, and GitHub can't show nice comparisons between current and proposed specs in different folders.
|
|
|
|
## What Changes
|
|
|
|
- Change from storing diffs (`patches/[capability]/spec.md.diff`) to storing complete future state (`specs/[capability]/spec.md`)
|
|
- Update all documentation to reflect new storage format
|
|
- Migrate existing `add-init-command` change to new format
|
|
- Add new `openspec-conventions` capability to document these conventions
|
|
|
|
|
|
|
|
## Impact
|
|
|
|
- Affected specs: New `openspec-conventions` capability
|
|
- Affected code:
|
|
- openspec/README.md (lines 85-108)
|
|
- docs/PRD.md (lines 376-382, 778-783)
|
|
- docs/openspec-walkthrough.md (lines 58-62, 112-126)
|
|
- openspec/changes/add-init-command/ (migration needed)
|
|
|