From ffd15e2603ff4e29f948b22d3c8fb499eb1d1636 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:55:04 +0000
Subject: [PATCH 1/2] Initial plan


From 999e82c3e6d71b66494437183a7b46ee41f0b0de Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:59:37 +0000
Subject: [PATCH 2/2] fix: normalize report formatting in scout.md - use h3
 headers and bold summary tags

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 .github/workflows/scout.md | 32 ++++++++++++++++++--------------
 1 file changed, 18 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/scout.md b/.github/workflows/scout.md
index e5e0131e89f..4e4c23bedd6 100644
--- a/.github/workflows/scout.md
+++ b/.github/workflows/scout.md
@@ -132,64 +132,68 @@ Create a comprehensive research summary that includes:
 
 **IMPORTANT**: You must ALWAYS post a comment with your findings, even if you did not find any relevant information. If you didn't find anything useful, explain what you searched for and why no relevant results were found.
 
+**Report Formatting**: Use h3 (###) or lower for all headers in the report to maintain proper document hierarchy. Wrap long sections in `<details><summary><b>Section Name</b></summary>` tags to improve readability.
+
 Your research summary should be formatted as a comment with:
 
 ```markdown
-# 🔍 Scout Research Report
+### 🔍 Scout Research Report
 
 *Triggered by @${{ github.actor }}*
 
-## Executive Summary
+### Executive Summary
 [Brief overview of key findings - or state that no relevant findings were discovered]
 
 <details>
-<summary>Click to expand detailed findings</summary>
-## Research Findings
+<summary><b>Click to expand detailed findings</b></summary>
+
+### Research Findings
 
-### [Topic 1]
+#### [Topic 1]
 [Detailed findings with sources]
 
-### [Topic 2]
+#### [Topic 2]
 [Detailed findings with sources]
 
 [... additional topics ...]
 
-## Recommendations
+### Recommendations
 - [Specific actionable recommendation 1]
 - [Specific actionable recommendation 2]
 - [...]
 
-## Key Sources
+### Key Sources
 - [Source 1 with link]
 - [Source 2 with link]
 - [...]
 
-## Suggested Next Steps
+### Suggested Next Steps
 1. [Action item 1]
 2. [Action item 2]
 [...]
+
 </details>
 ```
 
 **If no relevant findings were discovered**, use this format:
 
 ```markdown
-# 🔍 Scout Research Report
+### 🔍 Scout Research Report
 
 *Triggered by @${{ github.actor }}*
 
-## Executive Summary
+### Executive Summary
 No relevant findings were discovered for this research request.
 
-## Search Conducted
+### Search Conducted
 - Query 1: [What you searched for]
 - Query 2: [What you searched for]
 - [...]
 
-## Explanation
+### Explanation
 [Brief explanation of why no relevant results were found - e.g., topic too specific, no recent information available, search terms didn't match available content, etc.]
 
-## Suggestions
+### Suggestions
 [Optional: Suggestions for alternative searches or approaches that might yield better results]
 ```