GitHub Discussions Guide
June 22, 2026 ยท View on GitHub
GitHub Discussions should be used for open-ended conversations that do not require immediate maintainer action.
Use GitHub Issues for reproducible API integration problems, bugs, documentation gaps, and confirmed feature requests.
Recommended Categories
| Category | Purpose |
|---|---|
| Announcements | Official updates, model changes, quota changes, and release notes. |
| Q&A | Community questions and answers about model selection, integration patterns, and API behavior. |
| Ideas | Early feature ideas and product suggestions before they become actionable issues. |
| Show and tell | Examples, demos, workflows, and community integrations. |
| Roadmap feedback | Feedback on planned capabilities, compatibility needs, and developer experience. |
Suggested Workflow
- Start open-ended questions in Discussions.
- Mark a Q&A answer when the question is resolved.
- Convert actionable reports into Issues when maintainers need to track work.
- Pin important announcements or recurring questions.
- Close stale discussions that no longer help users.
Good Discussion Topics
- Which Agnes AI model should I use for a workflow?
- How are teams integrating Agnes AI into agent clients?
- What examples would help new developers?
- Which SDKs or tools should be prioritized?
- What compatibility guides should be added next?