Skip to content
bits
Prompting that works · Lesson 10 of 10

Checkpoint: release notes

Tutor:

Time to use the whole toolkit on one real job. Your team writes commit messages like fix: null check in avatar upload and chore: bump eslint. Your users don't read those. You want Claude to turn each week's commits into release notes a customer would actually read.

Here's the gap between a bare prompt and a toolkit prompt:

Bare prompt vs Toolkit promptillustrative: made-up numbers that show the idea, not output from a real modelcompare

promptfix: crash when avatar upload is over 5MB; chore: bump eslint to 9.2; feat: dark mode for settings page; refactor: split auth module

Bare prompt

## Release Notes **Bug Fixes** - Fixed crash when avatar upload exceeds 5MB **Chores** - Bumped eslint to 9.2 **Features** - Added dark mode for settings page **Refactoring** - Split auth module

Toolkit prompt

Settings now has a dark mode. Big profile photos no longer crash the upload: anything up to 5 MB now works smoothly.

Tutor:

The left copied every commit, including the two your users will never notice. The right knew who the notes were for, so it left the internal work out.

Tutor:

A quick map of the toolkit, so you can tick each one off.

A clear ask that a new colleague could follow (lesson 1). The why: who reads the notes and what they care about (lesson 2). An example of a note in your style (lesson 3). Tags around the commits (lesson 4). A role at the top (lesson 5). A format: a length and a shape (lesson 6). And a rule for the edge case your tests would find: a week with nothing users would notice (lesson 9).

Tutor:

Checkpoint. Write the release-notes prompt with every check ticked, then run it. Then try the edge case: swap the commits for only chore: and refactor: lines and run it again. Does your rule hold?

Your turn

Run your prompt and the replies land here.

    • Gives a role, not yet
    • Says who reads it, and why, not yet
    • Shows an example, not yet
    • Wraps the commits in tags, not yet
    • Sets a length or shape, not yet
    • Handles a week with nothing to say, not yet
    • Ran at 1.0, not yet
    run at
    ~0 tokens

    Turn on JavaScript to run prompts.

    Tutor:

    Finish this checkpoint and the Prompting that works badge is yours. You can now write prompts that are clear and specific, steer Claude with examples, tags, roles and formats, know when to let it think or split the job, and test a prompt before you trust it.