{"id":35911463,"url":"https://github.com/alanops/claude-agentic-workflow","last_synced_at":"2026-04-07T23:02:19.722Z","repository":{"id":327701915,"uuid":"1110264653","full_name":"alanops/claude-agentic-workflow","owner":"alanops","description":"Autonomous AI development workflow using Claude Code and GitHub Actions","archived":false,"fork":false,"pushed_at":"2025-12-05T07:02:21.000Z","size":33,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-08T14:55:17.126Z","etag":null,"topics":["ai","automation","autonomous-development","ci-cd","claude-code","github-actions","workflow"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alanops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-05T00:11:46.000Z","updated_at":"2025-12-05T07:02:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alanops/claude-agentic-workflow","commit_stats":null,"previous_names":["alanops/claude-agentic-workflow"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/alanops/claude-agentic-workflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanops%2Fclaude-agentic-workflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanops%2Fclaude-agentic-workflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanops%2Fclaude-agentic-workflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanops%2Fclaude-agentic-workflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alanops","download_url":"https://codeload.github.com/alanops/claude-agentic-workflow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanops%2Fclaude-agentic-workflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31532337,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","automation","autonomous-development","ci-cd","claude-code","github-actions","workflow"],"created_at":"2026-01-10T03:33:52.350Z","updated_at":"2026-04-07T23:02:19.709Z","avatar_url":"https://github.com/alanops.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Agentic Workflow\n\nTransform your GitHub repository into an AI-powered development environment where Claude autonomously implements solutions.\n\n\u003e Status: Active\n\n## What Is This?\n\nThis repository contains GitHub Actions workflows that enable Claude Code to:\n- ✅ Automatically analyze new issues\n- ✅ Implement complete solutions autonomously\n- ✅ Create production-ready pull requests\n- ✅ Move issues through your Kanban board\n- ✅ Save 2.7+ hours per issue on average\n\n## Quick Links\n\n- **[Quick Start Guide](QUICK_START_GUIDE.md)** - ⭐ Get running in 15 minutes\n- **[Setup Guide](AGENTIC_WORKFLOW_SETUP.md)** - Comprehensive setup documentation\n- **[Implementation Report](AGENTIC_WORKFLOW_IMPLEMENTATION_REPORT.md)** - Complete technical documentation\n- **[Contributing Guide](CONTRIBUTING.md)** - How to contribute and versioning system\n\n## What You Get\n\nAfter setup, every time you create an issue:\n\n1. **Within 30 seconds**: Workflow triggers automatically\n2. **Within 2-3 minutes**: Issue analyzed, labeled, and commented\n3. **Within 3-5 minutes**: Code implemented and PR created\n4. **You review**: Check the PR, approve/request changes, merge\n\n## Quick Start\n\n```bash\n# 1. Generate Claude OAuth token\nclaude setup-token\n\n# 2. Add secrets to your repository\ngh secret set CLAUDE_CODE_OAUTH_TOKEN --repo YOUR_ORG/YOUR_REPO\ngh secret set PERSONAL_ACCESS_TOKEN --repo YOUR_ORG/YOUR_REPO\n\n# 3. Copy workflow files to your repository\nmkdir -p .github/workflows\ncurl -o .github/workflows/issue-automation.yml \\\n  https://raw.githubusercontent.com/alanops/claude-agentic-workflow/main/.github/workflows/issue-automation.yml\ncurl -o .github/workflows/agentic-workflow.yml \\\n  https://raw.githubusercontent.com/alanops/claude-agentic-workflow/main/.github/workflows/agentic-workflow.yml\n\n# 4. Customize the workflows with your organization/project details\n\n# 5. Commit and push\ngit add .github/workflows/\ngit commit -m \"Add Claude agentic workflows\"\ngit push\n\n# 6. Create a test issue!\ngh issue create --title \"Test: Add hello function\" \\\n  --body \"Create a simple hello() function\"\n```\n\nSee the **[Quick Start Guide](QUICK_START_GUIDE.md)** for detailed instructions.\n\n## Features\n\n### Two Workflows Included\n\n**1. Issue Automation** (`issue-automation.yml`)\n- Auto-labels issues based on content\n- Determines priority level\n- Adds analysis comments\n- Optionally adds to project board\n\n**2. Agentic Workflow** (`agentic-workflow.yml`)\n- Complete autonomous development\n- Code implementation from scratch\n- Full test coverage\n- PR creation with detailed descriptions\n- Project board integration\n\n### Security\n\n- No API keys exposed in code\n- Uses GitHub Secrets for credentials\n- OAuth token-based authentication\n- All code stays in your repository\n- Human review required before merge\n\n### Cost Effective\n\n- **Typical cost**: $1-2 per issue\n- **Time saved**: 2.7 hours per issue (~$400 value)\n- **ROI**: 6,000%+ return on investment\n- See [Implementation Report](AGENTIC_WORKFLOW_IMPLEMENTATION_REPORT.md) for detailed metrics\n\n## Requirements\n\n- Claude Code v1.0.44 or later\n- GitHub repository (organization or personal)\n- Admin access to repository settings\n- GitHub CLI (`gh`) installed\n- Optional: GitHub Projects v2 board\n\n## How It Works\n\n```mermaid\ngraph LR\n    A[Create Issue] --\u003e B[Workflow Triggers]\n    B --\u003e C[Claude Analyzes]\n    C --\u003e D[Claude Implements]\n    D --\u003e E[Creates PR]\n    E --\u003e F[Human Review]\n    F --\u003e G[Merge]\n```\n\n1. You create an issue describing what needs to be done\n2. GitHub Actions triggers the Claude workflow\n3. Claude analyzes your codebase and requirements\n4. Claude implements the solution autonomously\n5. Claude creates a PR with detailed description\n6. You review and merge (or request changes)\n\n## Customization\n\nBoth workflows are highly customizable:\n\n- **Branch naming**: Change `branch_prefix` parameter\n- **Tool access**: Add/remove allowed tools\n- **Trigger conditions**: Modify when workflows run\n- **Project board**: Configure your project number\n- **Custom instructions**: Add repository-specific guidelines\n\nSee the [Setup Guide](AGENTIC_WORKFLOW_SETUP.md) for customization options.\n\n## Best Practices\n\n1. **Start small**: Begin with documentation and simple bugs\n2. **Write clear issues**: Detailed requirements = better results\n3. **Always review**: Never auto-merge without human review\n4. **Monitor costs**: Check Claude usage regularly\n5. **Provide feedback**: Comment on PRs to guide future work\n\n## Troubleshooting\n\n**Workflows not triggering?**\n- Check `.github/workflows/` is on main branch\n- Verify GitHub Actions are enabled in Settings\n\n**Permission errors?**\n- Regenerate Personal Access Token with correct scopes\n- Verify secrets are set: `gh secret list --repo YOUR_REPO`\n\n**Claude makes mistakes?**\n- Improve issue description clarity\n- Add custom instructions to workflow\n- Update CLAUDE.md with coding standards\n\nSee [Troubleshooting](QUICK_START_GUIDE.md#troubleshooting) for more help.\n\n## Real-World Example\n\nFrom our testing:\n\n**Issue #25**: \"Create simple hello-world example\"\n- **Time taken**: 2 minutes 27 seconds\n- **Result**: 45 lines of production-quality markdown\n- **Features**: 5+ markdown features (exceeded requirements)\n- **PR**: Ready for review with detailed description\n\nSee [Implementation Report](AGENTIC_WORKFLOW_IMPLEMENTATION_REPORT.md) for complete case study.\n\n## Documentation\n\n- **[Quick Start Guide](QUICK_START_GUIDE.md)** - 15-minute setup process\n- **[Setup Guide](AGENTIC_WORKFLOW_SETUP.md)** - Comprehensive 400+ line guide\n- **[Implementation Report](AGENTIC_WORKFLOW_IMPLEMENTATION_REPORT.md)** - 1,200+ line technical report\n\n## Support\n\n- **Issues**: Report problems in this repository\n- **Claude Docs**: https://docs.claude.com/claude-code\n- **GitHub Actions**: https://docs.github.com/actions\n\n## Releases and Versioning\n\nThis repository uses automatic semantic versioning based on commit messages:\n\n- **Automatic releases**: Every push to `main` creates a new version if changes are detected\n- **Semantic versioning**: Follows [SemVer](https://semver.org/) (major.minor.patch)\n- **Conventional commits**: Use [conventional commit messages](https://www.conventionalcommits.org/) for automatic versioning\n\n### Version Bumps\n\n- `feat:` → Minor version bump (v1.0.0 → v1.1.0)\n- `fix:` → Patch version bump (v1.0.0 → v1.0.1)\n- `feat!:` or `BREAKING CHANGE` → Major version bump (v1.0.0 → v2.0.0)\n\n### Latest Release\n\nCheck the [Releases page](https://github.com/alanops/claude-agentic-workflow/releases) for the latest version and changelog.\n\n## License\n\nMIT License - Feel free to use and modify for your needs.\n\n## Contributing\n\nContributions are welcome! This project uses:\n- **Conventional Commits** for automatic versioning\n- **Semantic Versioning** for releases\n- **Automatic tagging** via GitHub Actions\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for:\n- Commit message conventions\n- Development workflow\n- Pull request guidelines\n- Testing procedures\n\nQuick start for contributors:\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feat/amazing-feature`\n3. Commit using conventional commits: `git commit -m \"feat: add amazing feature\"`\n4. Push and create a pull request\n\n## Acknowledgments\n\nBuilt with:\n- [Claude Code](https://claude.ai/code) by Anthropic\n- [GitHub Actions](https://github.com/features/actions)\n- [anthropics/claude-code-action](https://github.com/anthropics/claude-code-action)\n\n---\n\n**Ready to get started?** Head to the **[Quick Start Guide](QUICK_START_GUIDE.md)** and be up and running in 15 minutes! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falanops%2Fclaude-agentic-workflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falanops%2Fclaude-agentic-workflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falanops%2Fclaude-agentic-workflow/lists"}