Step Name Alignment Issues
Found in: compiler-generated steps and .github/workflows/contribution-check.md.
Summary
Scanning 212 .lock.yml files across 222 unique step names surfaced two steps using informal abbreviations inconsistent with the project's naming conventions. All other step names use complete English words; these two are outliers.
Issues Identified
1. [Medium Priority] Informal abbreviation: "Generate agentic run info" → "Generate agentic run information"
Current step name:
- Appears in 204+ compiled
.lock.yml workflows
Source location:
pkg/workflow/compiler_yaml.go:764 (compiler-generated)
Issue:
The word info is an informal abbreviation for information. Every other step name in the project uses complete English words (e.g., "Generate observability summary", "Generate agentic workflow overview"). This step name stands out as the only one using a shortened form.
Suggested improvement:
Generate agentic run information
or, if "metadata" better describes what is produced:
Generate agentic run metadata
What the step does: Sets GH_AW_INFO_* environment variables (engine ID, name, model, version, staged mode, allowed domains, firewall state, etc.) consumed by the agent job at runtime.
2. [Low Priority] Informal abbreviation: "Fetch and filter PRs" → "Fetch and filter pull requests"
Current step name:
- Line 44 in
.github/workflows/contribution-check.md
Issue:
PRs is the only acronym for "pull requests" in any step name across the entire workflow set. Every other step that references pull requests spells it out fully (e.g., "Checkout PR branch" uses "PR" but that is an industry-standard two-letter token; "PRs" as a plural is more informal).
Suggested improvement:
Fetch and filter pull requests
Agentic Task Description
To fix these step names:
-
Issue 1 — compiler fix: Update the string literal at pkg/workflow/compiler_yaml.go:764:
// before
yaml.WriteString(" - name: Generate agentic run info\n")
// after
yaml.WriteString(" - name: Generate agentic run information\n")
Then recompile all workflows with gh aw compile and update golden test files in pkg/workflow/testdata/.
-
Issue 2 — source fix: Update .github/workflows/contribution-check.md:44:
# before
- name: Fetch and filter PRs
# after
- name: Fetch and filter pull requests
Then recompile with gh aw compile .github/workflows/contribution-check.md.
Related Files
- Compiler source:
pkg/workflow/compiler_yaml.go:764
- Source workflow:
.github/workflows/contribution-check.md
- Golden test files:
pkg/workflow/testdata/ (must be updated after compiler change)
Priority
Medium Priority — naming inconsistency only; no functional impact.
AI generated by Step Name Alignment for daily maintenance
Generated by Step Name Alignment · ● 458.6K · ◷
Step Name Alignment Issues
Found in: compiler-generated steps and
.github/workflows/contribution-check.md.Summary
Scanning 212
.lock.ymlfiles across 222 unique step names surfaced two steps using informal abbreviations inconsistent with the project's naming conventions. All other step names use complete English words; these two are outliers.Issues Identified
1. [Medium Priority] Informal abbreviation: "Generate agentic run info" → "Generate agentic run information"
Current step name:
.lock.ymlworkflowsSource location:
pkg/workflow/compiler_yaml.go:764(compiler-generated)Issue:
The word
infois an informal abbreviation forinformation. Every other step name in the project uses complete English words (e.g., "Generate observability summary", "Generate agentic workflow overview"). This step name stands out as the only one using a shortened form.Suggested improvement:
or, if "metadata" better describes what is produced:
What the step does: Sets
GH_AW_INFO_*environment variables (engine ID, name, model, version, staged mode, allowed domains, firewall state, etc.) consumed by the agent job at runtime.2. [Low Priority] Informal abbreviation: "Fetch and filter PRs" → "Fetch and filter pull requests"
Current step name:
.github/workflows/contribution-check.mdIssue:
PRsis the only acronym for "pull requests" in any step name across the entire workflow set. Every other step that references pull requests spells it out fully (e.g., "Checkout PR branch" uses "PR" but that is an industry-standard two-letter token; "PRs" as a plural is more informal).Suggested improvement:
Agentic Task Description
To fix these step names:
Issue 1 — compiler fix: Update the string literal at
pkg/workflow/compiler_yaml.go:764:Then recompile all workflows with
gh aw compileand update golden test files inpkg/workflow/testdata/.Issue 2 — source fix: Update
.github/workflows/contribution-check.md:44:Then recompile with
gh aw compile .github/workflows/contribution-check.md.Related Files
pkg/workflow/compiler_yaml.go:764.github/workflows/contribution-check.mdpkg/workflow/testdata/(must be updated after compiler change)Priority
Medium Priority — naming inconsistency only; no functional impact.