fix: replace on-call reviewer assignment with Slack notification + last-reviewer

[dannyneira]

Summary

Replaces the fragile Grafana-based on-call reviewer assignment with two simpler, more reliable mechanisms:

1. Slack notification — the Oz agent posts to #oncall-client (C06MT1NRBFV) mentioning @oncall-client-primary and @oncall-client-secondary after creating the PR. Grafana keeps those Slack user groups in sync with the rotation automatically — no Grafana API calls needed.
2. Last-reviewer assignment — GitHub Actions finds the last human reviewer from recently merged docs PRs and assigns them to the new PR. Falls back to dannyneira if none found.

The PR is created with auto-merge enabled, so once the assigned reviewer approves it merges automatically.

Changes

.github/workflows/release-docs-update.yml

• Removed assign_oncall_reviewers workflow input and all related env vars/normalization
• Removed reviewer prompt injection from the "Write Oz prompt" step
• Added Slack posting instruction to the agent prompt: resolves both oncall-client-primary and oncall-client-secondary group IDs via usergroups.list, posts to #oncall-client
• Replaced "Assign on-call reviewers from PR body" step with "Assign last docs PR reviewer" — queries pulls/{n}/reviews on recent merged PRs to find the last human reviewer

.agents/skills/release_updates/SKILL.md

• Replaced "Required for on-call reviewer assignment" section with "Required for Slack PR notification" (DOCS_SLACK_BOT_TOKEN only — channel ID is hardcoded)
• Updated inline Python snippet to resolve and mention both @oncall-client-primary and @oncall-client-secondary
• Added note that reviewer assignment is handled by GitHub Actions

.agents/skills/release_updates/scripts/resolve_oncall_reviewers.py

• Deleted — no longer used

Slack message format

:books: New release docs PR ready for review
https://github.com/warpdotdev/docs/pull/NNN
@oncall-client-primary @oncall-client-secondary please take a look when you get a chance.

Oz environment changes required

Add to the docs Oz environment (K5KStCm5aYvhfBJb8cHol6) at https://oz.warp.dev/agents/019eb332-2ee0-7417-8ecc-89260cf5b850:

• DOCS_SLACK_BOT_TOKEN — Slack bot token for posting to #oncall-client

Remove from the docs Oz environment (no longer needed):

• DOCS_AGENT_GRAFANA_TOKEN
• ONCALL_EMAIL_TO_GITHUB_OVERRIDES

Also ensure the bot is a member of #oncall-client (/invite @botname in that channel).

Co-Authored-By: Oz oz-agent@warp.dev

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jul 9, 2026 7:48pm

[oz-for-oss]

Overview

Reviewed the release docs workflow change that replaces Grafana on-call reviewer resolution with Slack notification instructions and a GitHub Actions last-reviewer assignment step.

Concerns

• The new reviewer lookup likely calls the pulls endpoint with POST semantics because it passes -F fields to gh api without forcing GET, so the action can skip the intended last-reviewer assignment and fall back to the default reviewer.
• The last-reviewer logic only inspects the newest merged PR instead of scanning recent merged PRs until it finds a human reviewer, which can incorrectly fall back when the newest merged PR has no human review.
• The Slack notification example in the release update skill references names that are not defined/imported, so agents following it can fail before posting or while handling Slack errors.

Verdict

Found: 0 critical, 4 important, 0 suggestions

Request changes

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz