Changelog Observer
Track session context in .changelog/session-YYYY-MM-DD.md.
Log target
- Use
.changelog/session-YYYY-MM-DD.mdfor the current local date. - Create
.changelog/and the session file if they do not exist. - If the session file is new, initialize it from template.md.
- Append new entries in chronological order.
What to log
file-change: after creating, editing, or deleting project files.test-result: after running tests, checks, or validation commands.decision: after making an implementation or architecture decision worth preserving.
Entry rules
- Keep each description short and specific.
- List only directly affected files.
- Use
nonewhen no files were changed. - Do not rewrite earlier entries unless they are incorrect.
Template
Use the markdown structure in template.md for each appended entry.