docs(workflows): add OAuth token documentation for Claude workflows

[claude]

Summary

This PR updates the documentation to reflect the OAuth authentication option (CLAUDE_CODE_OAUTH_TOKEN) for Claude-powered workflows. The underlying workflow implementation already supports OAuth (see recent commits #282, #283), but the documentation needed to be updated to guide users on how to use it.

• Updated REUSABLE_WORKFLOWS.md with OAuth token documentation for _claude-main.yml and _claude-code-review.yml workflows
• Added WORKFLOW_PAT documentation for resolving review threads via GraphQL API

Changes

• .github/REUSABLE_WORKFLOWS.md: Updated secrets documentation tables for Claude workflows to include:
  • CLAUDE_CODE_OAUTH_TOKEN as an alternative to ANTHROPIC_API_KEY
  • WORKFLOW_PAT for optional GraphQL API operations
  • Updated notes clarifying that either API key or OAuth token is required

Note

The following files were prepared with OAuth documentation updates but could not be pushed due to GitHub App workflow permissions:

• .github/workflows/README.md - Required secrets table update
• .github/workflows/examples/08-claude-code-review-basic.yml - OAuth usage examples
• .github/workflows/examples/09-claude-code-review-with-custom-prompt.yml - OAuth usage examples
• .github/workflows/examples/10-claude-code-review-advanced.yml - OAuth usage examples

These changes will need to be applied separately by a user with workflow write permissions.

Testing

• Markdown linting passes
• Documentation accurately reflects the authentication options supported by the workflow

Linear Issue

Closes: https://linear.app/uniswap/issue/DEV-185/use-oauth-in-universe-for-claude-code-review-github-actions-workflow

Autonomous implementation using claude-opus-4-5-20251101

---

✨ Claude-Generated Content

Summary

Updates REUSABLE_WORKFLOWS.md documentation to reflect the OAuth authentication option (CLAUDE_CODE_OAUTH_TOKEN) for Claude-powered workflows. The underlying workflow implementation already supports OAuth (added in #281-#283), but the documentation needed to be updated to guide users on how to use it.

Changes

• Updated secrets table for _claude-main.yml to document:
  • CLAUDE_CODE_OAUTH_TOKEN as an alternative to ANTHROPIC_API_KEY
  • Updated requirement notes to clarify that either API key or OAuth token is required
• Updated secrets table for _claude-code-review.yml to document:
  • CLAUDE_CODE_OAUTH_TOKEN as an alternative to ANTHROPIC_API_KEY
  • WORKFLOW_PAT for optional GraphQL API operations (resolving review threads)
  • Updated requirement notes for authentication options

Notes

The OAuth token option enables Pro/Max users to authenticate using tokens generated via claude setup-token instead of requiring a pay-as-you-go API key. When both authentication methods are provided, the OAuth token takes precedence.
Closes: https://linear.app/uniswap/issue/DEV-185

[linear]

DEV-185 Use OAuth in universe for Claude Code Review GitHub Actions Workflow

[vercel]

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

Project	Deployment	Review	Updated (UTC)
ai-toolkit-slack-oauth-backend	Ready	Preview, Comment	Dec 28, 2025 10:12am

[github-actions]

🤖 Claude Code Review

✅ Review still valid — No new code changes detected since the last review.

_{💡 To force a fresh review, add a comment containing @request-claude-review.}

Summary

This PR updates the documentation in .github/REUSABLE_WORKFLOWS.md to reflect OAuth token authentication support for Claude Code workflows.

Changes Reviewed

Documentation updates for _claude-main.yml (lines 250-256):

• Updated secrets table to show ANTHROPIC_API_KEY is required only when CLAUDE_CODE_OAUTH_TOKEN is not provided
• Added CLAUDE_CODE_OAUTH_TOKEN as an alternative authentication method
• Updated note to clarify that one of the two authentication secrets must be provided

Documentation updates for _claude-code-review.yml (lines 1017-1023):

• Same authentication flexibility documented as above
• Added WORKFLOW_PAT secret documentation for resolving review threads via GraphQL API
• Updated note with the same clarification about authentication requirements

Assessment

✅ No issues found. This is a straightforward documentation update that:

• Maintains consistent table formatting with the existing style
• Provides clear descriptions for each secret
• Accurately reflects the "Required" column semantics
• Updates the notes section appropriately

The documentation changes are clear, accurate, and follow the established patterns in the file.

---

_{💡 Want a fresh review? Add a comment containing @request-claude-review to trigger a new review at any time.}

[github-actions]

📋 Review verdict: APPROVE

👆 The main review comment above is the source of truth for this PR review. It is automatically updated on each review cycle, so always refer to it for the most current feedback.

This formal review submission is for the verdict only.