Skip to content

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

@github-actions

Description

@github-actions

Workflows to Update

The following workflows generate reports but don't comply with the project's markdown style guidelines:

Workflow File Issues Found
.github/workflows/daily-function-namer.md Uses h1 (# 🏷️ Go Function Rename Plan) in issue body instead of h3 or lower

Required Changes

.github/workflows/daily-function-namer.md

The issue body template starts with an h1 heading:

# 🏷️ Go Function Rename Plan

Change to h3 to comply with the style guidelines:

### 🏷️ Go Function Rename Plan

Also add explicit formatting instruction near the issue creation step:

Use h3 (###) or lower for all headers in the issue body. Never use h1 (#) or h2 (##) β€” these are reserved for the issue title.

Design Principles (Airbnb-Inspired)

The updated workflow should create reports that:

  1. Build trust through clarity: Most important info immediately visible
  2. Exceed expectations: Add helpful context and examples
  3. Maintain consistency: Follow the same patterns as other reporting workflows (e.g., daily-otel-instrumentation-advisor, agent-performance-analyzer)

Compliance Summary

Of the 17 active reporting workflows reviewed from the last 24 hours:

  • βœ… 16 workflows follow the h3+ header guidelines (explicitly or implicitly)
  • ❌ 1 workflow uses h1 in its issue body template
View Full Compliance Review
Workflow Status Notes
agent-performance-analyzer βœ… Compliant Explicit h3 guidelines
api-consumption-report βœ… Compliant Explicit h3 guidelines
prompt-clustering-analysis βœ… Compliant Uses ### in templates
daily-otel-instrumentation-advisor βœ… Compliant Explicit h3 guidelines
ab-testing-advisor βœ… Compliant Explicit h3 guidelines
test-quality-sentinel βœ… Compliant Explicit h3 guidelines
daily-function-namer ❌ Non-compliant h1 in issue body
daily-doc-updater βœ… Compliant Uses ### in templates
claude-code-user-docs-review βœ… Compliant Explicit h3 guidelines
auto-triage-issues βœ… Compliant Explicit h3 guidelines
design-decision-gate βœ… Compliant ADR file (h1 appropriate); comments use ###
mattpocock-skills-reviewer βœ… Compliant Uses ### in output template
pr-sous-chef βœ… Compliant Operational, no structured reports
stale-pr-cleanup βœ… Compliant Operational, no structured reports
draft-pr-cleanup βœ… Compliant Operational, no structured reports
instructions-janitor βœ… Compliant Creates PRs, not issue reports
terminal-stylist βœ… Compliant Uses shared audit base

Agent Task

Update .github/workflows/daily-function-namer.md to change the issue body template's h1 to h3, and add explicit formatting guidelines near the issue creation step.

Generated by πŸ”§ Workflow Normalizer Β· ● 10.1M Β· β—·

  • expires on May 17, 2026, 1:12 PM UTC

Metadata

Metadata

Labels

cookieIssue Monster Loves Cookies!

Type

No type
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