Skip to content

[workflow-style] Normalize report formatting for non-compliant workflows #28823

@github-actions

Description

@github-actions

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:

  1. Header Levels — Replace # and ## with ### and #### throughout the template.

  2. 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>
  1. 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:

  1. Build trust through clarity: Most important info immediately visible
  2. Exceed expectations: Add helpful context and trends
  3. Create delight: Use progressive disclosure to reduce overwhelm
  4. 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 ·

  • expires on Apr 29, 2026, 12:04 AM UTC

Metadata

Metadata

Labels

cookieIssue Monster Loves Cookies!

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions