ci: add Claude AI review workflow templates#4
Draft
heskew wants to merge 3 commits into
Draft
Conversation
Surfaces the four Claude caller workflows as suggested workflows in any HarperFast repo's Actions tab. New repos pick them up with two clicks each instead of copy-pasting. Templates (one YAML + properties.json each): - claude-review.yml — auto-review every PR - claude-mention.yml — respond to @claude in comments - claude-issue-to-pr.yml — claude-fix:* labels → PRs - validate-caller-workflows.yml — structural lint, required check Plus workflow-templates/README.md with the new-repo onboarding checklist (secrets, labels, .node-version, branch protection, AGENTS.md/CLAUDE.md) and pin-bump guidance. All four templates pin to the same ai-review-prompts SHA (11872cb). Adopting consumers can bump in lockstep when an upstream change ships. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The auth gate mints an installation token from the \`HarperFast AI Workflows\` GitHub App on every workflow run. Without the App installed on the consumer repo, the \`authorize\` job fails with a 401 even when all four secrets are configured correctly. Add this as step 1 of the new-repo onboarding checklist (it's a precondition; the secrets in step 2 are useless without it). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Catches the templates up to what the consumer repos already pin (harper, oauth, harper-pro all on f6daed30). New repos onboarding from these templates now get: - claude-fix:test label support in the issue-to-PR reusable - FS primitives (mkdir/mv/cp/ls/cat) in mention + issue-to-PR allowlists - add-only migration guidance for :test work Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.
Summary
Surfaces the four Claude AI workflow callers as suggested workflows in the Actions tab of any HarperFast repo. New-repo onboarding goes from "copy-paste four files from another repo" to "click + customize" in the GitHub UI.
Adoption pattern is identical to what's already running on `HarperFast/harper`, `HarperFast/oauth`, and (post-#122) `HarperFast/harper-pro`: each template is a thin caller of a reusable workflow in `HarperFast/ai-review-prompts`.
Files added
`workflow-templates/` (a new top-level directory — GitHub picks it up automatically for the suggested-workflows feature):
Plus `workflow-templates/README.md` with the new-repo onboarding checklist: secrets, labels, `.node-version`, branch protection, `AGENTS.md`/`CLAUDE.md`, customization pointers, and pin-bump guidance.
Pin policy
All four templates pin to the same `ai-review-prompts` SHA (`11872cb…`). Bumping the pin is the only motion needed to adopt upstream updates.
Test plan
🤖 Generated with Claude Code