diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..ae5a75d
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,67 @@
+name: Bug report
+description: Report something that is not working as expected.
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for helping improve LearnHarness. Describe what you observed; you do not need to know the cause.
+
+        **This report is public.** Remove API keys, tokens, passwords and private information before posting. Never attach credential files or your whole data folder. Share only the learning content you are comfortable making public.
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Describe the problem and what you expected to happen instead.
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: LearnHarness version or build
+      description: Include the app version, installer filename or source commit. If you cannot find it, write "unknown".
+    validations:
+      required: true
+  - type: input
+    id: operating_system
+    attributes:
+      label: Operating system
+      description: For example, Windows, macOS or your Linux distribution. Include the OS version if known.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps or context (optional)
+      description: How can we reproduce it? If it is intermittent or you are unsure, describe what you were doing when it happened.
+    validations:
+      required: false
+  - type: input
+    id: installation
+    attributes:
+      label: Installation method (optional)
+      description: For example, desktop installer, AppImage, system package, self-hosted web or source build.
+    validations:
+      required: false
+  - type: input
+    id: provider_model
+    attributes:
+      label: Provider and model (if relevant)
+      description: Include the provider, model and API-key or subscription connection type if relevant. Do not include any keys or tokens.
+    validations:
+      required: false
+  - type: textarea
+    id: transcript_excerpt
+    attributes:
+      label: Sanitized raw JSON or chat-log excerpt (optional)
+      description: A few relevant entries around the affected turn or tool call are especially helpful. Paste the excerpt directly, preserving JSON escaping where possible. Remove credentials, personal information and private learning content first. Leave this blank if the records are difficult to find.
+      render: json
+    validations:
+      required: false
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots or other context (optional)
+      description: Attach screenshots or add other relevant details. Check for private information before posting.
+    validations:
+      required: false
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..0086358
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1 @@
+blank_issues_enabled: true
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 0000000..456ac46
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,17 @@
+name: Feature request
+description: Suggest a new feature or an improvement.
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Ideas are welcome; you do not need a finished design or implementation plan. A request opens a discussion, not a commitment to build it.
+
+        **This report is public.** Do not include credentials or private information.
+  - type: textarea
+    id: idea
+    attributes:
+      label: What would you like to see?
+      description: Describe your idea and the problem it would help you solve.
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/question.yml b/.github/ISSUE_TEMPLATE/question.yml
new file mode 100644
index 0000000..29d8d91
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/question.yml
@@ -0,0 +1,15 @@
+name: Question
+description: Ask about using LearnHarness.
+labels: [question]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **This report is public.** Do not include credentials or private information.
+  - type: textarea
+    id: question
+    attributes:
+      label: What is your question?
+      description: Include any relevant context. Version, OS, provider or model details can help when they relate to your question.
+    validations:
+      required: true