Draft a changelog from a day's work

Instead of combing through a day's merges by hand, build a workflow that drafts the changelog and stops for your review.

Build the chain

From Workflows → New workflow → Blank workflow, declare one input and one context document, then add three steps.

Input — since, described as "how far back to look, for example yesterday".

Context document — slug changelog, written by the drafting step, with a starting body:

# Changelog
 
## User-facing
 
## Developer-facing
 
## Fixes

Step 1, Agent — "Collect activity"

Find everything merged into this repository since @input:since: merged pull
requests, closed issues, and commits. Write the raw list into @doc:changelog
under a temporary "Raw activity" heading, with a link for each item.

Step 2, Agent — "Draft the changelog"

Rewrite @doc:changelog from the raw activity into the three sections already in
the document. Keep each entry to one line, link back to its pull request or
issue, and drop the raw list when you are done. Add an "Open questions" section
for anything you could not classify.

Step 3, Human in the loop — "Review the draft"

Read @doc:changelog. Approve to finish, or redo the drafting step with what
needs to change.

Run it

Press Run, set since to yesterday, and pick a repository. Leave the placement on New worktree so the run stays off your working checkout.

Watch the drafting step in its session, then read the document under Documents in the Execution panel before you approve.