Adopt date-prefixed ADR filenames#1835
Merged
Merged
Conversation
Name ADRs YYYYMMDD-kebab-title.md instead of a sequential 0001-style number. The date prefix stays sortable while avoiding the renumbering churn two branches hit when each adds an ADR from its own branch point. Refer to ADRs by their slug.
5 tasks
5 tasks
kmcginnes
added a commit
that referenced
this pull request
Jun 16, 2026
* Add ADRs for cross-tab persistence reconciliation strategy Record the two architectural decisions governing the fix for #1820: - IndexedDB (via localForage), not localStorage, for client-side persistence — Session and Schema payloads exceed localStorage's ~5MB limit, a constraint invisible in the code. - Per-key diff-merge reconciliation at the storage layer, scoped to durability only; same-entry conflicts and live cross-tab freshness are explicitly deferred. ADRs use the date-prefixed naming convention (#1835) and reference each other by slug. * Add core rule against hard-wrapping Markdown prose
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Establishes the ADR file-naming convention for the repo:
YYYYMMDD-kebab-title.md, where the date is when the decision was accepted.The previous example in
docs/agents/domain.mdimplied sequential0001-…numbering. Sequential IDs force a renumber whenever two branches each add an ADR from their own branch point — the second to merge collides on the same number. A date prefix stays sortable chronologically while sidestepping that churn. ADRs are referred to by their slug (e.g.event-sourced-orders).Docs-only change to
docs/agents/domain.md— updates the file-structure example and the reference style. No ADR files are added here; this just sets the naming standard so feature branches can follow it.Validation
pnpm checks(format) passes.Related Issues
Check List
pnpm checkspasses with no errors.pnpm testpasses with no failures.