Skip to content

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

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

cookieIssue Monster Loves Cookies!

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions