[step-names] Align MCP terminology capitalization in step names with project glossary

[github-actions]

Step Name Alignment Issue

Found across 154+ workflow .lock.yml files

Summary

The project glossary defines "MCP Gateway" and "MCP Server" with capital G and S respectively, but step names across virtually all workflows use lowercase "gateway" and "server". This creates a terminology inconsistency that affects hundreds of step instances.

Issues Identified

[High Priority] Terminology Mismatch: "MCP gateway" → "MCP Gateway"

Affected workflows: 154 out of 156 workflows
Total instances: ~462 occurrences

Current step names:

• "Start MCP gateway"
• "Stop MCP gateway"
• "Parse MCP gateway logs for step summary"

Issue:
The project glossary at docs/src/content/docs/reference/glossary.md:58-61 defines this term as "MCP Gateway" (capitalized), but all step names use "MCP gateway" with a lowercase "g".

Glossary reference:

MCP Gateway

A transparent proxy service that enables unified HTTP access to multiple MCP servers using different transport mechanisms (stdio, HTTP).

Suggested improvements:

• "Start MCP gateway" → "Start MCP Gateway"
• "Stop MCP gateway" → "Stop MCP Gateway"
• "Parse MCP gateway logs for step summary" → "Parse MCP Gateway logs for step summary"

---

[High Priority] Terminology Mismatch: "GitHub MCP server" → "GitHub MCP Server"

Affected workflows: 137 workflows
Total instances: ~137 occurrences

Current step name:

• "Determine automatic lockdown mode for GitHub MCP server"

Issue:
The project glossary at docs/src/content/docs/reference/glossary.md:62-65 defines this term as "MCP Server" (capitalized), but step names use "MCP server" with a lowercase "s".

Glossary reference:

MCP Server

A service that implements the Model Context Protocol to provide specific capabilities to AI agents.

Suggested improvement:

• "Determine automatic lockdown mode for GitHub MCP server" → "Determine automatic lockdown mode for GitHub MCP Server"

---

[Medium Priority] Related: "OpenCode MCP servers" capitalization

Current step name:

• "Configure OpenCode MCP servers"

Issue:
Should likely be "Configure OpenCode MCP Servers" for consistency with glossary.

Suggested improvement:

• "Configure OpenCode MCP servers" → "Configure OpenCode MCP Servers"

---

Additional Context

Analysis Summary:

• ✅ Verb forms: 100% consistent (all imperative mood)
• ✅ Common patterns: Well-established and consistent
• ✅ Other glossary terms: "GitHub Copilot CLI", "Safe Outputs", "Safe Inputs" all correctly aligned
• ❌ MCP terminology: Significant capitalization mismatch

Why this matters:

1. Documentation consistency: Users reading the glossary will see "MCP Gateway" and "MCP Server", then see different capitalization in workflow logs
2. Professional appearance: Inconsistent terminology reduces trust in the platform
3. Search and reference: Developers searching for "MCP Gateway" may not find step logs using "MCP gateway"

Implementation Notes

Since this affects 154 workflows, the fix requires:

1. Update the source: These step names likely come from shared scripts or templates in .github/actions/ or similar

2. Common locations to check:

   • .github/actions/*/action.yml files
   • Shared workflow templates
   • Build/setup scripts that generate step names

3. After updating sources:

   • Recompile all affected .md workflow files
   • Verify consistent capitalization across all .lock.yml files

Verification Command

After fixes, verify with:

# Should return 0 results
grep -r "MCP gateway" .github/workflows/*.lock.yml
grep -r "GitHub MCP server" .github/workflows/*.lock.yml
grep -r "OpenCode MCP servers" .github/workflows/*.lock.yml

# Should return ~462 results
grep -r "MCP Gateway" .github/workflows/*.lock.yml

Related Files

• Project glossary: docs/src/content/docs/reference/glossary.md
• Shared actions: .github/actions/*/action.yml
• All workflow sources: .github/workflows/*.md
• All compiled workflows: .github/workflows/*.lock.yml

Priority

This issue is High Priority due to:

• Widespread impact (154 workflows)
• Clear glossary violation
• Simple to fix once the source template is identified

---

AI generated by Step Name Alignment workflow for daily maintenance

Generated by Step Name Alignment

• expires on Feb 17, 2026, 12:23 PM UTC