workflowintermediateClaude Code

Claude Code GitHub Workflow Blueprint

This is a pre-built automation system that connects Claude Code with your GitHub repository. It uses AI to automate your entire software development process, from creating tasks and managing project boards to running quality checks and deploying code, turning your GitHub into an intelligent project management suite.

AI SETUP PROMPT

Paste into Claude Code — it will scan your project and set everything up

# Set Up Workflow: Claude Code GitHub Workflow Blueprint

## What This Is
This is a pre-built automation system that connects Claude Code with your GitHub repository. It uses AI to automate your entire software development process, from creating tasks and managing project boards to running quality checks and deploying code, turning your GitHub into an intelligent project management suite.

Source: https://github.com/alirezarezvani/claude-code-github-workflow

## Before You Start

Scan my workspace and analyze:
- The project language, framework, and directory structure
- Existing AI provider config (check .env, .env.local, config files for API keys — OpenRouter, OpenAI, Anthropic, Google AI, etc.)
- Whether this repository or a similar tool is already cloned or installed

Then ask me before proceeding:
1. Which AI provider/API should this use? (Use whatever I already have configured, or ask me to set one up — options include direct provider APIs or a unified service like OpenRouter)
2. Where in my project should this be integrated?
3. Are there any customizations I need (model preferences, naming conventions, constraints)?

## Fetch the Source

Clone or inspect the repository to understand what needs to be installed:
```bash
gh repo clone alirezarezvani/claude-code-github-workflow
```
Review the README, directory structure, and any install instructions before proceeding.

## What to Implement

This is an **AI Workflow** — an end-to-end automation pattern or integration pipeline.

- Study the workflow architecture from the source and context below
- Identify which parts I can implement locally vs. parts that need external services
- For local parts: implement them using my existing stack and API keys
- For external parts: tell me exactly what services I need and help me configure the integration code
- Wire up any required API calls using keys from my .env files

## Additional Context

- Clone the workflow blueprint repository into a `.github-blueprint` directory within the user's current project workspace.
- Execute the interactive setup script located at `.github-blueprint/setup/wizard.sh` to configure the GitHub Actions, branch protections, and project integrations for the user's repository.
- Run the validation script located at `.github-blueprint/setup/validate.sh` to verify that all workflows are active, slash commands are available, and quality gates are correctly configured.

## Reference Implementation

```
# 1. Clone this blueprint into your project
git clone https://github.com/alirezarezvani/claude-code-github-workflow.git .github-blueprint
cd .github-blueprint

# 2. Run the interactive setup wizard
./setup/wizard.sh

# 3. Verify everything is working
./setup/validate.sh
```

## Guidelines

- Adapt everything to my existing project — do not assume a specific stack or directory layout
- Use whichever AI provider I already have configured; if I need a new one, tell me what to sign up for and I'll give you the key
- Check my .env files for existing API keys (OpenRouter, OpenAI, Anthropic, Google AI) before asking me to add one
- Review any fetched code for safety before installing or executing it
- After setup, run a quick verification and show me a summary of exactly what was installed, where, and how to use it

3,277 charactersCompatible with Claude Code & Codex CLI

MANUAL SETUP STEPS

01Clone the workflow blueprint repository into a `.github-blueprint` directory within the user's current project workspace.
02Execute the interactive setup script located at `.github-blueprint/setup/wizard.sh` to configure the GitHub Actions, branch protections, and project integrations for the user's repository.
03Run the validation script located at `.github-blueprint/setup/validate.sh` to verify that all workflows are active, slash commands are available, and quality gates are correctly configured.

CODE INTELLIGENCE

bash

# 1. Clone this blueprint into your project
git clone https://github.com/alirezarezvani/claude-code-github-workflow.git .github-blueprint
cd .github-blueprint

# 2. Run the interactive setup wizard
./setup/wizard.sh

# 3. Verify everything is working
./setup/validate.sh

FIELD OPERATIONS

AI-Powered Documentation Generator

Create a project where GitHub issues with a specific label (e.g., 'docs-request') trigger the workflow. Use Claude to read the issue title and body, generate comprehensive documentation in Markdown format, commit it to a `/docs` folder, and automatically deploy a static site using GitHub Pages.

Automated Open Source Contribution Onboarding

Configure the workflow in an open-source project. When a new contributor opens their first issue, the workflow automatically assigns a 'good-first-issue' task, posts a welcoming comment with a link to the contribution guide, and creates a development branch for them, significantly lowering the barrier to entry.

STRATEGIC APPLICATIONS

→A startup development team can use this workflow to accelerate their MVP launch. Product managers write feature specs as GitHub issues, and the system automatically creates development tasks, feature branches, and boilerplate code, allowing developers to focus purely on business logic rather than administrative setup.
→A digital agency managing multiple client websites can deploy this workflow to standardize their maintenance process. When a client submits a change request via a GitHub issue, the system automates task creation, quality checks (linting, testing), and deploys the changes to a staging environment for client approval, ensuring consistency and reducing manual DevOps work.