From 069f6e112b176c127b169978abdc44710f7f6ddb Mon Sep 17 00:00:00 2001
From: Christian Tabedzki <35670232+tabedzki@users.noreply.github.com>
Date: Fri, 16 Oct 2026 16:16:07 -0400
Subject: [PATCH] docs: keep the agent bug report and log pasted errors in it

The agent bug report issue template is back. Its first section is now
"Reported error": the error exactly as the user pasted it, instead of a Slack
link. AGENTS.md tells agents to file this issue, from the user's account,
before fixing an error, so bugs get logged. In the pipeline and Streamlit
repos the rule is "always".

Assisted-by: ClaudeCode:claude-sonnet-5-5
---
 .github/ISSUE_TEMPLATE/agent_bug_report.md | 26 ++++++++++++++++++++++
 AGENTS.md                                  |  2 +-
 2 files changed, 27 insertions(+), 1 deletion(-)
 create mode 100644 .github/ISSUE_TEMPLATE/agent_bug_report.md

diff --git a/.github/ISSUE_TEMPLATE/agent_bug_report.md b/.github/ISSUE_TEMPLATE/agent_bug_report.md
new file mode 100644
index 00000000..8f6fc7ce
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/agent_bug_report.md
@@ -0,0 +1,26 @@
+---
+name: Agent bug report
+about: Filed by an AI agent for an error the user reported (rig users, use Bug report)
+title: "[BUG]"
+labels: ''
+assignees: tabedzki
+
+---
+
+:robot: _AI text below_ :robot:
+
+**Reported error**
+The error as the user pasted it, verbatim (no link needed):
+
+```
+<error text, traceback or message, exactly as pasted>
+```
+
+**Regression test**
+`<tests/path.py::test_name>` reproduces the error: it fails on `<base commit>` with the traceback above and passes with the fix.
+
+**Root cause**
+What is wrong in the code and why it produced this error, with `file.py:line` references.
+
+**Linked PR**
+<#PR number, opened with the regression test before the fix>
diff --git a/AGENTS.md b/AGENTS.md
index b16379e3..d323ad0f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -29,6 +29,6 @@ Lint: `uvx prek run --all-files` (the same as CI's Lint workflow).
 
 ## Agent workflow
 
-- Errors reported in Slack: use the `bugfix-from-slack` skill (agent-tooling). The agent files nothing itself: commits, pushes and PRs are the user's.
+- Bugs: when you fix an error the user reported, first file an agent bug report issue from the user's account (`gh issue create -R BrainCOGS/RecordingProcessJobGUI`, template `.github/ISSUE_TEMPLATE/agent_bug_report.md`). Put the error exactly as the user pasted it under **Reported error**; don't ask for or invent a Slack link. Then fix it with the `bugfix-from-slack` skill (agent-tooling); the PR says `Fixes #<issue>`. Commits, pushes, issues and PRs all go through the user's account.
 - Commits end with one `Assisted-by: <Harness>:<model>` trailer per agent, e.g. `Assisted-by: ClaudeCode:claude-opus-5-5`. No AI co-authors, and no `Generated with` lines. `prek install` sets up the `ai-attribution` commit-msg hook (`.github/scripts/check_ai_attribution.py`, vendored from agent-tooling), and CI checks every commit of a PR.
 - PRs target `main` on `BrainCOGS/RecordingProcessJobGUI`, opened from the user's own account.