Skip to content

[step-names] Eliminate informal abbreviations in step names ("info", "PRs") #28790

@github-actions

Description

@github-actions

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:

  1. 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/.

  2. 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 ·

  • expires on Apr 29, 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