Create GitHub Issue
Standard process for creating well-structured GitHub issues. Use for bugs, feature requests, and tasks.
MCP connectors
| Connector |
Purpose |
| GitHub |
Create and label issues |
Bug report template
## Problem
[Clear description of what's broken. Include steps to reproduce.]
1. Step one
2. Step two
3. Observe: [what happens]
## Expected behavior
[What should happen instead]
**Environment**: [browser, OS, version, relevant config]
Feature request template
## Problem
[What user problem does this solve? Who is affected?]
## Expected behavior
[What the feature should do, from the user's perspective]
## Notes
[Optional: technical considerations, related issues, mockups]
Labels
| Label |
When to use |
bug |
Something is broken |
feature |
New functionality request |
enhancement |
Improvement to existing feature |
docs |
Documentation change needed |
good first issue |
Simple, well-scoped, good for new contributors |
priority:high |
Blocks users or causes data issues |
priority:low |
Nice to have, no urgency |
needs-triage |
Needs review before prioritization |
customer-reported |
Came from customer feedback |
Process
- Check for duplicates - search existing issues before creating
- Use the right template - bug report or feature request
- Add labels - at least one type label and one priority label
- Link related issues - reference with
#issue-number if related
- Assign - only if the assignee is clear; otherwise leave unassigned
Title format
- Bug:
[component] Short description of what's broken
- Feature:
[component] Short description of desired behavior
- Docs:
docs: Short description of what needs updating
Examples:
[API] Query timeout on large datasets
[Dashboard] Add date range filter to usage chart
docs: Update authentication setup guide
Guardrails
- No PII - scrub customer names, emails, and company names from all issue content
- One issue per problem - no omnibus issues covering multiple bugs
- No Impact section - keep body to Problem + Expected behavior only
- No confidential data - no API keys, credentials, or internal URLs in issues
- Don't close issues - only the CAO or the assignee closes issues
Self-improvement
After the CAO reviews created issues:
- If the CAO edits an issue title, body, or labels before posting, note the pattern
- If her edits reveal a preference for how problems are framed, bug reports are structured, or priorities are assigned, update the Templates or Labels sections
- Update
product/_insights.md with patterns: which issue formats get the fastest triage, which label conventions the team actually uses
- If an issue template works particularly well, save it to
product/_examples/ as a reference
1---2name: create-issue3description: Create GitHub Issue4---5# Create GitHub Issue67Standard process for creating well-structured GitHub issues. Use for bugs, feature requests, and tasks.89## MCP connectors1011| Connector | Purpose |12|-----------|---------|13| GitHub | Create and label issues |1415## Bug report template1617```markdown18## Problem1920[Clear description of what's broken. Include steps to reproduce.]21221. Step one232. Step two243. Observe: [what happens]2526## Expected behavior2728[What should happen instead]2930**Environment**: [browser, OS, version, relevant config]31```3233## Feature request template3435```markdown36## Problem3738[What user problem does this solve? Who is affected?]3940## Expected behavior4142[What the feature should do, from the user's perspective]4344## Notes4546[Optional: technical considerations, related issues, mockups]47```4849## Labels5051| Label | When to use |52|-------|------------|53| `bug` | Something is broken |54| `feature` | New functionality request |55| `enhancement` | Improvement to existing feature |56| `docs` | Documentation change needed |57| `good first issue` | Simple, well-scoped, good for new contributors |58| `priority:high` | Blocks users or causes data issues |59| `priority:low` | Nice to have, no urgency |60| `needs-triage` | Needs review before prioritization |61| `customer-reported` | Came from customer feedback |6263## Process64651. **Check for duplicates** - search existing issues before creating662. **Use the right template** - bug report or feature request673. **Add labels** - at least one type label and one priority label684. **Link related issues** - reference with `#issue-number` if related695. **Assign** - only if the assignee is clear; otherwise leave unassigned7071## Title format7273- Bug: `[component] Short description of what's broken`74- Feature: `[component] Short description of desired behavior`75- Docs: `docs: Short description of what needs updating`7677Examples:78- `[API] Query timeout on large datasets`79- `[Dashboard] Add date range filter to usage chart`80- `docs: Update authentication setup guide`8182## Guardrails8384- **No PII** - scrub customer names, emails, and company names from all issue content85- **One issue per problem** - no omnibus issues covering multiple bugs86- **No Impact section** - keep body to Problem + Expected behavior only87- **No confidential data** - no API keys, credentials, or internal URLs in issues88- **Don't close issues** - only the CAO or the assignee closes issues8990## Self-improvement9192After the CAO reviews created issues:93941. If the CAO edits an issue title, body, or labels before posting, note the pattern952. If her edits reveal a preference for how problems are framed, bug reports are structured, or priorities are assigned, update the Templates or Labels sections963. Update `product/_insights.md` with patterns: which issue formats get the fastest triage, which label conventions the team actually uses974. If an issue template works particularly well, save it to `product/_examples/` as a reference