Changelogs โ
What is in here? โ
One file per day that something shipped to dev. โ
- Named
dev/dev-MM.DD.YYYY-v{version}.md, one per release day, in the Keep a Changelog shape:Added,Changed,Fixed,Security,Removed. - Each entry names what changed, why it mattered, and links the pull request it landed in.
- Every file for the current line is under
dev/. The full list is in the sidebar under History, Changelogs.
archived/ holds the production line and the older dev files. โ
- Kept for the record. Read
dev/for anything current.
Who writes these, and when? โ
The changelog is written AFTER work is confirmed complete, not while it is in progress. โ
- That is non-negotiable rule 7 in AGENTS.md. The mechanics, the naming, and the entry format live in CHANGELOG_WORKFLOW.md.
Where else do these show up? โ
The admin portal Dashboard reads the newest days straight out of dev/. โ
- The reading column on
/admin/dashboardparses these files at build time and links each day back here, so the Dashboard and this directory can never disagree about what shipped.