Skip to content

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

Description

@github-actions

Overview

A daily audit identified 75 of 87 reporting workflows that use #/## headers in their output instructions, violating the project style guideline requiring ### (h3) or lower. Several also lack <details> progressive disclosure patterns.

Why This Matters

Consistent formatting ensures:

  • Proper document hierarchy when reports appear in issues/discussions
  • Readable, scannable output with collapsible detail sections
  • A predictable user experience across all workflow-generated reports

Style Guidelines to Apply

  1. Headers: Use ### or lower — never # or ## in generated reports
  2. Progressive Disclosure: Wrap long lists in <details><summary><b>Title</b></summary>...</details>
  3. Report Structure: overview → key metrics → collapsible detail → next actions

Quick Fix Example

Before:

## Summary
Total: 42

## Details
- item1
- item2
- ...(long list)

After:

### Summary
Total: 42

<details>
<summary><b>View Details</b></summary>

- item1
- item2

</details>

Non-Compliant Workflows (75)

View Full List
Workflow File Issues
agentic-token-audit.md uses h1/h2 headers
agentic-token-trend-audit.md uses h1/h2 headers
api-consumption-report.md uses h1/h2 headers
artifacts-summary.md uses h1/h2 headers
audit-workflows.md uses h1/h2 headers
blog-auditor.md uses h1/h2 headers
copilot-pr-merged-report.md uses h1/h2 headers
daily-agentrx-trace-optimizer.md uses h1/h2 headers
daily-ambient-context-optimizer.md uses h1/h2 headers
daily-architecture-diagram.md uses h1/h2 headers
daily-astrostylelite-markdown-spellcheck.md uses h1/h2 headers
daily-aw-cross-repo-compile-check.md uses h1/h2 headers
daily-awf-spec-compiler-surfacing.md uses h1/h2 headers
daily-cache-strategy-analyzer.md uses h1/h2 headers
daily-caveman-optimizer.md uses h1/h2 headers
daily-choice-test.md uses h1/h2 headers; no <details> tags
daily-cli-performance.md uses h1/h2 headers
daily-cli-tools-tester.md uses h1/h2 headers
daily-code-metrics.md uses h1/h2 headers
daily-community-attribution.md uses h1/h2 headers
daily-compiler-quality.md uses h1/h2 headers
daily-compiler-threat-spec-optimizer.md uses h1/h2 headers
daily-doc-healer.md uses h1/h2 headers
daily-doc-updater.md uses h1/h2 headers
daily-elixir-credo-snippet-audit.md uses h1/h2 headers
daily-evals-report.md uses h1/h2 headers
daily-experiment-report.md uses h1/h2 headers
daily-file-diet.md uses h1/h2 headers
daily-firewall-report.md uses h1/h2 headers
daily-formal-spec-verifier.md uses h1/h2 headers
daily-function-namer.md uses h1/h2 headers
daily-geo-optimizer.md uses h1/h2 headers
daily-hippo-learn.md uses h1/h2 headers
daily-issues-report.md uses h1/h2 headers
daily-malicious-code-scan.md uses h1/h2 headers
daily-mcp-concurrency-analysis.md uses h1/h2 headers
daily-model-inventory.md uses h1/h2 headers
daily-model-resolution.md uses h1/h2 headers
daily-multi-device-docs-tester.md uses h1/h2 headers
daily-news.md uses h1/h2 headers
daily-observability-report.md uses h1/h2 headers
daily-performance-summary.md uses h1/h2 headers
daily-regulatory.md uses h1/h2 headers
daily-reliability-review.md uses h1/h2 headers
daily-rendering-scripts-verifier.md uses h1/h2 headers
daily-repo-chronicle.md uses h1/h2 headers
daily-safe-output-integrator.md uses h1/h2 headers
daily-safe-output-optimizer.md uses h1/h2 headers
daily-safe-outputs-conformance.md uses h1/h2 headers
daily-safeoutputs-git-simulator.md uses h1/h2 headers
daily-secrets-analysis.md uses h1/h2 headers
daily-security-observability.md uses h1/h2 headers
daily-security-red-team.md uses h1/h2 headers
daily-sentrux-report.md uses h1/h2 headers
daily-skill-optimizer.md uses h1/h2 headers
daily-spdd-spec-planner.md uses h1/h2 headers
daily-syntax-error-quality.md uses h1/h2 headers
daily-team-evolution-insights.md uses h1/h2 headers
daily-team-status.md uses h1/h2 headers
daily-testify-uber-super-expert.md uses h1/h2 headers
daily-token-consumption-report.md uses h1/h2 headers
daily-vulnhunter-scan.md uses h1/h2 headers; no <details> tags
daily-workflow-updater.md uses h1/h2 headers
daily-yamllint-fixer.md uses h1/h2 headers
designer-drift-audit.md uses h1/h2 headers
detection-analysis-report.md uses h1/h2 headers
github-mcp-tools-report.md uses h1/h2 headers
org-health-report.md uses h1/h2 headers
pdf-summary.md uses h1/h2 headers
repo-audit-analyzer.md uses h1/h2 headers
static-analysis-report.md uses h1/h2 headers
weekly-blog-post-writer.md uses h1/h2 headers
weekly-editors-health-check.md uses h1/h2 headers
weekly-issue-summary.md uses h1/h2 headers
weekly-safe-outputs-spec-review.md uses h1/h2 headers

Required Changes per Workflow

For each file above:

  1. Replace # Heading### Heading and ## Heading### Heading in report output instructions
  2. Wrap lists/tables with >5 items in <details><summary><b>Title</b></summary>...</details>
  3. Ensure structure follows: overview → key metrics → collapsible detail → next actions

Next Steps

  • Prioritize high-frequency daily-* workflows
  • Update header levels in output instructions
  • Add <details> blocks for long content
  • Re-run audit after updates to verify compliance

References: §29832904405

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🔧 Workflow Normalizer · sonnet46 28.8 AIC · ⌖ 6.14 AIC · ⊞ 5.7K ·

  • expires on Jul 22, 2026, 5:12 AM UTC-08:00

Metadata

Metadata

Labels

Type

No type

Fields

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