Summary
Five report-generating workflows use bare #/## headers and skip <details> progressive disclosure, breaking consistency with the project's reporting skill guidelines (headers start at ###, long content collapses behind <details><summary><b>...</b></summary>).
Non-compliant workflows
| Workflow |
Issue |
.github/workflows/daily-arxiv-researcher.md |
Uses # / ## headers; no <details> usage |
.github/workflows/daily-pr-review-cursor.md |
Uses # / ## headers; no <details> usage |
.github/workflows/daily-regression-audit-kiro.md |
Uses # / ## headers; no <details> usage |
.github/workflows/daily-schema-audit-cursor.md |
Uses # / ## headers; no <details> usage |
.github/workflows/daily-spec-coverage-kiro.md |
Uses # / ## headers; no <details> usage |
Required changes (per workflow)
- Header levels: rewrite report-generation instructions so the top-level report heading is
### and nested sections are #### or lower — never #/##.
- Progressive disclosure: add explicit guidance to wrap long/verbose sections (full findings lists, raw logs, per-item detail) in collapsible
<details> blocks with bold <summary> labels.
- Report structure: reference the shared
reporting skill (or equivalent structure notes) so the workflow states its report format explicitly instead of leaving it implicit.
Example: progressive disclosure pattern
### Daily Regression Audit — 2026-08-09
**Runs analyzed**: 42 | **Regressions found**: 3
<details>
<summary><b>View Full Findings</b></summary>
1. **workflow-a**: intermittent timeout in step 2
2. **workflow-b**: new lint failure
3. **workflow-c**: flaky network dependency
</details>
### Next Steps
- [ ] Triage regression-b
- [ ] File follow-up for workflow-c
Good references
.github/workflows/daily-repo-chronicle.md — compliant header levels + <details> usage
.github/workflows/audit-workflows.md — compliant header levels + <details> usage
Acceptance criteria
Generated by 🔧 Workflow Normalizer · auto · 31.9 AIC · ⌖ 2.45 AIC · ⊞ 10.4K · ◷
Summary
Five report-generating workflows use bare
#/##headers and skip<details>progressive disclosure, breaking consistency with the project's reporting skill guidelines (headers start at###, long content collapses behind<details><summary><b>...</b></summary>).Non-compliant workflows
.github/workflows/daily-arxiv-researcher.md#/##headers; no<details>usage.github/workflows/daily-pr-review-cursor.md#/##headers; no<details>usage.github/workflows/daily-regression-audit-kiro.md#/##headers; no<details>usage.github/workflows/daily-schema-audit-cursor.md#/##headers; no<details>usage.github/workflows/daily-spec-coverage-kiro.md#/##headers; no<details>usageRequired changes (per workflow)
###and nested sections are####or lower — never#/##.<details>blocks with bold<summary>labels.reportingskill (or equivalent structure notes) so the workflow states its report format explicitly instead of leaving it implicit.Example: progressive disclosure pattern
Good references
.github/workflows/daily-repo-chronicle.md— compliant header levels +<details>usage.github/workflows/audit-workflows.md— compliant header levels +<details>usageAcceptance criteria
###+ headers for its generated report<details>/<summary>for long contentmake recompilerun after edits and.lock.ymlfiles updated