Skip to content

[step-names] Fix step naming inconsistencies: lowercase "load-metrics" and asymmetric DIFC Proxy names #29175

@github-actions

Description

@github-actions

Step Name Alignment Issues

Found across multiple .github/workflows/*.lock.yml files.

Summary

Two distinct naming problems were identified across 6 workflow lock files. Both break the established project convention of Title Case imperative-mood step names and symmetric Start/Stop pairs.

Issues Identified

1. [High Priority] Non-standard casing: load-metrics should be Load Metrics

Affected file:

  • .github/workflows/workflow-health-manager.lock.yml — line 450

Current step name:

- name: load-metrics

Issue:
Every other step name in the codebase uses Title Case with imperative-mood verbs (e.g., "Download Metrics", "Parse MCP Gateway logs for step summary", "Generate agentic run info"). The load-metrics step uses a lowercase, hyphenated slug that looks like a step ID rather than a display name. It breaks visual consistency in the GitHub Actions log.

What the step does: Reads metrics/latest.json from repo-memory and filters failing workflows into /tmp/gh-aw/agent/failing-workflows.json.

Suggested name:

- name: Load Metrics

Source file to update: .github/workflows/workflow-health-manager.md


2. [Medium Priority] Asymmetric Start/Stop pair: Start DIFC Proxy for pre-agent gh calls vs Stop DIFC Proxy

Affected files (5 workflows):

  • .github/workflows/auto-triage-issues.lock.yml
  • .github/workflows/contribution-check.lock.yml
  • .github/workflows/issue-arborist.lock.yml
  • .github/workflows/stale-repo-identifier.lock.yml
  • .github/workflows/daily-issues-report.lock.yml

Current step names:

- name: Start DIFC Proxy for pre-agent gh calls   # has context clause
...
- name: Stop DIFC Proxy                           # no context clause

Issue:
The Start step carries an extra purpose clause (for pre-agent gh calls) that its paired Stop step lacks. This is inconsistent with every other Start/Stop pair in the codebase which uses symmetric names:

  • "Start MCP Gateway" / "Stop MCP Gateway" ✓
  • "Start CLI Proxy" / "Stop CLI Proxy" ✓

The extra clause also leaks internal implementation detail into the display name unnecessarily.

Suggested names (drop the context clause from Start):

- name: Start DIFC Proxy
...
- name: Stop DIFC Proxy

Glossary reference: The DIFC Proxy is defined as tools.github.integrity-proxy.

Source files to update:

  • .github/workflows/auto-triage-issues.md
  • .github/workflows/contribution-check.md
  • .github/workflows/issue-arborist.md
  • .github/workflows/stale-repo-identifier.md
  • .github/workflows/daily-issues-report.md

Agentic Task Description

To fix these step names:

  1. Update source .md files — edit the step name: in each source file listed above (not the .lock.yml)
  2. Recompile — run gh aw compile <workflow-name>.md for each changed file to regenerate the .lock.yml
  3. Verify — confirm the compiled .lock.yml contains the corrected step names

Naming Patterns Reference

Pattern Example
Checkout <target> "Checkout actions folder"
Setup <component> "Setup Scripts"
Install <tool> "Install GitHub Copilot CLI"
Start <service> "Start MCP Gateway"
Stop <service> "Stop MCP Gateway"
Load <data> "Load Metrics" ← suggested

AI generated by Step Name Alignment for daily maintenance

Generated by Step Name Alignment · ● 233.1K ·

  • expires on May 1, 2026, 7:58 PM UTC

Metadata

Metadata

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