-
Notifications
You must be signed in to change notification settings - Fork 295
Description
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.ymlline 323:Install dev dependencies.github/workflows/hourly-ci-cleaner.lock.ymlline 336:Install dev dependencies.github/workflows/tidy.lock.ymlline 347:Install dev dependencies.github/workflows/daily-copilot-token-report.lock.ymlline 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.ymlline 332:Install uv.github/workflows/mcp-inspector.lock.ymlline 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:
- Update source files — Change step names in the
.mdsource files (not directly in.lock.yml):- In
ci-coach.md,hourly-ci-cleaner.md,tidy.md: renameInstall dev dependencies→Install development dependencies - In
daily-copilot-token-report.md: renameInstall uv→Setup uv
- In
- Recompile — Run
gh aw compilefor each modified workflow to regenerate the.lock.yml - 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.ymlfiles - 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