Skip to content

Normalize copilot-session-insights discussion output hierarchy and disclosure#34947

Merged
pelikhan merged 2 commits into
mainfrom
copilot/workflow-style-normalize-report-formatting
May 26, 2026
Merged

Normalize copilot-session-insights discussion output hierarchy and disclosure#34947
pelikhan merged 2 commits into
mainfrom
copilot/workflow-style-normalize-report-formatting

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 26, 2026

copilot-session-insights.md produced discussion bodies with #/## headings and lacked explicit structure guidance for collapsible detail sections. This update aligns the workflow with reporting conventions used by other workflows: enforce h3+ headings and apply progressive disclosure for verbose analysis blocks.

  • Formatting contract added near Phase 5

    • Introduced a new ### Report Formatting section that explicitly requires:
      • h3 (###) or lower headings in discussion bodies (no h1/h2)
      • <details><summary><b>…</b></summary> for long sections
      • always-visible Executive Summary, Key Metrics, and Recommendations
  • Discussion template heading hierarchy normalized

    • Demoted template headings from #/## (and downstream levels) to ###/####/##### to keep issue/discussion body hierarchy compliant.
  • Progressive disclosure added to verbose report sections

    • Wrapped high-volume sections in <details> blocks, including:
      • per-prompt quality breakdown
      • orphaned branch escalation candidate details
      • loop/tool/context diagnostic breakdown
      • historical trends + statistical summary

Example of the updated template pattern:

### 🤖 Copilot Agent Session Analysis — [DATE]

#### Executive Summary
...

<details>
<summary><b>Per-Prompt Breakdown</b></summary>

##### High-Quality Prompt Characteristics
...
##### Low-Quality Prompt Characteristics
...

</details>

Co-authored-by: gh-aw-bot <259018956+gh-aw-bot@users.noreply.github.com>
Copilot AI changed the title [WIP] Normalize report formatting for non-compliant workflows Normalize copilot-session-insights discussion output hierarchy and disclosure May 26, 2026
Copilot AI requested a review from gh-aw-bot May 26, 2026 14:41
@pelikhan pelikhan marked this pull request as ready for review May 26, 2026 14:49
Copilot AI review requested due to automatic review settings May 26, 2026 14:49
@pelikhan pelikhan merged commit a4fcf7c into main May 26, 2026
@pelikhan pelikhan deleted the copilot/workflow-style-normalize-report-formatting branch May 26, 2026 14:49
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the copilot-session-insights discussion template to enforce a consistent heading hierarchy (h3+) and introduce progressive disclosure for verbose report sections, matching formatting conventions used by other reporting workflows.

Changes:

  • Added an explicit “Report Formatting” contract requiring h3+ headings in discussion bodies and using <details> blocks for long sections.
  • Normalized the discussion template headings from #/## to ###/####/#####.
  • Wrapped high-volume template sections (per-prompt breakdown, escalation candidate details, diagnostics, trends/statistics) in collapsible <details> sections.
Show a summary per file
File Description
.github/workflows/copilot-session-insights.md Adds formatting requirements and restructures the discussion template to use h3+ headings plus <details>-based progressive disclosure.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 1/1 changed files
  • Comments generated: 0

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

4 participants