diff --git a/.github/workflows/daily-safe-output-optimizer.md b/.github/workflows/daily-safe-output-optimizer.md
index f299cd84dc7..61cdd892639 100644
--- a/.github/workflows/daily-safe-output-optimizer.md
+++ b/.github/workflows/daily-safe-output-optimizer.md
@@ -219,7 +219,7 @@ Use the cache memory folder `/tmp/gh-aw/cache-memory/` to build persistent knowl
**Issue Structure:**
```markdown
-# Improve [Tool Name] Description to Prevent Agent Errors
+### Improve [Tool Name] Description to Prevent Agent Errors
### Summary
diff --git a/.github/workflows/dev-hawk.md b/.github/workflows/dev-hawk.md
index 3b38033f549..de7003f20e6 100644
--- a/.github/workflows/dev-hawk.md
+++ b/.github/workflows/dev-hawk.md
@@ -138,7 +138,7 @@ You monitor "Dev" workflow completions on copilot/* branches (workflow_dispatch
**Success:**
```markdown
-# ✅ Dev Hawk Report - Success
+### ✅ Dev Hawk Report - Success
**Workflow**: [#${{ github.event.workflow_run.run_number }}](${{ github.event.workflow_run.html_url }})
- Status: ${{ github.event.workflow_run.conclusion }}
- Commit: ${{ github.event.workflow_run.head_sha }}
@@ -148,30 +148,34 @@ Dev workflow completed successfully! 🎉
**Failure (with root cause identified):**
```markdown
-# ⚠️ Dev Hawk Report - Failure Analysis
+### ⚠️ Dev Hawk Report - Failure Analysis
**Workflow**: [#${{ github.event.workflow_run.run_number }}](${{ github.event.workflow_run.html_url }})
- Status: ${{ github.event.workflow_run.conclusion }}
- Commit: ${{ github.event.workflow_run.head_sha }}
-## Root Cause Analysis
+#### Root Cause Analysis
[Detailed explanation of what went wrong, correlating audit errors with PR changes]
-### Affected Files
+##### Affected Files
- `path/to/file.ext` - [Specific issue found]
- `path/to/another.ext` - [Another issue if applicable]
-## Error Details
+
+🔍 Error Details
+
```
[Key error messages from audit]
```
-## Agent Task Created
+
+
+#### Agent Task Created
🤖 I've created an agent task for Copilot to fix this issue:
- Task: [Agent Task URL or ID]
The task includes detailed instructions on what needs to be fixed and how to verify the solution.
-## Manual Review
+#### Manual Review
If you prefer to fix this manually:
- [ ] [Specific fix step 1]
- [ ] [Specific fix step 2]
@@ -180,18 +184,22 @@ If you prefer to fix this manually:
**Failure (without clear root cause):**
```markdown
-# ⚠️ Dev Hawk Report - Failure
+### ⚠️ Dev Hawk Report - Failure
**Workflow**: [#${{ github.event.workflow_run.run_number }}](${{ github.event.workflow_run.html_url }})
- Status: ${{ github.event.workflow_run.conclusion }}
- Commit: ${{ github.event.workflow_run.head_sha }}
-## Analysis Summary
+#### Analysis Summary
[Summary of failure from audit]
-## Key Errors
+
+🔍 Key Errors
+
[Error messages and patterns found]
-## Investigation Needed
+
+
+#### Investigation Needed
I couldn't automatically determine the exact root cause. This may require:
- [ ] Manual review of the error logs
- [ ] Deeper investigation of [specific area]
diff --git a/.github/workflows/pr-nitpick-reviewer.md b/.github/workflows/pr-nitpick-reviewer.md
index 6d4771667d7..d16db1090d9 100644
--- a/.github/workflows/pr-nitpick-reviewer.md
+++ b/.github/workflows/pr-nitpick-reviewer.md
@@ -171,7 +171,7 @@ For each nitpick found, decide on the appropriate output type:
**Format:**
```json
{
- "body": "## Overall Observations\n\nI noticed a few patterns across the PR:\n\n1. **Naming consistency**: Consider standardizing variable naming...\n2. **Good practices**: Excellent use of early returns!\n\nSee inline review comments for specific suggestions."
+ "body": "### Overall Observations\n\nI noticed a few patterns across the PR:\n\n1. **Naming consistency**: Consider standardizing variable naming...\n2. **Good practices**: Excellent use of early returns!\n\nSee inline review comments for specific suggestions."
}
```
@@ -192,14 +192,14 @@ Create a comprehensive markdown report using the imported `reporting.md` format:
**Report Structure:**
```markdown
-# PR Nitpick Review Summary - [DATE]
+### PR Nitpick Review Summary - [DATE]
Brief overview of the review findings and key patterns observed.
Full Review Report
-## Pull Request Overview
+#### Pull Request Overview
- **PR #**: ${{ github.event.pull_request.number }}
- **Title**: ${{ github.event.pull_request.title }}
@@ -207,27 +207,27 @@ Brief overview of the review findings and key patterns observed.
- **Files Changed**: [count]
- **Lines Added/Removed**: +[additions] -[deletions]
-## Nitpick Categories
+#### Nitpick Categories
-### 1. Naming and Conventions ([count] issues)
+##### 1. Naming and Conventions ([count] issues)
[List of specific issues with file references]
-### 2. Code Structure ([count] issues)
+##### 2. Code Structure ([count] issues)
[List of specific issues]
-### 3. Comments and Documentation ([count] issues)
+##### 3. Comments and Documentation ([count] issues)
[List of specific issues]
-### 4. Best Practices ([count] issues)
+##### 4. Best Practices ([count] issues)
[List of specific issues]
-## Pattern Analysis
+#### Pattern Analysis
-### Recurring Themes
+##### Recurring Themes
- **Theme 1**: [Description and frequency]
- **Theme 2**: [Description and frequency]
-### Historical Context
+##### Historical Context
[If cache memory available, compare to previous reviews]
| Review Date | PR # | Nitpick Count | Common Themes |
@@ -235,23 +235,23 @@ Brief overview of the review findings and key patterns observed.
| [today] | [#] | [count] | [themes] |
| [previous] | [#] | [count] | [themes] |
-## Positive Highlights
+#### Positive Highlights
Things done well in this PR:
- ✅ [Specific good practice observed]
- ✅ [Another good practice]
-## Recommendations
+#### Recommendations
-### For This PR
+##### For This PR
1. [Specific actionable item]
2. [Another actionable item]
-### For Future PRs
+##### For Future PRs
1. [General guidance for team]
2. [Pattern to watch for]
-## Learning Resources
+#### Learning Resources
[If applicable, links to style guides, best practices, etc.]