You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Moved from issue #1192, originally opened by @victormacaubas on 2026-06-09. Continuing the conversation here in Discussions — the original issue thread (including any comments) stays available at #1192 for the record.
Hey all! Been using OpenSpec daily and ran into a small gap I wanted to flag
Problem
Archive folders use YYYY-MM-DD-[change-name]. When you archive multiple changes in one day, you lose the order they were completed in.
Here's what today looked like for me, five changes, no way to tell which came first:
These just sort alphabetically. If I come back next month, I can't tell which change I implemented first without checking git log.
Why this matters
The spec says date-prefixing "maintains chronological order," but that only holds at day-level granularity. Within a single day, the ordering is gone.
If you're shipping multiple changes per day (common during sprints or when working through stacked changes), you lose the sequence. The only workaround is checking git log for the archive commits, which defeats the point of a self-documenting folder structure.
Possible approaches
Sequence counter in the folder name: 2026-06-09-01-contextual-help-and-copy-fixes. Minimal, sorts correctly with ls.
ISO timestamp in the folder name: 2026-06-09T14-32-contextual-help-and-copy-fixes. More precise but noisier.
Metadata only: add an archivedAt ISO timestamp inside the archived .openspec.yaml, keep folder names as-is. Least disruptive but you have to read files to see the order.
Interested to hear your thoughts on which approach fits best with the project's direction.
Thanks for building this amazing tool! it's become a core part of how I work. Happy to open a PR for this myself if you're open to it.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
Note
Moved from issue #1192, originally opened by @victormacaubas on 2026-06-09. Continuing the conversation here in Discussions — the original issue thread (including any comments) stays available at #1192 for the record.
Hey all! Been using OpenSpec daily and ran into a small gap I wanted to flag
Problem
Archive folders use
YYYY-MM-DD-[change-name]. When you archive multiple changes in one day, you lose the order they were completed in.Here's what today looked like for me, five changes, no way to tell which came first:
These just sort alphabetically. If I come back next month, I can't tell which change I implemented first without checking git log.
Why this matters
The spec says date-prefixing "maintains chronological order," but that only holds at day-level granularity. Within a single day, the ordering is gone.
If you're shipping multiple changes per day (common during sprints or when working through stacked changes), you lose the sequence. The only workaround is checking git log for the archive commits, which defeats the point of a self-documenting folder structure.
Possible approaches
2026-06-09-01-contextual-help-and-copy-fixes. Minimal, sorts correctly withls.2026-06-09T14-32-contextual-help-and-copy-fixes. More precise but noisier.archivedAtISO timestamp inside the archived.openspec.yaml, keep folder names as-is. Least disruptive but you have to read files to see the order.Interested to hear your thoughts on which approach fits best with the project's direction.
Thanks for building this amazing tool! it's become a core part of how I work. Happy to open a PR for this myself if you're open to it.
All reactions