chore: improve issue and PR templates with industry best practices (#1088)

Bug report template:
- Add OS, Node.js version, shell, and install method fields
- Add all 6 supported runtimes (+ Multiple option)
- Add frequency and severity/impact dropdowns
- Add config.json, STATE.md, and settings.json retrieval instructions
- Add PII warnings on every field that could leak sensitive data
- Recommend presidio-anonymizer and scrub for log anonymization
- Add diagnostic commands for debugging install issues
- Add mandatory PII review checklist checkbox

Feature request template:
- Add scope dropdown (core workflow, planning, context, runtime, etc.)
- Add runtime multi-select checkboxes

New templates:
- Documentation issue template (incorrect, missing, unclear, outdated)
- config.yml to disable blank issues and link Discord/Discussions

PR template:
- Add linked issue reference (Closes #)
- Add How section for approach description
- Add runtime testing checklist (all 5 runtimes + N/A)
- Add template/reference update check
- Add test pass check
- Add screenshots/recordings section
This commit is contained in:
Tom Boucher
2026-03-16 10:54:52 -04:00
committed by GitHub
parent 9d7001a6b7
commit 1e46e820d6
5 changed files with 309 additions and 16 deletions

View File

@@ -6,21 +6,56 @@ body:
- type: markdown
attributes:
value: |
Thanks for suggesting a feature\! Please describe what you would like to see.
Thanks for suggesting a feature! Please describe what you'd like to see.
- type: textarea
id: problem
attributes:
label: Problem or motivation
description: What problem does this solve? Why do you want this?
placeholder: "I'm frustrated when..."
validations:
required: true
- type: textarea
id: solution
attributes:
label: Proposed solution
description: How do you think this should work?
description: How do you think this should work? Include example commands or workflows if possible.
placeholder: |
A new command `/gsd:example` that...
validations:
required: true
- type: dropdown
id: scope
attributes:
label: Which area does this affect?
options:
- Core workflow (init, plan, build, verify)
- Planning system (phases, roadmap, state)
- Context management (context engineering, summaries)
- Runtime integration (hooks, statusline, settings)
- Installation / setup
- Documentation
- Other
validations:
required: true
- type: checkboxes
id: runtimes
attributes:
label: Applicable runtimes
description: Which runtimes should this work with?
options:
- label: Claude Code
- label: Gemini CLI
- label: OpenCode
- label: Codex
- label: Copilot
- label: Antigravity
- label: All runtimes
- type: textarea
id: alternatives
attributes:
@@ -28,10 +63,11 @@ body:
description: Have you considered other approaches?
validations:
required: false
- type: textarea
id: context
attributes:
label: Additional context
description: Any other information, screenshots, or examples
description: Any other information, screenshots, or examples.
validations:
required: false