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:
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:
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:
- Update source
.md files — edit the step name: in each source file listed above (not the .lock.yml)
- Recompile — run
gh aw compile <workflow-name>.md for each changed file to regenerate the .lock.yml
- 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 · ◷
Step Name Alignment Issues
Found across multiple
.github/workflows/*.lock.ymlfiles.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-metricsshould beLoad MetricsAffected file:
.github/workflows/workflow-health-manager.lock.yml— line 450Current step name:
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-metricsstep 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.jsonfrom repo-memory and filters failing workflows into/tmp/gh-aw/agent/failing-workflows.json.Suggested name:
Source file to update:
.github/workflows/workflow-health-manager.md2. [Medium Priority] Asymmetric Start/Stop pair:
Start DIFC Proxy for pre-agent gh callsvsStop DIFC ProxyAffected 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.ymlCurrent step names:
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:The extra clause also leaks internal implementation detail into the display name unnecessarily.
Suggested names (drop the context clause from Start):
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.mdAgentic Task Description
To fix these step names:
.mdfiles — edit the stepname:in each source file listed above (not the.lock.yml)gh aw compile <workflow-name>.mdfor each changed file to regenerate the.lock.yml.lock.ymlcontains the corrected step namesNaming Patterns Reference
Checkout <target>Setup <component>Install <tool>Start <service>Stop <service>Load <data>