[workflow-style] Normalize report formatting for daily-copilot-token-report

[github-actions]

Workflow to Update

Workflow File: .github/workflows/daily-copilot-token-report.md
Issue: This workflow generates daily token consumption reports but doesn't include markdown style guidelines for proper document hierarchy and progressive disclosure.

Required Changes

Update the workflow prompt to include these formatting guidelines:

1. Header Levels

Add instruction after line 62 (in the "Mission" section):

Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy.

The discussion title serves as h1, so all content headers should start at h3:

• Use ### for main sections (e.g., "### Token Consumption Overview", "### Per-Workflow Statistics")
• Use #### for subsections (e.g., "#### Top 10 Most Expensive Workflows", "#### Cost Trends")
• Never use ## (h2) or # (h1) in the report body

2. Progressive Disclosure

Add instruction for using collapsible sections:

Wrap detailed sections in <details><summary><b>Section Name</b></summary> tags to improve readability and reduce scrolling.

Use collapsible sections for:

• Per-workflow detailed statistics tables
• Full workflow run lists
• Historical comparison data
• Verbose metrics breakdowns

Example:

<details>
<summary><b>Per-Workflow Detailed Statistics</b></summary>

| Workflow | Runs | Total Tokens | Avg Tokens | Total Cost | Avg Cost |
|----------|------|--------------|------------|------------|----------|
| workflow-1 | 25 | 1,234,567 | 49,382 | $1.23 | $0.05 |
| ... | ... | ... | ... | ... | ... |

</details>

3. Report Structure

Suggest this structure for optimal readability:

1. Executive Summary (always visible): Brief overview of total token usage, costs, and key findings
2. Key Highlights (always visible): Top 5 most expensive workflows, notable cost increases/decreases
3. Visual Trends (always visible): Embedded charts showing token usage and cost trends
4. Detailed Per-Workflow Statistics (in <details> tags): Complete breakdown for all workflows
5. Recommendations (always visible): Actionable suggestions for optimization

Design Principles (Airbnb-Inspired)

The updated workflow should create reports that:

1. Build trust through clarity: Most important info (summary, top consumers, trends) immediately visible
2. Exceed expectations: Add helpful context like week-over-week comparisons, cost projections
3. Create delight: Use progressive disclosure to reduce overwhelm while keeping details accessible
4. Maintain consistency: Follow the same patterns as other reporting workflows like daily-issues-report and daily-team-status

Example Reference

See workflows like daily-team-status.md (lines 52-97) and weekly-issue-summary.md (lines 144-190) for good examples of structured reporting with header guidelines and progressive disclosure.

Agent Task

Update the workflow file .github/workflows/daily-copilot-token-report.md to include the formatting guidelines above. Add them after the "Mission" section and before "Phase 1: Data Collection". Test the updated workflow to ensure it produces well-formatted reports with proper header hierarchy and progressive disclosure.

AI generated by Workflow Normalizer

• expires on Feb 4, 2026, 12:26 PM UTC

[github-actions]

🍪 Issue Monster has assigned this to Copilot!

I've identified this issue as a good candidate for automated resolution and assigned it to the Copilot agent.

The Copilot agent will analyze the issue and create a pull request with the fix.

Om nom nom! 🍪

AI generated by Issue Monster