The changelog is one chronological view of everything that has happened to a project. Open it from the Changelog item in the project rail. Each project has its own.
What lands here
- Specsight syncs — one entry per release that produced spec changes, with added / changed / removed counts.
- Manual edits — when a Member adds, edits, or deletes a scenario by hand.
- Annotations — free-text notes a Member left on a scenario.
- Reviewed entries — a release Specsight analysed where no product behaviour changed. Each carries the commit hash and a short reason, and a run of consecutive reviewed releases collapses into one expandable row.
Filter and search
The toolbar has two controls:
- Source — All, Specsight, Manual, Annotations. Specsight covers both syncs and reviewed releases.
- Search — matches scenario ID, feature name, author, commit hash, a sync’s AI summary, or a reviewed entry’s reason.
The feed groups entries by day. A day header shows the change count, or reads no changes on days where Specsight only reviewed releases without finding one.
The feed loads the most recent page first. When more history exists, Load earlier changes appends the next page in place.
Inside a sync
Click a Specsight sync entry for its detail page: branch, commit, AI summary, and a per-feature breakdown of every scenario that was added, changed, or removed — with before-and-after values for Context, Action, and Outcome on changed scenarios.
Click any scenario to jump to it in the spec.
Highlights
A Highlight is a changed or removed scenario worth a release note to your end users. Specsight flags one when a change affects behaviour existing users rely on, or removes something they could do.
New features, copy tweaks, edge cases, and internal rework are never highlighted. Each Highlight carries one plain sentence explaining what changed and who it affects.
Where Highlights show up
- On the changelog feed — a sapphire badge next to Specsight synced counts the Highlights in that release.
- On the sync detail page — the changed or removed row carries a Highlight badge; hover or focus it for that change’s one-sentence reason.
- On the dashboard — the project card and the Latest release card show the count.
- In the sync email — a Highlights section names each flagged change in the release. Members with Sync complete turned on receive it.
- In Ask Specsight and through the MCP server — changelog entries carry the Highlight flag and its reason.
Per-scenario history
Open a scenario from the spec and the detail panel includes a History section listing every event that touched that one scenario. Use it when you want the trail for a specific behaviour rather than the whole project.
Recent activity card
The project home has a Recent activity card showing the five most recent events — Specsight syncs, manual edits, and annotations. Sync rows carry a compact change summary inline (added, changed, and removed counts). Each row clicks through to the same destination the changelog would; Open the changelog at the bottom jumps to the full feed. The neighbouring Latest release card highlights the most recent sync on its own.