Workflows to Update
The following workflows generate reports/issues but don't import shared/reporting.md and lack markdown style guidelines in their prompts:
| Workflow File |
Creates |
Issues Found |
.github/workflows/deployment-incident-monitor.md |
Issues |
Missing shared/reporting.md import; no h3+/<details> guidance |
.github/workflows/copilot-pr-merged-report.md |
Issues |
Missing shared/reporting.md import; no h3+/<details> guidance |
.github/workflows/pr-triage-agent.md |
Issues |
Missing shared/reporting.md import; no h3+/<details> guidance |
Required Changes
For each workflow listed above, add the shared/reporting.md import or add explicit formatting instructions to the prompt.
Option A — Add Import (Preferred)
In the frontmatter imports: block, add:
imports:
- shared/reporting.md
# ... existing imports
Option B — Add Inline Instructions
Add these formatting guidelines to the prompt:
#### 1. Header Levels
Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy.
#### 2. Progressive Disclosure
Wrap long sections in `<details><summary>Section Name</summary>` tags to improve readability and reduce scrolling.
Recommended Report Structure
### Summary
- Key metric 1: value
- Status: ✅/⚠️/❌
### Critical Issues
[Always visible]
<details>
<summary>View Detailed Results</summary>
[Long details here]
</details>
### Recommendations
[Actionable next steps]
Design Principles (Airbnb-Inspired)
Updated workflows should produce reports that:
- Build trust through clarity: Most important info immediately visible
- Exceed expectations: Add helpful context, trends, comparisons
- Create delight: Use progressive disclosure to reduce overwhelm
- Maintain consistency: Follow patterns as
agent-performance-analyzer, test-quality-sentinel, and aw-failure-investigator (all already use shared/reporting.md)
Context
- Workflows already compliant (use
shared/reporting.md): agent-performance-analyzer, aw-failure-investigator, auto-triage-issues, test-quality-sentinel
- The
shared/reporting.md file at .github/workflows/shared/reporting.md contains the full style guide
- Review triggered by Workflow Normalizer run §26038231441
Generated by 🔧 Workflow Normalizer · ● 6.8M · ◷
Workflows to Update
The following workflows generate reports/issues but don't import
shared/reporting.mdand lack markdown style guidelines in their prompts:.github/workflows/deployment-incident-monitor.mdshared/reporting.mdimport; no h3+/<details>guidance.github/workflows/copilot-pr-merged-report.mdshared/reporting.mdimport; no h3+/<details>guidance.github/workflows/pr-triage-agent.mdshared/reporting.mdimport; no h3+/<details>guidanceRequired Changes
For each workflow listed above, add the
shared/reporting.mdimport or add explicit formatting instructions to the prompt.Option A — Add Import (Preferred)
In the frontmatter
imports:block, add:Option B — Add Inline Instructions
Add these formatting guidelines to the prompt:
Recommended Report Structure
Design Principles (Airbnb-Inspired)
Updated workflows should produce reports that:
agent-performance-analyzer,test-quality-sentinel, andaw-failure-investigator(all already useshared/reporting.md)Context
shared/reporting.md):agent-performance-analyzer,aw-failure-investigator,auto-triage-issues,test-quality-sentinelshared/reporting.mdfile at.github/workflows/shared/reporting.mdcontains the full style guide