Step Name Alignment Issues
Found in: .github/workflows/smoke-crush.lock.yml, .github/workflows/smoke-gemini.lock.yml, .github/workflows/ai-moderator.lock.yml
Summary
Two naming inconsistencies were found across 3 workflow lock files. Both deviate from the established patterns used in the 180+ other workflows in this repository.
Issues Identified
1. [Medium Priority] Inconsistent suffix in engine config write steps
Current step names:
smoke-crush.lock.yml lines 869, 1309: Write Crush configuration
smoke-gemini.lock.yml lines 918, 1405: Write Gemini Settings
Established pattern (same files, same jobs):
Write Safe Outputs Config
Write MCP Scripts Config
Issue:
The "Write" steps for engine-specific config use different suffixes: lowercase configuration (Crush) and Settings (Gemini), while every other "Write" config step in the codebase uses the uppercase suffix Config.
Suggested improvements:
Write Crush configuration → Write Crush Config
Write Gemini Settings → Write Gemini Config
2. [Low Priority] Inconsistent verb for cache-memory restore step
Current step name:
ai-moderator.lock.yml line 404: Cache cache-memory file share data
Established pattern (82 other workflows):
Restore cache-memory file share data
Issue:
ai-moderator.lock.yml uses Cache as the verb for the actions/cache step, causing the word "cache" to appear twice (verb + noun) and deviating from the Restore... pattern used everywhere else for the same step type.
Suggested improvement:
Cache cache-memory file share data → Restore cache-memory file share data
Agentic Task Description
To fix these step names:
- Review the context — confirm the suggested names are accurate by checking the step implementations
- Apply changes — update step names in the source workflow
.md files (not the .lock.yml directly)
.github/workflows/smoke-crush.md — for issue 1
.github/workflows/smoke-gemini.md — for issue 2
.github/workflows/ai-moderator.md — for issue 3 (may require compiler-level fix since step is compiler-generated)
- Recompile — run
gh aw compile on each changed source file to regenerate the .lock.yml
- Verify — confirm the compiled output uses the corrected step names
Related Files
- Source workflow:
.github/workflows/smoke-crush.md, .github/workflows/smoke-gemini.md, .github/workflows/ai-moderator.md
- Compiled workflow:
.github/workflows/smoke-crush.lock.yml, .github/workflows/smoke-gemini.lock.yml, .github/workflows/ai-moderator.lock.yml
- Project glossary:
docs/src/content/docs/reference/glossary.md
Priority
This issue is Medium Priority based on cross-workflow consistency impact.
AI generated by Step Name Alignment for daily maintenance
Generated by Step Name Alignment · ● 221.4K · ◷
Step Name Alignment Issues
Found in:
.github/workflows/smoke-crush.lock.yml,.github/workflows/smoke-gemini.lock.yml,.github/workflows/ai-moderator.lock.ymlSummary
Two naming inconsistencies were found across 3 workflow lock files. Both deviate from the established patterns used in the 180+ other workflows in this repository.
Issues Identified
1. [Medium Priority] Inconsistent suffix in engine config write steps
Current step names:
smoke-crush.lock.ymllines 869, 1309:Write Crush configurationsmoke-gemini.lock.ymllines 918, 1405:Write Gemini SettingsEstablished pattern (same files, same jobs):
Write Safe Outputs ConfigWrite MCP Scripts ConfigIssue:
The "Write" steps for engine-specific config use different suffixes: lowercase
configuration(Crush) andSettings(Gemini), while every other "Write" config step in the codebase uses the uppercase suffixConfig.Suggested improvements:
Write Crush configuration→Write Crush ConfigWrite Gemini Settings→Write Gemini Config2. [Low Priority] Inconsistent verb for cache-memory restore step
Current step name:
ai-moderator.lock.ymlline 404:Cache cache-memory file share dataEstablished pattern (82 other workflows):
Restore cache-memory file share dataIssue:
ai-moderator.lock.ymlusesCacheas the verb for theactions/cachestep, causing the word "cache" to appear twice (verb + noun) and deviating from theRestore...pattern used everywhere else for the same step type.Suggested improvement:
Cache cache-memory file share data→Restore cache-memory file share dataAgentic Task Description
To fix these step names:
.mdfiles (not the.lock.ymldirectly).github/workflows/smoke-crush.md— for issue 1.github/workflows/smoke-gemini.md— for issue 2.github/workflows/ai-moderator.md— for issue 3 (may require compiler-level fix since step is compiler-generated)gh aw compileon each changed source file to regenerate the.lock.ymlRelated Files
.github/workflows/smoke-crush.md,.github/workflows/smoke-gemini.md,.github/workflows/ai-moderator.md.github/workflows/smoke-crush.lock.yml,.github/workflows/smoke-gemini.lock.yml,.github/workflows/ai-moderator.lock.ymldocs/src/content/docs/reference/glossary.mdPriority
This issue is Medium Priority based on cross-workflow consistency impact.