Merge pull request #544 from nanotaboada/chore/update-github-templates

chore(github): update issue templates and add PR template

Author: nanotaboada

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,8 +1,8 @@
 ---
 name: Bug report
 about: Report a bug or unexpected behavior
-title: "[BUG]"
-labels: bug
+title: ''
+labels: bug, python
 assignees: ''
 
 ---

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,7 +1,7 @@
 ---
 name: Feature request
 about: Propose a new feature or enhancement
-title: "[FEATURE]"
+title: ''
 labels: enhancement, python
 assignees: ''
 
@@ -15,17 +15,17 @@ What problem are you trying to solve? What's the pain point?
 
 Describe the expected behavior and functionality this feature will provide.
 
-## Suggested Approach
+## Suggested Approach _(optional)_
 
-Describe the technical implementation plan. Include architecture, key files/modules to modify, APIs, and any code patterns to follow.
+If known, describe the technical implementation plan. Include architecture, key files/modules to modify, APIs, and any code patterns to follow.
 
 ## Acceptance Criteria
 
 How will we know this feature is complete and working correctly?
 
-- [ ] Criterion 1
-- [ ] Criterion 2
-- [ ] Criterion 3
+- [ ] Feature behaves as described in the proposed solution
+- [ ] Tests are added or updated to cover the new functionality
+- [ ] No regressions in existing tests
 
 ## References
 

.github/copilot-instructions.md

@@ -168,6 +168,25 @@ Never suggest a release tag with a coach name not on this list.
   `schemas/player_schema.py` and `tools/` seed scripts
 - Production configurations
 
+### Creating Issues
+
+This project uses Spec-Driven Development (SDD): discuss in Plan mode first, create a GitHub Issue as the spec artifact, then implement. Always offer to draft an issue before writing code.
+
+**Feature request** (`enhancement` label):
+- **Problem**: the pain point being solved
+- **Proposed Solution**: expected behavior and functionality
+- **Suggested Approach** *(optional)*: implementation plan if known
+- **Acceptance Criteria**: at minimum — behaves as proposed, tests added/updated, no regressions
+- **References**: related issues, docs, or examples
+
+**Bug report** (`bug` label):
+- **Description**: clear summary of the bug
+- **Steps to Reproduce**: numbered, minimal steps
+- **Expected / Actual Behavior**: one section each
+- **Environment**: runtime versions + OS
+- **Additional Context**: logs, screenshots, stack traces
+- **Possible Solution** *(optional)*: suggested fix or workaround
+
 ### Key workflows
 
 **Add an endpoint**: Add Pydantic model in `models/` if the request/response

.github/pull_request_template.md

@@ -0,0 +1,21 @@
+## Summary
+
+Brief description of the changes and why they were made.
+
+## Type of Change
+
+- [ ] `feat` — new feature
+- [ ] `fix` — bug fix
+- [ ] `chore` — maintenance, tooling, or dependency update
+- [ ] `docs` — documentation only
+- [ ] `test` — adding or updating tests
+- [ ] `refactor` — code change that neither fixes a bug nor adds a feature
+- [ ] `ci` — CI/CD changes
+- [ ] `perf` — performance improvement
+
+## Checklist
+
+- [ ] `CHANGELOG.md` updated
+- [ ] All tests pass
+- [ ] No regressions introduced
+- [ ] Follows project coding guidelines