ci: add github templates

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,66 @@
+name: 🐛 Bug Report
+description: Report a reproducible issue in the API
+labels: [bug]
+body:
+  - type: input
+    id: summary
+    attributes:
+      label: Summary
+      description: Concisely describe the bug
+      placeholder: "API returns 500 when posting to /users"
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Provide detailed steps, including endpoint, payload, headers, and auth context
+      placeholder: |
+        1. Endpoint: POST /api/v1/users
+        2. Payload: { "name": "..." }
+        3. Headers: Authorization: Bearer <token>
+        4. Steps...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What should have happened
+      placeholder: "User is created and 201 is returned"
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+      placeholder: "500 Internal Server Error"
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / Stack Trace
+      description: Paste relevant logs or stack trace
+      render: shell
+
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: Java version, Spring Boot version, build tool, deployment context
+      placeholder: "Java 25, Spring Boot 3.5.7, Maven 3.9.5, Docker"
+
+  - type: checkboxes
+    attributes:
+      label: Pre-checks
+      options:
+        - label: I have searched existing issues to avoid duplicates
+          required: true
+        - label: I have tested with the latest version
+          required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,52 @@
+name: ✨ Feature Request
+description: Suggest a new feature or improvement
+labels: [enhancement]
+body:
+  - type: input
+    id: summary
+    attributes:
+      label: Summary
+      description: Concisely describe the feature
+      placeholder: "Add pagination to /users endpoint"
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve?
+      placeholder: "Currently, fetching all users at once is inefficient..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe your proposed solution
+      placeholder: "Implement pageable queries with limit/offset parameters"
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Have you considered other approaches?
+      placeholder: "Client-side filtering, caching, etc."
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Add any other context, screenshots, or references
+
+  - type: checkboxes
+    id: confirmations
+    attributes:
+      label: Pre-Work Checklist
+      description: Confirm these before starting
+      options:
+        - label: No existing issue covers this work.
+          required: true

.github/ISSUE_TEMPLATE/task.yml

@@ -0,0 +1,46 @@
+name: 📋 Task
+description: Development or maintenance task
+labels: [task]
+
+body:
+  - type: input
+    id: summary
+    attributes:
+      label: Summary
+      description: Concisely describe the task
+      placeholder: "Refactor UserService to improve readability"
+    validations:
+      required: true
+
+  - type: textarea
+    id: details
+    attributes:
+      label: Details
+      description: Provide more context or technical details
+      placeholder: "Move validation logic into a separate component..."
+
+  - type: textarea
+    id: subtasks
+    attributes:
+      label: Subtasks
+      description: Break down the work into smaller actionable items
+      placeholder: |
+        - [ ] Implement new validation class
+        - [ ] Update service layer
+        - [ ] Add unit tests
+
+  - type: textarea
+    id: notes
+    attributes:
+      label: Additional Notes / References
+      description: Add any relevant links, documentation, or references
+      placeholder: "See doc: https://..."
+
+  - type: checkboxes
+    id: confirmations
+    attributes:
+      label: Pre-Work Checklist
+      description: Confirm these before starting
+      options:
+        - label: No existing issue covers this work.
+          required: true

.github/pull_request_template.md

@@ -0,0 +1,21 @@
+## Description
+<!-- Describe your changes in detail -->
+
+## Related Issue
+Closes #<issue-number>
+
+## Type of Change
+- [ ] feat
+- [ ] fix
+- [ ] docs
+- [ ] refactor
+- [ ] chore
+- [ ] test
+- [ ] ci
+
+## How Has This Been Tested?
+<!-- Describe test process and results -->
+
+## Checklist
+  - [ ] I have followed the Conventional Commits naming rules
+  - [ ] I have added tests where applicable