GitHub Contribution Workflow
Prerequisites
- Changes committed in a feature branch
- Duplicates already verified by user
Workflow
1. Check Contribution Guidelines
Deploy explore agent to find contribution guidelines:
- Look for CONTRIBUTING.md, README, issue/PR templates
- Extract: title format, target branch, required labels
2. Detect Fork & Push
git remote -v # identify fork remote
git push -u <fork-remote> <branch>
3. Create Issue
gh issue create --repo <owner>/<repo> \
--title "<title per guidelines>" \
--body "<body>"
4. Create PR
gh pr create --repo <owner>/<repo> \
--head <fork-user>:<branch> \
--base <target-branch> \
--title "<title>" \
--body "## Summary
<description>
Closes #<issue-number>"
5. Comment on Issue
gh issue comment <issue-number> --repo <owner>/<repo> --body "PR: #<pr-number>"
Default Conventions
Use only if no contribution guidelines found:
| Type | Issue Prefix | PR Prefix |
|---|---|---|
| Feature | [FEATURE]: | feat: |
| Bug | [BUG]: | fix: |
| Docs | [DOCS]: | docs: |
| Chore | [CHORE]: | chore: |
Flow
changes committed -> push to fork -> open issue -> open pr -> comment on issue