[step-names] Align step names: "agent workflow" → "agentic workflow" and "Setup MCP Scripts" verb inconsistency

[github-actions]

Step Name Alignment Issues

Found in: .github/workflows/ai-moderator.lock.yml, .github/workflows/workflow-generator.lock.yml, and 17 MCP Scripts workflows.

Summary

Two categories of naming issues identified across compiled workflows:

1. Compiler-generated lock/unlock steps use "agent workflow" instead of the glossary-correct "agentic workflow"
2. Compiler-generated MCP Scripts setup steps use "Setup" as the verb for file-writing operations, inconsistent with the established "Write" pattern used elsewhere

---

Issues Identified

1. [High Priority] Terminology Mismatch: "agent workflow" → "agentic workflow"

Current step names (in ai-moderator.lock.yml and workflow-generator.lock.yml):

• Lock issue for agent workflow
• Unlock issue after agent workflow

Issue:
The project glossary defines the correct term as "Agentic Workflow" (under Core Concepts), not "Agent Workflow". These steps are compiler-generated from the lock-for-agent: true frontmatter option, so the fix requires updating the compiler's step name generation rather than the workflow source .md files.

Suggested improvements:

• Lock issue for agent workflow → Lock issue for agentic workflow
• Unlock issue after agent workflow → Unlock issue after agentic workflow

Glossary reference: See Agentic Workflow

---

2. [Medium Priority] Verb Inconsistency: "Setup" vs "Write" for file-writing steps

Affected workflows (17 files)

• copilot-pr-merged-report.lock.yml
• daily-cli-performance.lock.yml
• daily-doc-healer.lock.yml
• daily-doc-updater.lock.yml
• daily-performance-summary.lock.yml
• daily-regulatory.lock.yml
• developer-docs-consolidator.lock.yml
• dictation-prompt.lock.yml
• glossary-maintainer.lock.yml
• go-logger.lock.yml
• smoke-claude.lock.yml
• smoke-codex.lock.yml
• smoke-copilot.lock.yml
• smoke-copilot-arm.lock.yml
• smoke-gemini.lock.yml
• technical-doc-writer.lock.yml
• unbloat-docs.lock.yml

Current step names:

• Setup MCP Scripts Config
• Setup MCP Scripts Tool Files

Issue:
Both steps write files to disk using cat > file << EOF heredoc syntax — the same file-writing pattern used by Write Safe Outputs Config. Using "Setup" for these steps while using "Write" for the analogous safe-outputs config step creates a naming inconsistency that can mislead contributors about what these steps do.

Note: Generate MCP Scripts Server Config (which generates runtime values/API keys into step outputs) correctly uses "Generate" and is a distinct operation.

Suggested improvements:

• Setup MCP Scripts Config → Write MCP Scripts Config
• Setup MCP Scripts Tool Files → Write MCP Scripts Tool Files

These are also compiler-generated steps and require a fix in the gh-aw compiler.

---

3. [Low Priority] Unusual Format: "Notify - run sync actions and merge PR"

File: .github/workflows/release.lock.yml (source: release.md, line 197)

Issue:
This step name uses a dash separator with mixed casing (Notify - run sync actions...), inconsistent with all other imperative verb step names. The step actually writes instructions to GITHUB_STEP_SUMMARY — it doesn't send a notification.

Suggested improvement:

• "Notify - run sync actions and merge PR" → Display release sync instructions

This is in the source release.md file and can be fixed directly without a compiler change.

---

Agentic Task Description

To address these issues:

1. Issues 1 & 2 (compiler-generated steps): Update the gh-aw compiler to use correct step name strings:

   • In the lock-for-agent step generation code: change "agent workflow" → "agentic workflow"
   • In the MCP Scripts step generation code: change "Setup MCP Scripts Config" → "Write MCP Scripts Config" and "Setup MCP Scripts Tool Files" → "Write MCP Scripts Tool Files"
   • Recompile all affected workflows with gh aw compile

2. Issue 3 (source file): Edit .github/workflows/release.md line 197:

   • Change the step name from "Notify - run sync actions and merge PR" to Display release sync instructions
   • Recompile: gh aw compile release.md

Related Files

• Affected workflows: .github/workflows/ai-moderator.lock.yml, .github/workflows/workflow-generator.lock.yml, and 17 MCP Scripts workflows
• Source files: .github/workflows/ai-moderator.md, .github/workflows/workflow-generator.md, .github/workflows/release.md
• Project glossary: docs/src/content/docs/reference/glossary.md

Priority

This issue is Medium Priority overall. Issue 1 (terminology mismatch) is High Priority due to direct glossary conflict; Issues 2–3 are Medium/Low.

---

AI generated by Step Name Alignment for daily maintenance

Generated by Step Name Alignment · ◷

• expires on Mar 16, 2026, 12:27 PM UTC

[pelikhan]

/cloclo fix this issue