skills/fission-ai__openspec
1
0
Fork 0
mirror of https://github.com/Fission-AI/OpenSpec.git synced 2026-09-14 20:16:53 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
add-complexity-guidelines
fission-ai__openspec/openspec/changes/adopt-future-state-storage/proposal.md
T
Tabish Bidiwale 6b8845b10a remove any updates to the proposal format
2025-08-06 15:42:19 +10:00

1.0 KiB
Raw Permalink Blame History

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)
Reference in New Issue View Git Blame Copy Permalink