diff --git a/CLAUDE.md b/CLAUDE.md
index 5d3e237b..c9886ba8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,7 +4,14 @@ Outpost is open-source infrastructure for managing and delivering platform event
 
 ## Code Review
 
-When reviewing pull requests, provide feedback on:
+When reviewing pull requests:
+
+### Formatting
+- Wrap all review feedback in a `<details>` section with a summary to keep comment threads easy to follow
+- Avoid using `#1`, `#2`, etc. for numbering as `#N` refers to issues/PRs in GitHub. Use `1.`, `a)`, or bullet points instead
+
+### Content
+Provide feedback on:
 - Code quality and best practices
 - Potential bugs or issues
 - Performance considerations