Transform your GitHub repository into an AI-powered development environment where Claude autonomously implements solutions.
This repository contains GitHub Actions workflows that enable Claude Code to:
- ✅ Automatically analyze new issues
- ✅ Implement complete solutions autonomously
- ✅ Create production-ready pull requests
- ✅ Move issues through your Kanban board
- ✅ Save 2.7+ hours per issue on average
- Quick Start Guide - ⭐ Get running in 15 minutes
- Setup Guide - Comprehensive setup documentation
- Implementation Report - Complete technical documentation
- Contributing Guide - How to contribute and versioning system
After setup, every time you create an issue:
- Within 30 seconds: Workflow triggers automatically
- Within 2-3 minutes: Issue analyzed, labeled, and commented
- Within 3-5 minutes: Code implemented and PR created
- You review: Check the PR, approve/request changes, merge
# 1. Generate Claude OAuth token
claude setup-token
# 2. Add secrets to your repository
gh secret set CLAUDE_CODE_OAUTH_TOKEN --repo YOUR_ORG/YOUR_REPO
gh secret set PERSONAL_ACCESS_TOKEN --repo YOUR_ORG/YOUR_REPO
# 3. Copy workflow files to your repository
mkdir -p .github/workflows
curl -o .github/workflows/issue-automation.yml \
https://raw.githubusercontent.com/alanops/claude-agentic-workflow/main/.github/workflows/issue-automation.yml
curl -o .github/workflows/agentic-workflow.yml \
https://raw.githubusercontent.com/alanops/claude-agentic-workflow/main/.github/workflows/agentic-workflow.yml
# 4. Customize the workflows with your organization/project details
# 5. Commit and push
git add .github/workflows/
git commit -m "Add Claude agentic workflows"
git push
# 6. Create a test issue!
gh issue create --title "Test: Add hello function" \
--body "Create a simple hello() function"See the Quick Start Guide for detailed instructions.
1. Issue Automation (issue-automation.yml)
- Auto-labels issues based on content
- Determines priority level
- Adds analysis comments
- Optionally adds to project board
2. Agentic Workflow (agentic-workflow.yml)
- Complete autonomous development
- Code implementation from scratch
- Full test coverage
- PR creation with detailed descriptions
- Project board integration
- No API keys exposed in code
- Uses GitHub Secrets for credentials
- OAuth token-based authentication
- All code stays in your repository
- Human review required before merge
- Typical cost: $1-2 per issue
- Time saved: 2.7 hours per issue (~$400 value)
- ROI: 6,000%+ return on investment
- See Implementation Report for detailed metrics
- Claude Code v1.0.44 or later
- GitHub repository (organization or personal)
- Admin access to repository settings
- GitHub CLI (
gh) installed - Optional: GitHub Projects v2 board
graph LR
A[Create Issue] --> B[Workflow Triggers]
B --> C[Claude Analyzes]
C --> D[Claude Implements]
D --> E[Creates PR]
E --> F[Human Review]
F --> G[Merge]
- You create an issue describing what needs to be done
- GitHub Actions triggers the Claude workflow
- Claude analyzes your codebase and requirements
- Claude implements the solution autonomously
- Claude creates a PR with detailed description
- You review and merge (or request changes)
Both workflows are highly customizable:
- Branch naming: Change
branch_prefixparameter - Tool access: Add/remove allowed tools
- Trigger conditions: Modify when workflows run
- Project board: Configure your project number
- Custom instructions: Add repository-specific guidelines
See the Setup Guide for customization options.
- Start small: Begin with documentation and simple bugs
- Write clear issues: Detailed requirements = better results
- Always review: Never auto-merge without human review
- Monitor costs: Check Claude usage regularly
- Provide feedback: Comment on PRs to guide future work
Workflows not triggering?
- Check
.github/workflows/is on main branch - Verify GitHub Actions are enabled in Settings
Permission errors?
- Regenerate Personal Access Token with correct scopes
- Verify secrets are set:
gh secret list --repo YOUR_REPO
Claude makes mistakes?
- Improve issue description clarity
- Add custom instructions to workflow
- Update CLAUDE.md with coding standards
See Troubleshooting for more help.
From our testing:
Issue #25: "Create simple hello-world example"
- Time taken: 2 minutes 27 seconds
- Result: 45 lines of production-quality markdown
- Features: 5+ markdown features (exceeded requirements)
- PR: Ready for review with detailed description
See Implementation Report for complete case study.
- Quick Start Guide - 15-minute setup process
- Setup Guide - Comprehensive 400+ line guide
- Implementation Report - 1,200+ line technical report
- Issues: Report problems in this repository
- Claude Docs: https://docs.claude.com/claude-code
- GitHub Actions: https://docs.github.com/actions
This repository uses automatic semantic versioning based on commit messages:
- Automatic releases: Every push to
maincreates a new version if changes are detected - Semantic versioning: Follows SemVer (major.minor.patch)
- Conventional commits: Use conventional commit messages for automatic versioning
feat:→ Minor version bump (v1.0.0 → v1.1.0)fix:→ Patch version bump (v1.0.0 → v1.0.1)feat!:orBREAKING CHANGE→ Major version bump (v1.0.0 → v2.0.0)
Check the Releases page for the latest version and changelog.
MIT License - Feel free to use and modify for your needs.
Contributions are welcome! This project uses:
- Conventional Commits for automatic versioning
- Semantic Versioning for releases
- Automatic tagging via GitHub Actions
Please read CONTRIBUTING.md for:
- Commit message conventions
- Development workflow
- Pull request guidelines
- Testing procedures
Quick start for contributors:
- Fork the repository
- Create a feature branch:
git checkout -b feat/amazing-feature - Commit using conventional commits:
git commit -m "feat: add amazing feature" - Push and create a pull request
Built with:
- Claude Code by Anthropic
- GitHub Actions
- anthropics/claude-code-action
Ready to get started? Head to the Quick Start Guide and be up and running in 15 minutes! 🚀