From 51ca822da738cbc248e779b6a3fa1845ff8e40ad Mon Sep 17 00:00:00 2001
From: Jay Dreyer <jay.dreyer@gmail.com>
Date: Thu, 6 Aug 2026 11:10:01 -0500
Subject: [PATCH] Add GitHub issue templates

---
 .github/ISSUE_TEMPLATE/bug.yml        | 37 ++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/feature.yml    | 45 +++++++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/quick-task.yml | 24 ++++++++++++++
 3 files changed, 106 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature.yml
 create mode 100644 .github/ISSUE_TEMPLATE/quick-task.yml

diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml
new file mode 100644
index 0000000..fb25341
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.yml
@@ -0,0 +1,37 @@
+name: Bug
+description: Unexpected existing behavior
+title: "[Bug] "
+labels:
+  - "type:bug"
+  - "status:needs-refinement"
+body:
+  - type: textarea
+    id: observed
+    attributes:
+      label: Observed behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction steps
+      placeholder: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence
+      description: Logs, screenshots, error messages, or failing test.
diff --git a/.github/ISSUE_TEMPLATE/feature.yml b/.github/ISSUE_TEMPLATE/feature.yml
new file mode 100644
index 0000000..60f7ab3
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature.yml
@@ -0,0 +1,45 @@
+name: Feature
+description: A normal product or engineering feature
+title: ""
+labels:
+  - "type:feature"
+  - "status:needs-refinement"
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem exists today?
+    validations:
+      required: true
+
+  - type: textarea
+    id: outcome
+    attributes:
+      label: Desired outcome
+      description: What should become possible?
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      placeholder: |
+        - [ ] Observable behavior one
+        - [ ] Observable behavior two
+        - [ ] Relevant failure path
+    validations:
+      required: true
+
+  - type: textarea
+    id: constraints
+    attributes:
+      label: Constraints
+      description: Security, compatibility, scope, architecture, or product constraints.
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Relevant context
+      description: Related files, docs, screenshots, issues, or decisions.
diff --git a/.github/ISSUE_TEMPLATE/quick-task.yml b/.github/ISSUE_TEMPLATE/quick-task.yml
new file mode 100644
index 0000000..17f513e
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/quick-task.yml
@@ -0,0 +1,24 @@
+name: Quick task
+description: A small, already-decided change
+title: ""
+labels:
+  - "status:ready"
+body:
+  - type: textarea
+    id: change
+    attributes:
+      label: Change
+      description: What needs to change?
+    validations:
+      required: true
+
+  - type: textarea
+    id: done
+    attributes:
+      label: Done when
+      description: List observable acceptance criteria.
+      placeholder: |
+        - [ ] Criterion one
+        - [ ] Criterion two
+    validations:
+      required: true