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

[github-actions]

Overview

A daily style normalization review identified 42 out of 51 reporting workflows that do not follow the project's markdown formatting guidelines.

Review Period: Last 24 hours of active workflows
Reviewed: 51 reporting workflows
Non-compliant: 42 (82%)
Compliant: 9 (18%)

---

Issues Found

Two categories of non-compliance were identified:

1. Prompt uses h1/h2 headers - Workflow prompts structure their own sections with # and ## headers. Per the Report Structure Guidelines, all report output headers should start at ### or lower.
2. No progressive disclosure guidance - Workflows generating reports do not instruct agents to wrap long lists/details in <details> blocks.

---

Non-Compliant Workflows

View all 42 non-compliant workflows

Workflow	h1 in prompt	h2 in prompt	Missing <details> guidance	Missing h3+ output guidance
audit-workflows.md	x	x	x	x
daily-agentrx-trace-optimizer.md	x	x	x	x
daily-ambient-context-optimizer.md	x	x	x	x
daily-aw-cross-repo-compile-check.md	x	x	x	x
daily-awf-spec-compiler-surfacing.md	x	x	x	x
daily-cache-strategy-analyzer.md	x	x	-	-
daily-cli-performance.md	x	x	x	x
daily-code-metrics.md	x	x	-	-
daily-community-attribution.md	x	x	x	x
daily-compiler-quality.md	x	x	x	x
daily-doc-healer.md	x	x	x	x
daily-experiment-report.md	x	x	x	x
daily-file-diet.md	x	x	x	x
daily-firewall-report.md	x	x	x	x
daily-formal-spec-verifier.md	x	x	x	x
daily-function-namer.md	x	x	x	x
daily-geo-optimizer.md	x	x	x	x
daily-hippo-learn.md	x	x	x	x
daily-issues-report.md	x	x	x	x
daily-mcp-concurrency-analysis.md	x	x	x	-
daily-model-inventory.md	x	x	x	x
daily-model-resolution.md	x	x	x	x
daily-multi-device-docs-tester.md	x	x	x	x
daily-news.md	x	x	x	x
daily-observability-report.md	x	x	x	x
daily-performance-summary.md	x	x	x	x
daily-regulatory.md	x	x	x	x
daily-reliability-review.md	x	x	x	x
daily-repo-chronicle.md	x	x	x	x
daily-safe-output-optimizer.md	x	x	x	x
daily-safe-outputs-conformance.md	x	x	x	x
daily-safeoutputs-git-simulator.md	x	x	x	x
daily-secrets-analysis.md	x	x	x	-
daily-sentrux-report.md	x	x	x	x
daily-skill-optimizer.md	x	x	x	x
daily-spdd-spec-planner.md	x	-	x	x
daily-syntax-error-quality.md	x	x	x	x
daily-team-evolution-insights.md	x	x	x	x
daily-team-status.md	x	x	-	-
daily-token-consumption-report.md	x	x	x	x
org-health-report.md	x	x	x	x
static-analysis-report.md	x	x	x	x

Legend: x = issue present, - = not applicable or partially addressed

---

Required Changes

For each non-compliant workflow, two types of changes are needed:

1. Replace h1/h2 prompt structure with h3+

Before:

# Daily Workflow Report

## Mission

Describe goal...

## Output Format

After:

### Daily Workflow Report

#### Mission

Describe goal...

#### Output Format

2. Add progressive disclosure guidance for report output

Add a ## Report Structure Guidelines section instructing the agent:

## Report Structure Guidelines

- Use `###` (or lower) headers only.
- Keep summary and critical actions visible; move long detail into `<details>` blocks.
- Structure reports as: overview to key metrics/issues to collapsible detail to next actions.

---

Good Examples to Reference

• daily-repo-chronicle.md - uses ### headers in output examples
• daily-cache-strategy-analyzer.md - includes <details> guidance
• daily-architecture-diagram.md - compliant prompt structure
• daily-security-red-team.md - compliant (uses h3+ headers)

---

Next Steps

• Update the 42 non-compliant workflow prompts to use ###/#### for section headers
• Add progressive disclosure (<details>) guidance to output format sections
• Prioritize high-frequency workflows: daily-repo-chronicle, daily-issues-report, daily-firewall-report, daily-observability-report
• Monitor next workflow runs for compliance improvement

Generated by workflow-normalizer

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 · 52 AIC · ⌖ 9.44 AIC · ⊞ 5.6K · ◷

• expires on Jul 4, 2026, 5:28 AM UTC-08:00

[github-actions]

🍪 Issue Monster selected this for Copilot

I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

Om nom nom! 🍪

🍪 Om nom nom by Issue Monster · 2.15 AIC · ⌖ 5.9 AIC · ⊞ 5.7K · ◷

[github-actions]

This issue was automatically closed because it expired on 2026-07-04T13:28:44.062Z.

Closed by Workflow