From c83c0badc2fbbcc777c4b95456e8c9bb36d72157 Mon Sep 17 00:00:00 2001
From: Richard Tibbles <richard@learningequality.org>
Date: Sat, 7 Feb 2026 13:28:59 -0800
Subject: [PATCH 1/2] Add DEEP framework AI usage guidance to issue and PR
 templates

Replace minimal AI disclosure comment in all 7 issue templates and add
a new AI usage section to the PR template, embedding Learning Equality's
DEEP guidelines (Disclose, Engage critically, Edit, Process sharing)
with context-appropriate examples for each template type.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .github/ISSUE_TEMPLATE/bug_issue.md           | 25 +++++++++++++++--
 .github/ISSUE_TEMPLATE/enhancement_issue.md   | 25 +++++++++++++++--
 .github/ISSUE_TEMPLATE/feature_issue.md       | 25 +++++++++++++++--
 .github/ISSUE_TEMPLATE/other_issue.md         | 25 +++++++++++++++--
 .github/ISSUE_TEMPLATE/product_issue.md       | 25 +++++++++++++++--
 .../ISSUE_TEMPLATE/technical_task_issue.md    | 25 +++++++++++++++--
 .../technical_tracking_issue.md               | 25 +++++++++++++++--
 .github/PULL_REQUEST_TEMPLATE.md              | 27 +++++++++++++++++++
 8 files changed, 188 insertions(+), 14 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_issue.md b/.github/ISSUE_TEMPLATE/bug_issue.md
index aa75ae0..e1301a5 100644
--- a/.github/ISSUE_TEMPLATE/bug_issue.md
+++ b/.github/ISSUE_TEMPLATE/bug_issue.md
@@ -67,6 +67,27 @@ Tell us about your environment, including:
 …
 
 <!--
-AI DISCLOSURE: If this issue was written with AI assistance, add:
-🤖 This issue was written with AI assistance, under supervision, review and final edits by [@username] 🤖
+AI USAGE - DEEP guidelines
+
+If AI was used in preparing this issue, please fill in the section below.
+Our DEEP guidelines ask that when using AI you:
+
+  Disclose - Be open about when you've used AI for support.
+  Engage critically - Question what is generated. Verify claims and sources.
+  Edit - Digest and refine AI output rather than copy-pasting it.
+  Process sharing - Explain how you used the AI so others can learn.
+
+Examples of good disclosures:
+
+  "I used Gemini to help draft this issue from my rough notes. I edited
+  the description for accuracy, confirmed the reproduction steps myself,
+  and trimmed the verbose output."
+
+  "This is based on a Claude summary of clearinghouse feedback. I
+  cross-checked the key points against the original feedback and rewrote
+  the requirements in my own words."
+
+If AI was not used, delete the section below.
 -->
+
+## AI usage
diff --git a/.github/ISSUE_TEMPLATE/enhancement_issue.md b/.github/ISSUE_TEMPLATE/enhancement_issue.md
index 637b054..ef687bb 100644
--- a/.github/ISSUE_TEMPLATE/enhancement_issue.md
+++ b/.github/ISSUE_TEMPLATE/enhancement_issue.md
@@ -29,6 +29,27 @@ Instructions:
 
 
 <!--
-AI DISCLOSURE: If this issue was written with AI assistance, add:
-🤖 This issue was written with AI assistance, under supervision, review and final edits by [@username] 🤖
+AI USAGE - DEEP guidelines
+
+If AI was used in preparing this issue, please fill in the section below.
+Our DEEP guidelines ask that when using AI you:
+
+  Disclose - Be open about when you've used AI for support.
+  Engage critically - Question what is generated. Verify claims and sources.
+  Edit - Digest and refine AI output rather than copy-pasting it.
+  Process sharing - Explain how you used the AI so others can learn.
+
+Examples of good disclosures:
+
+  "I used Gemini to help draft this issue from my rough notes. I edited
+  the description for accuracy, confirmed the reproduction steps myself,
+  and trimmed the verbose output."
+
+  "This is based on a Claude summary of clearinghouse feedback. I
+  cross-checked the key points against the original feedback and rewrote
+  the requirements in my own words."
+
+If AI was not used, delete the section below.
 -->
+
+## AI usage
diff --git a/.github/ISSUE_TEMPLATE/feature_issue.md b/.github/ISSUE_TEMPLATE/feature_issue.md
index 60957a1..3bc573b 100644
--- a/.github/ISSUE_TEMPLATE/feature_issue.md
+++ b/.github/ISSUE_TEMPLATE/feature_issue.md
@@ -41,6 +41,27 @@ _[Issues should be attached as sub issues as they are created. There will probab
 
 
 <!--
-AI DISCLOSURE: If this issue was written with AI assistance, add:
-🤖 This issue was written with AI assistance, under supervision, review and final edits by [@username] 🤖
+AI USAGE - DEEP guidelines
+
+If AI was used in preparing this issue, please fill in the section below.
+Our DEEP guidelines ask that when using AI you:
+
+  Disclose - Be open about when you've used AI for support.
+  Engage critically - Question what is generated. Verify claims and sources.
+  Edit - Digest and refine AI output rather than copy-pasting it.
+  Process sharing - Explain how you used the AI so others can learn.
+
+Examples of good disclosures:
+
+  "I used Gemini to help draft this issue from my rough notes. I edited
+  the description for accuracy, confirmed the reproduction steps myself,
+  and trimmed the verbose output."
+
+  "This is based on a Claude summary of clearinghouse feedback. I
+  cross-checked the key points against the original feedback and rewrote
+  the requirements in my own words."
+
+If AI was not used, delete the section below.
 -->
+
+## AI usage
diff --git a/.github/ISSUE_TEMPLATE/other_issue.md b/.github/ISSUE_TEMPLATE/other_issue.md
index b78f4a9..5886e69 100644
--- a/.github/ISSUE_TEMPLATE/other_issue.md
+++ b/.github/ISSUE_TEMPLATE/other_issue.md
@@ -8,6 +8,27 @@ about: For issues that don't fit any other category
 
 
 <!--
-AI DISCLOSURE: If this issue was written with AI assistance, add:
-🤖 This issue was written with AI assistance, under supervision, review and final edits by [@username] 🤖
+AI USAGE - DEEP guidelines
+
+If AI was used in preparing this issue, please fill in the section below.
+Our DEEP guidelines ask that when using AI you:
+
+  Disclose - Be open about when you've used AI for support.
+  Engage critically - Question what is generated. Verify claims and sources.
+  Edit - Digest and refine AI output rather than copy-pasting it.
+  Process sharing - Explain how you used the AI so others can learn.
+
+Examples of good disclosures:
+
+  "I used Gemini to help draft this issue from my rough notes. I edited
+  the description for accuracy, confirmed the reproduction steps myself,
+  and trimmed the verbose output."
+
+  "This is based on a Claude summary of clearinghouse feedback. I
+  cross-checked the key points against the original feedback and rewrote
+  the requirements in my own words."
+
+If AI was not used, delete the section below.
 -->
+
+## AI usage
diff --git a/.github/ISSUE_TEMPLATE/product_issue.md b/.github/ISSUE_TEMPLATE/product_issue.md
index 469f260..88e051b 100644
--- a/.github/ISSUE_TEMPLATE/product_issue.md
+++ b/.github/ISSUE_TEMPLATE/product_issue.md
@@ -23,6 +23,27 @@ _[Then, more detail. Provide a short summary and/or list key outcomes that the u
 
 
 <!--
-AI DISCLOSURE: If this issue was written with AI assistance, add:
-🤖 This issue was written with AI assistance, under supervision, review and final edits by [@username] 🤖
+AI USAGE - DEEP guidelines
+
+If AI was used in preparing this issue, please fill in the section below.
+Our DEEP guidelines ask that when using AI you:
+
+  Disclose - Be open about when you've used AI for support.
+  Engage critically - Question what is generated. Verify claims and sources.
+  Edit - Digest and refine AI output rather than copy-pasting it.
+  Process sharing - Explain how you used the AI so others can learn.
+
+Examples of good disclosures:
+
+  "I used Gemini to help draft this issue from my rough notes. I edited
+  the description for accuracy, confirmed the reproduction steps myself,
+  and trimmed the verbose output."
+
+  "This is based on a Claude summary of clearinghouse feedback. I
+  cross-checked the key points against the original feedback and rewrote
+  the requirements in my own words."
+
+If AI was not used, delete the section below.
 -->
+
+## AI usage
diff --git a/.github/ISSUE_TEMPLATE/technical_task_issue.md b/.github/ISSUE_TEMPLATE/technical_task_issue.md
index 0580c16..0454352 100644
--- a/.github/ISSUE_TEMPLATE/technical_task_issue.md
+++ b/.github/ISSUE_TEMPLATE/technical_task_issue.md
@@ -102,6 +102,27 @@ Links to documentation, code references, or relevant libraries.
 -->
 
 <!--
-AI DISCLOSURE: If this issue was written with AI assistance, add:
-🤖 This issue was written with AI assistance, under supervision, review and final edits by [@username] 🤖
+AI USAGE - DEEP guidelines
+
+If AI was used in preparing this issue, please fill in the section below.
+Our DEEP guidelines ask that when using AI you:
+
+  Disclose - Be open about when you've used AI for support.
+  Engage critically - Question what is generated. Verify claims and sources.
+  Edit - Digest and refine AI output rather than copy-pasting it.
+  Process sharing - Explain how you used the AI so others can learn.
+
+Examples of good disclosures:
+
+  "I used Gemini to help draft this issue from my rough notes. I edited
+  the description for accuracy, confirmed the reproduction steps myself,
+  and trimmed the verbose output."
+
+  "This is based on a Claude summary of clearinghouse feedback. I
+  cross-checked the key points against the original feedback and rewrote
+  the requirements in my own words."
+
+If AI was not used, delete the section below.
 -->
+
+## AI usage
diff --git a/.github/ISSUE_TEMPLATE/technical_tracking_issue.md b/.github/ISSUE_TEMPLATE/technical_tracking_issue.md
index 740aa6c..6e3e0be 100644
--- a/.github/ISSUE_TEMPLATE/technical_tracking_issue.md
+++ b/.github/ISSUE_TEMPLATE/technical_tracking_issue.md
@@ -53,6 +53,27 @@ Otherwise, leave testing guidance to individual task issues.
 -->
 
 <!--
-AI DISCLOSURE: If this issue was written with AI assistance, add:
-🤖 This issue was written with AI assistance, under supervision, review and final edits by [@username] 🤖
+AI USAGE - DEEP guidelines
+
+If AI was used in preparing this issue, please fill in the section below.
+Our DEEP guidelines ask that when using AI you:
+
+  Disclose - Be open about when you've used AI for support.
+  Engage critically - Question what is generated. Verify claims and sources.
+  Edit - Digest and refine AI output rather than copy-pasting it.
+  Process sharing - Explain how you used the AI so others can learn.
+
+Examples of good disclosures:
+
+  "I used Gemini to help draft this issue from my rough notes. I edited
+  the description for accuracy, confirmed the reproduction steps myself,
+  and trimmed the verbose output."
+
+  "This is based on a Claude summary of clearinghouse feedback. I
+  cross-checked the key points against the original feedback and rewrote
+  the requirements in my own words."
+
+If AI was not used, delete the section below.
 -->
+
+## AI usage
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 07a4441..97a94b4 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -29,3 +29,30 @@
 -->
 
 …
+
+<!--
+AI USAGE - DEEP guidelines
+
+If AI was used in preparing this PR, please fill in the section below.
+Our DEEP guidelines ask that when using AI you:
+
+  Disclose - Be open about when you've used AI for support.
+  Engage critically - Question what is generated. Review code for correctness and unnecessary complexity.
+  Edit - Review and refine AI output. Remove unnecessary code and verify it still works after your edits.
+  Process sharing - Explain how you used the AI so others can learn.
+
+Examples of good disclosures:
+
+  "I used Claude Code to implement the component, prompting it to follow
+  the pattern in ComponentX. I reviewed the generated code, removed
+  unnecessary error handling, and verified the tests pass."
+
+  "I brainstormed the approach with Gemini, then had it write failing
+  tests for the feature. After reviewing the tests, I used Claude Code
+  to generate the implementation. I refactored the output to reduce
+  verbosity and ran the full test suite."
+
+If AI was not used, delete the section below.
+-->
+
+## AI usage

From 142da9fb4ef7b371149b398dff1c4fc9597c8b56 Mon Sep 17 00:00:00 2001
From: Richard Tibbles <richard@learningequality.org>
Date: Sat, 7 Feb 2026 13:44:25 -0800
Subject: [PATCH 2/2] Add target branch field to technical task issue template

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .github/ISSUE_TEMPLATE/bug_issue.md            | 2 ++
 .github/ISSUE_TEMPLATE/enhancement_issue.md    | 2 ++
 .github/ISSUE_TEMPLATE/technical_task_issue.md | 1 +
 3 files changed, 5 insertions(+)

diff --git a/.github/ISSUE_TEMPLATE/bug_issue.md b/.github/ISSUE_TEMPLATE/bug_issue.md
index e1301a5..ce1afa8 100644
--- a/.github/ISSUE_TEMPLATE/bug_issue.md
+++ b/.github/ISSUE_TEMPLATE/bug_issue.md
@@ -12,6 +12,8 @@ Instructions:
  * Use the 'preview' function above this text box to verify formatting before submitting
 -->
 
+**Target branch:** <!-- e.g. develop, release-0.17.x -->
+
 ## Observed behavior
 <!--
 Description of the behavior that was observed, including screenshots or other references when applicable
diff --git a/.github/ISSUE_TEMPLATE/enhancement_issue.md b/.github/ISSUE_TEMPLATE/enhancement_issue.md
index ef687bb..6265572 100644
--- a/.github/ISSUE_TEMPLATE/enhancement_issue.md
+++ b/.github/ISSUE_TEMPLATE/enhancement_issue.md
@@ -14,6 +14,8 @@ Instructions:
 
 -->
 
+**Target branch:** <!-- e.g. develop, release-0.17.x -->
+
 ## Current behavior
 <!-- Briefly describe the current behavior; you may include screenshots, code, and notes -->
 
diff --git a/.github/ISSUE_TEMPLATE/technical_task_issue.md b/.github/ISSUE_TEMPLATE/technical_task_issue.md
index 0454352..7850f32 100644
--- a/.github/ISSUE_TEMPLATE/technical_task_issue.md
+++ b/.github/ISSUE_TEMPLATE/technical_task_issue.md
@@ -19,6 +19,7 @@ Keep it brief - a few sentences.
 -->
 
 **Complexity:** Low | Medium | High
+**Target branch:** <!-- e.g. develop, release-0.17.x -->
 
 ### Context