Reusable GitHub Workflows - AI-Powered Automation

Powerful Automation Features

Everything you need to streamline your development workflow

🤖

AI-Powered Reviews

Automated code reviews with intelligent feedback on quality, security, and performance.

🔄

Smart Issue Management

JD responds to comments and labels, automating issue triage and PR workflows.

🚀

Automated Releases

Semantic versioning and changelog generation handled automatically on every push.

📖

Docs Deployment

One-click GitHub Pages deployment for your documentation directory.

Available Workflows

Drop these into your repository and start automating

1. JD Code Assistant

Automates issue and PR management using AI. Responds to /jd commands and the jd label for intelligent task automation.

name: JD Code

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

permissions:
  id-token: write

jobs:
  jd:
    uses: starburst997/workflows/.github/workflows/jd.yml@v1
    secrets: inherit
    permissions: # Optional if using bot
      issues: write
      contents: read
      pull-requests: read
      actions: write

2. Automated Code Review

AI-powered code review that analyzes PRs for quality, bugs, security issues, and suggests improvements automatically.

name: JD Review

on:
  pull_request:
    types: [opened, ready_for_review]

permissions:
  id-token: write

jobs:
  review:
    uses: starburst997/workflows/.github/workflows/jd-review.yml@v1
    secrets: inherit
    permissions: # Optional if using bot
      contents: read
      pull-requests: read
      issues: read

3. GitHub Pages Deployment

Automatically deploys your documentation from the docs/ directory to GitHub Pages on every push to main.

name: GitHub Pages

on:
  push:
    branches: [main]
    paths: ["docs/**"]

permissions:
  id-token: write

jobs:
  deploy:
    uses: starburst997/workflows/.github/workflows/gh-pages.yml@v1
    secrets: inherit
    permissions: # Optional if using bot
      contents: read
      pages: write

4. Automated Release

Semantic versioning with automatic changelog generation. Creates releases and tags on every push to your main branch. Optionally updates major and minor version tags.

name: Release

on:
  push:
    branches: [main]

jobs:
  release:
    uses: starburst997/workflows/.github/workflows/release.yml@v1
    with:
      update-major-minor: true # Optional, defaults to true
    secrets: inherit
    permissions: # Optional if using bot
      contents: write

Required Configuration

Secrets needed for AI-powered workflows

CLAUDE_CODE_OAUTH_TOKEN

Required

OAuth token for Claude Code AI assistant authentication. Required for JD Code and JD Review workflows.

BOT_ID

Optional

GitHub App ID for custom bot integration. Use this if you want to run workflows under a custom GitHub App instead of the default GitHub Actions bot.

BOT_KEY

Optional

GitHub App private key for custom bot integration. Must be provided together with BOT_ID for custom bot functionality.

Quick Setup

Get up and running in three simple steps

Step 1: Add Secrets

Navigate to your repository settings and add the required secrets under Settings → Secrets and variables → Actions:

• CLAUDE_CODE_OAUTH_TOKEN - Required for AI workflows

• BOT_ID and BOT_KEY - Optional for custom bot

Step 2: Create Workflow File

Create a new file in your repository at .github/workflows/automation.yml

Copy one of the workflow examples above and paste it into your new file.

Step 3: Commit and Push

Commit the workflow file to your repository. The automation will activate immediately based on the configured triggers.

For JD Code Assistant, comment /jd on any issue or PR to trigger the AI assistant.