| name | xcodebuildmcp-docs-command-review |
| description | Use when reviewing XcodeBuildMCP changelog CLI command references for invalid current guidance while allowing historical migration examples. |
| allowed-tools | Read Grep Glob |
XcodeBuildMCP Docs Command Review
Review changed changelog entries for CLI command references that would mislead users or agents.
What to inspect
CHANGELOG.mdmanifests/tools/*.yaml and manifests/workflows/*.yaml when you need to verify current CLI workflow/tool namessrc/cli/** only when command wiring is unclear from manifests
Issue criteria
Report a finding only when a command reference is presented as current guidance and appears invalid for the current CLI surface.
High severity
- A changelog bullet, example, or migration instruction tells users to run a removed or invalid
xcodebuildmcp command as the current path.
- A Breaking change mentions a removed command but does not give a valid replacement.
- A command reference uses the wrong workflow/tool pairing in a way a user or agent would likely copy.
Medium severity
- A command reference is ambiguous enough that users may not know whether it is historical or current.
- A migration example gives the right replacement but does not clearly label the old command as "Before", "old", "removed", or equivalent.
Explicitly allowed
Do not report removed commands when they are clearly historical context, especially in:
- Breaking-change migration sections
