Skip to content

README.md

Latest commit

 

History

History
73 lines (54 loc) · 2.77 KB

README.md

File metadata and controls

73 lines (54 loc) · 2.77 KB
Raw

Claude Code Workflows

Reusable GitHub Actions workflows for Claude Code reviews. Each repo defines its own context via CLAUDE.md.

Setup

  1. Add secret CLAUDE_CODE_OAUTH_TOKEN to your repo (get from https://claude.ai/settings/oauth-tokens)
  2. Copy workflow files from examples/workflows/ to your .github/workflows/
  3. Update uses: lisk/workflows/... to your org name
  4. (Optional) Create CLAUDE.md in repo root with review guidelines

Workflows

1. PR Review

  • File: claude-pr-review.yml
  • Trigger: On-demand only — /review comment (optionally /review opus or /review haiku) or needs-review label. Skips bot actors. No auto-run on push (avoids token burn from PRs with many pushes).
  • Does: Structured code review with inline comments, severity levels, focuses on bugs/security/performance
  • Example: See examples/workflows/claude-pr-review-caller.yml

2. PR Summary

  • File: claude-pr-summary.yml
  • Trigger: Runs on PR opened, reopened, or ready_for_review. Skips doc-only PRs (**/*.md, docs/**).
  • Does: Generates concise summary, updates PR description
  • Example: See examples/workflows/claude-pr-summary-caller.yml

3. Interactive Claude

  • File: claude.yml
  • Trigger: Mention @claude in issues/PRs
  • Does: Flexible assistant - explain code, investigate bugs, write docs, answer questions
  • Example: See examples/workflows/claude-interactive-caller.yml

4. Auto-assign Reviewer

  • File: auto-assign-reviewer.yml
  • Trigger: PR opened or ready_for_review (skips drafts, bots, and authors not in any squad)
  • Does: Picks a reviewer using review-map.yml (squad × domain matrix with sibling cascade) and requests review via the GitHub API. Soft-fails — never blocks merges.
  • Config: review-map.yml at repo root
  • Docs: docs/auto-reviewer.md
  • Example: See examples/workflows/auto-assign-reviewer-caller.yml

CLAUDE.md (Optional)

Create in repo root to define review priorities:

# Repository Context

## Technology Stack
- TypeScript + Express.js + PostgreSQL

## Critical
- SQL injection prevention (use Prisma, no raw queries)
- JWT auth on all endpoints
- Never log passwords/tokens

## Testing
- Integration tests for all endpoints
- 80%+ coverage for new code

Troubleshooting

Workflow not running?

  • Check secret is set
  • Verify trigger (comment /review, mention @claude, etc)
  • Check workflow file is in .github/workflows/

"workflow_call not found"?

  • Verify uses: path matches your org
  • Check branch exists (@main)

How It Works

Claude automatically reads CLAUDE.md when it exists. If not, it infers context from package.json, README, etc. Same workflow files work across all repos.