Add size-gated PR visual recap workflow - #1178
Draft
busbyk wants to merge 6 commits into
Draft
Conversation
Generates an interactive visual recap for sufficiently large PRs via BuilderIO's reusable pr-visual-recap workflow. A Sonnet-powered gate decides whether a PR justifies a recap (with numeric fast paths and a visual-recap force label), the recap itself runs on Claude Opus, and a final job flips the published plan to public visibility so anonymous visitors can view it. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The recap job in BuilderIO's reusable workflow declares actions: write and pull-requests: write; a caller granting less fails at startup. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Contributor
|
Preview deployment: https://busbykxvisual-recap-pr-workflow.preview.avy-fx.org |
This was referenced Aug 7, 2026
The gate now judges borderline PRs by invoking Sonnet through the Claude Code CLI with CLAUDE_CODE_OAUTH_TOKEN instead of calling the Messages API with a usage-billed key, matching the subscription auth adopted for @claude mentions in #1180. The recap job stays on ANTHROPIC_API_KEY until BuilderIO/agent-native#2741 lets the reusable workflow accept a subscription token. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The reusable recap workflow declares the same pr-visual-recap-<PR> concurrency group internally, so holding it from the caller made the workflow call fail with "Canceling since a deadlock". The called workflow's own group still cancels superseded recap runs per PR. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Exercises busbyk/agent-native@recap-claude-oauth-token with only CLAUDE_CODE_OAUTH_TOKEN passed, to validate BuilderIO/agent-native#2741 end to end. Revert before merge. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Contributor
|
Here's a visual recap of what changed: Open the full interactive recap |
busbyk
marked this pull request as draft
August 7, 2026 23:01
This reverts commit 092e052.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Note
Draft — holding for upstream. The recap job still authenticates with the usage-billed
ANTHROPIC_API_KEYbecause BuilderIO's reusable workflow doesn't accept a Claude subscription token yet. Once a PR for BuilderIO/agent-native#2741 lands, we'll switch that job toCLAUDE_CODE_OAUTH_TOKEN(tracked in #1179) and mark this ready for review.Description
Adds a GitHub Actions workflow that generates an interactive visual recap for sufficiently large PRs, posted as a sticky PR comment linking to the Plan app (plan.agent-native.com, NWAC org). A gate job decides whether a PR justifies a recap — tiny diffs skip, huge diffs pass, and borderline diffs are judged by Claude Sonnet against the skill's "when to use it" criteria — and the recap itself runs on Claude Opus via BuilderIO's reusable workflow.
Related Issues
Key Changes
.github/workflows/pr-visual-recap.ymlwith three jobs:size-gate(numeric fast paths + Sonnet judgment via the Claude Code CLI, billed to our Claude subscription throughCLAUDE_CODE_OAUTH_TOKEN, with avisual-recaplabel to force a recap on any PR),visual-recap(callsBuilderIO/agent-native's reusable workflow withmodel: claude-opus-5), andpublicize-recap(flips the published plan to public visibility so anonymous visitors to this public repo can view recap links — the recap CLI publishes org-only with no override).How to test
Repo secrets
PLAN_RECAP_TOKEN(org-scoped service token),CLAUDE_CODE_OAUTH_TOKEN(subscription, same token as #1180), andANTHROPIC_API_KEY(recap job only, until upstream lands) are required. Open or update a PR: small diffs should skip with a notice in the Actions log, large or schema/RBAC-touching diffs should produce a recap comment, and adding thevisual-recaplabel should force one. The recap link should open for a logged-out browser session.Screenshots / Demo video
N/A
Migration Explanation
N/A — no schema or data changes.
Future enhancements / Questions
ANTHROPIC_API_KEY(Convert Claude GitHub Actions workflows to subscription auth (CLAUDE_CODE_OAUTH_TOKEN) #1179).🤖 Generated with Claude Code