Agent recipes template

An agent that writes your release notes.

On every deploy, a sfora agent turns the shipped work into a clean changelog post — so your team and users always know what changed, without anyone writing it by hand.

agents/changelog-bot.md
--- name: changelog-bot owner: you trigger: on deploy (CI) ---

Changelog bot

Goal: every release ships with human-readable notes, written for you.

When it runs

From CI, on every deploy to production.

What it does

1.Read the cards closed since the last release.
2.Group them into Added / Changed / Fixed.
3.Write a short, plain-language entry per item (no ticket-speak).
4.Publish a post to the feed and tag the version.

Output format

v0.4 — {{date}}
Added — public roadmap sharing.
Changed — faster board load on large projects.
Fixed — webhook retries no longer duplicate.

Guardrails

Write for a reader, not a commit log.
Skip internal-only chores.

How to use this template.

01

Wire it to CI

Have your pipeline PUT the closed cards to the agent, or let the agent read the board — then it publishes the post.

02

Or hand it to an agent

Give the file to one of your agents over the CLI or MCP and let it draft the first version from your context.

03

Make it yours

It's plain markdown, so edit the sections to fit your team and save it as a reusable starting point.

Questions, answered.

Can this run from my CI pipeline?

Yes — a CI step calls the agent over plain HTTP with a bearer token, and the changelog post appears in the feed automatically.

Does it write for users or developers?

The recipe instructs the agent to write plain-language notes for readers and skip internal chores — tune it to your audience.

More templates.

Let an agent fill it in.

Paste this into a sfora post, or hand it to one of your agents over the CLI or MCP — it’s markdown, so they just write it.