diff --git a/.github/workflows/bot-detection.md b/.github/workflows/bot-detection.md
index ca3f9d7b0cb..a9fe823d6e4 100644
--- a/.github/workflows/bot-detection.md
+++ b/.github/workflows/bot-detection.md
@@ -866,6 +866,8 @@ Maintain a **single** open triage issue with the exact title:
 
 ## Report Format (Issue Body)
 
+**Report Formatting**: Use h3 (###) or lower for all headers in the report. Wrap long sections (>10 items) in `<details><summary><b>Section Name</b></summary>` tags to improve readability.
+
 Produce a concise, evidence-driven report:
 
 - **Window**: last 6 hours (include timestamps)
diff --git a/.github/workflows/step-name-alignment.md b/.github/workflows/step-name-alignment.md
index b537f082b75..fb6af4ff410 100644
--- a/.github/workflows/step-name-alignment.md
+++ b/.github/workflows/step-name-alignment.md
@@ -248,9 +248,11 @@ When you identify problems worth addressing, create issues using safe-outputs.
 [step-names] Align step names in <workflow-name> with glossary/consistency
 ```
 
+**Report Formatting**: Use h3 (###) or lower for all headers in the report. Wrap long sections (>10 items) in `<details><summary><b>Section Name</b></summary>` tags to improve readability.
+
 **Issue Description Template:**
 ```markdown
-## Step Name Alignment Issues
+### Step Name Alignment Issues
 
 Found in: `.github/workflows/<workflow-name>.lock.yml`