e-volv

Docs playbook

ReleasePRDescription

Writes user-facing, categorized release notes into the body of every release/* pull request.

When a release/* branch opens a PR into main, aggregate every merged PR and commit in the release, categorize the changes, and write user-facing release notes into the PR body.

Identifier
release-pr-description
Version
1.0.0
Steps
3
Triggers
1
  • release
  • pull-request
  • notes
  • automated

When it runs

Pull requestpull_request.opened
Settle delay
10s after the event

Only when all hold

  • pullRequest.headBranch starts with release/
  • pullRequest.baseBranch in main, master
  • actor.username not contains [bot]

The pipeline

The graph below is the one the workflow opens with in the builder — same steps, same layout, drawn on the same canvas. The run playing through it is a simulation; the branches and conditions are real.

React Flow
  1. 01
    Release PR Openedtrigger

    The event that starts the run.

  2. 02
    Clone Repositorygit.clone

    Shallow-clones the repository at the right ref.

  3. 03
    Write Release Notesagent.run

    One agent works the task with its toolkit.

The agent

Release Notes Writer

Base type
Tech Writer
Temperature
0.3
Max iterations
35
Tools
9

Git provider · 4

  • read_pull_requestRead Pull Request · read
  • list_pull_requestsList Pull Requests · read
  • get_pull_request_diffGet Pull Request Diff · read
  • update_pull_requestUpdate Pull Request · write

Filesystem · 2

  • read_fileRead File · read
  • list_dirList Directory · read

Terminal · 1

  • run_terminal_cmdRun Terminal Command · write

Code search · 1

  • code_searchCode Search · read

Status · 1

  • update_statusUpdate Status · write