docs: Document transient investigation note policy

cameroncooke · codex · cameroncooke · commit 4b9e189d0672 · 2026-05-01T14:29:19.000+01:00
Do not keep completed investigation notes in pull requests. Record unresolved
follow-up work in GitHub issues instead so branches only carry durable project
changes.

Co-Authored-By: Codex &lt;noreply@openai.com&gt;
diff --git a/AGENTS.md b/AGENTS.md
@@ -87,7 +87,9 @@ When reading issues:
 - Technical prose only, be kind but direct (e.g., "Thanks @user" not "Thanks so much @user!")
 
 ## Docs
--
+- Do not commit transient investigation notes, prompt exports, or scratch analysis docs after the work is complete.
+- If an investigation leaves unresolved follow-up work, move it to a GitHub issue instead of preserving the transient doc in the branch.
+
 ### Changelog
 Location: `CHANGELOG.md`
 
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -28,7 +28,9 @@ When reading issues:
 - Technical prose only, be kind but direct (e.g., "Thanks @user" not "Thanks so much @user!")
 
 ## Docs
--
+- Do not commit transient investigation notes, prompt exports, or scratch analysis docs after the work is complete.
+- If an investigation leaves unresolved follow-up work, move it to a GitHub issue instead of preserving the transient doc in the branch.
+
 ### Changelog
 Location: `CHANGELOG.md`
 
diff --git a/docs/investigations/orphaned-simctl-log-stream-2026-05-01.md b/docs/investigations/orphaned-simctl-log-stream-2026-05-01.md
