From 6c663cf98c9245ec24adac2d5eb236107db151fd Mon Sep 17 00:00:00 2001
From: Kirk Marple <kirk@clockgrove.com>
Date: Tue, 13 Oct 2026 19:56:27 -0700
Subject: [PATCH] Provide native issue types in organization contribution
 defaults

---
 .github/ISSUE_TEMPLATE/bug_report.yml      | 18 ++++++++++++++++++
 .github/ISSUE_TEMPLATE/feature_request.yml | 18 ++++++++++++++++++
 .github/ISSUE_TEMPLATE/task.yml            | 11 +++++++++++
 CONTRIBUTING.md                            | 15 +++++++++++++++
 4 files changed, 62 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml
 create mode 100644 .github/ISSUE_TEMPLATE/task.yml
 create mode 100644 CONTRIBUTING.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..79fc8d1
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,18 @@
+name: Bug report
+description: Report a defect in this repository
+type: Bug
+body:
+  - type: textarea
+    id: behavior
+    attributes:
+      label: Expected and observed behavior
+      description: Describe the defect without including credentials or private source.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Include minimal steps and the relevant version or environment.
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 0000000..e0e9dbe
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,18 @@
+name: Feature request
+description: Propose a capability or improvement
+type: Feature
+body:
+  - type: textarea
+    id: outcome
+    attributes:
+      label: Desired outcome
+      description: Describe what should become possible without including private source.
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance and boundaries
+      description: Explain how to verify the outcome and what is outside the request.
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/task.yml b/.github/ISSUE_TEMPLATE/task.yml
new file mode 100644
index 0000000..96d411b
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/task.yml
@@ -0,0 +1,11 @@
+name: Task
+description: Track maintenance, investigation or qualification
+type: Task
+body:
+  - type: textarea
+    id: outcome
+    attributes:
+      label: Task outcome
+      description: Describe the work and its completion criteria without including private source.
+    validations:
+      required: true
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..c89590b
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,15 @@
+# Contributing to Clockgrove
+
+Read the target repository's README, AGENTS.md and contributor guidance before making a change. Search existing issues before opening a new one.
+
+Set the native GitHub issue type explicitly:
+
+- `Bug` for a standalone defect.
+- `Feature` for a requested capability or Factory Objective.
+- `Task` for a Work Item, maintenance, investigation or qualification. A corrective Work Item remains `Task`.
+
+Use labels for independent information such as area, priority, phase or Factory role. Do not add redundant `bug`, `enhancement`, `feature` or `task` classification labels. Preserve required role labels such as `factory:objective` and `factory:work-item`.
+
+Issue forms must set their top-level `type`. When creating an issue through a CLI or API, supply the type explicitly and verify the returned issue's type and labels. Do not assume a title or label assigned the type, and do not leave issues untyped when an appropriate native type is available.
+
+An issue's type or Project placement does not authorize execution, spending or deployment. Follow the target repository's existing approval and delivery rules. Keep credentials, private source and raw agent transcripts out of public issues.