From e47d524d32ed0271cdddebb1a2531452cb9c8eb2 Mon Sep 17 00:00:00 2001 From: Benjamin Borbe Date: Thu, 2 Jul 2026 21:13:24 +0200 Subject: [PATCH] docs(dod): specify CHANGELOG Unreleased placement to prevent malformed changelog --- CHANGELOG.md | 4 ++++ docs/dod.md | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e199863..da0b70f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,10 @@ Please choose versions by [Semantic Versioning](http://semver.org/). * MINOR version when you add functionality in a backwards-compatible manner, and * PATCH version when you make backwards-compatible bug fixes. +## Unreleased + +- docs(dod): specify `## Unreleased` placement in the Definition of Done — must sit below the preamble and above the newest version section, never above the preamble (prevents the malformed-CHANGELOG class of error a dark-factory prompt can otherwise introduce) + ## v0.96.2 - fix(workon): append `--non-interactive` to the headless `claude --print` bootstrap prompt in `handleClaudeSession` to prevent the 5-minute hang when `work-on` command needs input that cannot be answered headlessly diff --git a/docs/dod.md b/docs/dod.md index 5b6dca6..bf8ac91 100644 --- a/docs/dod.md +++ b/docs/dod.md @@ -26,4 +26,4 @@ After completing your implementation, review your own changes against each crite ## Documentation - README.md is updated if the change affects usage, configuration, or setup -- CHANGELOG.md has an entry under `## Unreleased` +- CHANGELOG.md has an entry under `## Unreleased`. If that section does not exist yet, create it **below** the preamble block (the `All notable changes…` line and the `* MAJOR / MINOR / PATCH` lines) and **above** the newest `## vX.Y.Z` section — never between the `# Changelog` title and the preamble. The final order is always: `# Changelog` → preamble → `## Unreleased` → `## vX.Y.Z` (newest first).