Change Log Template
Version 1 · Publish CHANGELOG_TEMPLATE.md as an individual standard project-start document.
[Project Name] Changelog
Document set version: [x.y.z]
Date: [YYYY-MM-DD]
Rules
- Record meaningful source, config, prompt, workflow, and documentation changes.
- Keep entries newest first.
- Keep entries concise and factual.
- Do not include secrets, API keys, or passwords.
- Do not ask after every user request whether this file should be updated.
- Update it after significant work, when Robert explicitly requests a handover, or as part of a meaningful push/delivery.
- Use one consolidated entry for a logical body of related work; do not add entries for routine questions, small intermediate edits, temporary commits or repeated push attempts.
- If maintaining versioned snapshots, create
CHANGELOG_YYYYMMDD_vXYZ.mdbeside the current changelog.
v[x.y.z] - [YYYY-MM-DD]
- [Changed/added/fixed item.]
- [Changed/added/fixed item.]
- Verification: [commands or checks run.]
- OneDrive sync: [not synced / synced non-data files only / explicitly synced data by request].
v[x.y.z-1] - [YYYY-MM-DD]
- [Previous changed/added/fixed item.]
- Verification: [commands or checks run.]
Entry Format Guidance
Use these verbs where possible:
- Added: new capability, file, config, prompt, command, or workflow.
- Changed: modified existing behavior.
- Fixed: corrected a bug or bad output.
- Removed: deleted obsolete behavior or files.
- Documented: clarified usage, schema, or operational rules.
- Verified: records tests/checks that passed.
Example:
## v0.2.0 - 2026-07-10
- Added `--model` override to single-name review command.
- Changed OpenRouter request handling to omit `response_format` for search-preview models.
- Fixed cost extraction so `OpenRouterCost` stores only the numeric cost.
- Verified with `python -m py_compile ...` and `run.bat review-name --help`.
- OneDrive sync: not synced.