Workflows to Update
The following workflows generate reports but use incorrect header levels or lack progressive disclosure:
| Workflow File |
Issues Found |
.github/workflows/copilot-agent-analysis.md |
Template uses # and ## headers; no <details> progressive disclosure |
Required Changes
.github/workflows/copilot-agent-analysis.md
The Concise Discussion Template (Phase 6) uses # and ## headers and has no <details> sections. Update to:
-
Header Levels — Replace # and ## with ### and #### throughout the template.
-
Progressive Disclosure — Wrap the detailed "Agent Task Texts" table and "Notable PRs" section in <details> tags:
<details>
<summary><b>Agent Task Texts</b></summary>
| PR # | Status | Task Text (first 100 chars) |
|------|--------|----------------------------|
| ... | ... | ... |
</details>
- Updated Template Sketch:
### 🤖 Copilot Agent PR Analysis - [DATE]
**Analysis Period**: Last 24 hours
**Total PRs**: [count] | **Merged**: [count] ([%]) | **Avg Duration**: [time]
#### Performance Metrics
| Date | PRs | Merged | Success Rate | Avg Duration |
|------|-----|--------|--------------|--------------|
| [today] | ... | ... | ... | ... |
<details>
<summary><b>Agent Task Texts</b></summary>
| PR # | Status | Task Text (first 100 chars) |
|------|--------|----------------------------|
| ... | ... | ... |
</details>
<details>
<summary><b>Notable PRs</b></summary>
[failures / closures / open >24h]
</details>
#### Key Insights
- [1–2 bullet points]
Design Principles (Airbnb-Inspired)
The updated workflow should create reports that:
- Build trust through clarity: Most important info immediately visible
- Exceed expectations: Add helpful context and trends
- Create delight: Use progressive disclosure to reduce overwhelm
- Maintain consistency: Follow patterns from
daily-repo-chronicle and audit-workflows
Reference
See audit-workflows.md for an example that already includes the guideline:
"Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy. Wrap long sections in <details><summary>Section Name</summary> tags to improve readability and reduce scrolling."
Agent Task
Update .github/workflows/copilot-agent-analysis.md — specifically the Concise Discussion Template in Phase 6 — to use h3+ headers and wrap verbose sections in <details> tags.
Generated by Workflow Normalizer · ● 1.4M · ◷
Workflows to Update
The following workflows generate reports but use incorrect header levels or lack progressive disclosure:
.github/workflows/copilot-agent-analysis.md#and##headers; no<details>progressive disclosureRequired Changes
.github/workflows/copilot-agent-analysis.mdThe Concise Discussion Template (Phase 6) uses
#and##headers and has no<details>sections. Update to:Header Levels — Replace
#and##with###and####throughout the template.Progressive Disclosure — Wrap the detailed "Agent Task Texts" table and "Notable PRs" section in
<details>tags:Design Principles (Airbnb-Inspired)
The updated workflow should create reports that:
daily-repo-chronicleandaudit-workflowsReference
See
audit-workflows.mdfor an example that already includes the guideline:Agent Task
Update
.github/workflows/copilot-agent-analysis.md— specifically the Concise Discussion Template in Phase 6 — to use h3+ headers and wrap verbose sections in<details>tags.