Videra Health GitHub Actions

Reusable GitHub Actions and workflows for Videra Health repositories.

Overview

This repository provides centralized, reusable GitHub workflows that can be used across all Videra Health repositories. Currently includes:

Claude Code Workflows

Two AI-powered code assistance workflows using Anthropic's Claude Code:

1. Claude Code Review - Automated PR reviews
2. Claude Code Assistant - On-demand help via @claude mentions

Workflows

Claude Code Review (claude-code-review.yml)

Automatically reviews pull requests to help human reviewers prioritize their attention.

Features:

• 3-sentence PR summary
• Flags clear bugs (logic errors, typos, type mismatches, race conditions)
• Identifies CLAUDE.md convention violations
• Highlights areas needing human attention
• Uses sticky comments (edits existing comment rather than creating new ones)
• Includes "fix" links for actionable suggestions
• Can create inline comments on specific code lines

Triggers:

• PR opened
• PR synchronized (new commits pushed)
• PR marked ready for review
• PR reopened

Claude Code Assistant (claude.yml)

On-demand Claude assistance triggered by mentioning @claude in issues or PRs.

Features:

• Responds to custom instructions
• Can read CI results
• Performs tasks based on natural language requests

Triggers:

• Issue comments containing @claude
• PR review comments containing @claude
• PR reviews containing @claude
• New issues with @claude in title or body

Usage

Prerequisites

Add the ANTHROPIC_API_KEY secret to your repository:

1. Go to your repository's Settings → Secrets and variables → Actions
2. Create a new repository secret named ANTHROPIC_API_KEY
3. Set the value to your Anthropic API key

Installation

Create two workflow files in your repository's .github/workflows/ directory:

File 1: .github/workflows/claude-code-review.yml

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]

jobs:
  review:
    uses: videra-health/github-actions/.github/workflows/claude-code-review.yml@main
    secrets:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

File 2: .github/workflows/claude.yml

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]

jobs:
  claude:
    uses: videra-health/github-actions/.github/workflows/claude.yml@main
    secrets:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

How to Use

Automated PR Reviews

Once installed, Claude will automatically review PRs when they're opened or updated. Reviews appear as comments on the PR.

On-Demand Assistance

Mention @claude in any issue or PR comment with instructions:

@claude Please review the error handling in this PR

@claude Can you explain what this function does?

@claude Update the PR description with a summary of changes

Centralized Updates

The beauty of reusable workflows is that updates to this repository automatically apply to all repositories using these workflows. To update the workflows across all Videra Health repos, simply:

1. Make changes to the workflow files in this repository
2. Commit and push to main
3. All repositories using these workflows will use the updated version on their next run

Adding New Workflows

To add new reusable workflows to this repository:

1. Create a new workflow file in .github/workflows/
2. Use on: workflow_call: as the trigger
3. Define any required secrets or inputs
4. Update this README with usage instructions
5. Commit and push to main

Development

To modify existing workflows:

1. Clone this repository
2. Edit the workflow files in .github/workflows/
3. Test in a single repository first
4. Once confirmed working, push changes to main

License

Internal use only - Videra Health organization.