Skip to content

[step-names] Align step names: "Install dev/development dependencies" and "Install/Setup uv" #20209

@github-actions

Description

@github-actions

Step Name Alignment Issues

Found in: Multiple .github/workflows/*.lock.yml files

Summary

Two naming inconsistencies were identified across workflows where the same action runs under different step names, making it harder to recognize equivalent setup steps at a glance.


Issues Identified

1. [Medium Priority] Inconsistent Abbreviation: "Install dev dependencies" → "Install development dependencies"

Current step names:

  • .github/workflows/ci-coach.lock.yml line 323: Install dev dependencies
  • .github/workflows/hourly-ci-cleaner.lock.yml line 336: Install dev dependencies
  • .github/workflows/tidy.lock.yml line 347: Install dev dependencies
  • .github/workflows/daily-copilot-token-report.lock.yml line 324: Install development dependencies

Issue:
All four steps run the same command (make deps-dev), but three use the abbreviated form dev while one uses the full word development. Consistent full-word names improve readability and searchability.

Suggested improvement:
Standardize to Install development dependencies across all four workflows.


2. [Medium Priority] Inconsistent Verb: "Install uv" vs "Setup uv"

Current step names:

  • .github/workflows/daily-copilot-token-report.lock.yml line 332: Install uv
  • .github/workflows/mcp-inspector.lock.yml line 390: Setup uv

Issue:
Both steps use the astral-sh/setup-uv GitHub Action to install the uv Python package manager, but use different verbs. The established pattern in this repo is:

  • Setup (runtime/environment) — for language runtimes and environment managers (Setup Go, Setup Node.js, Setup Python)
  • Install (tool/binary) — for standalone CLI tools (Install GitHub Copilot CLI, Install awf binary)

Since uv functions as a Python environment manager (similar to pyenv/poetry), Setup uv aligns better with the Setup (runtime) convention and matches the underlying action name.

Suggested improvement:
Standardize to Setup uv in daily-copilot-token-report.md (and its compiled daily-copilot-token-report.lock.yml).


Agentic Task Description

To fix these step names:

  1. Update source files — Change step names in the .md source files (not directly in .lock.yml):
    • In ci-coach.md, hourly-ci-cleaner.md, tidy.md: rename Install dev dependenciesInstall development dependencies
    • In daily-copilot-token-report.md: rename Install uvSetup uv
  2. Recompile — Run gh aw compile for each modified workflow to regenerate the .lock.yml
  3. Verify — Confirm the updated names appear correctly in the compiled files

Related Files

  • Source workflows: .github/workflows/ci-coach.md, hourly-ci-cleaner.md, tidy.md, daily-copilot-token-report.md, mcp-inspector.md
  • Compiled workflows: corresponding .lock.yml files
  • Naming patterns cache: /tmp/gh-aw/cache-memory/step-name-alignment/patterns.json

Priority

This issue is Medium Priority — no functional impact, but affects consistency and readability.


AI generated by Step Name Alignment for daily maintenance

Generated by Step Name Alignment ·

  • expires on Mar 11, 2026, 12:30 PM UTC

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions