# Xcodebuildmcp Structured Output Review

> Use when reviewing XcodeBuildMCP structured output schema changes, schema versioning, manifest outputSchema metadata, and JSON fixture compatibility.

- Skill: `gabrielmoreira/xcodebuildmcp-structured-output-review` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/xcodebuildmcp-structured-output-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/xcodebuildmcp-structured-output-review/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/xcodebuildmcp-structured-output-review

---


# XcodeBuildMCP Structured Output Review

Review guardrails for structured output schema correctness and compatibility.

## Review scope

- Review-only by default.
- Do not edit product code unless the user explicitly requests implementation changes.

## Files to inspect

- `schemas/structured-output/**`
- `src/core/structured-output-schema.ts`
- `src/core/__tests__/structured-output-schema.test.ts`
- `src/snapshot-tests/__fixtures__/json/**`
- `src/snapshot-tests/__tests__/json-fixture-schema.test.ts`
- `xcodebuildmcp.com/app/docs/_content/schema-versioning.mdx`
- `xcodebuildmcp.com/app/docs/_content/output-formats.mdx`

## Guardrails

- `schema` uses `xcodebuildmcp.output.<name>` format.
- `schemaVersion` uses integer strings only.
- Breaking schema changes create a new versioned schema file.
- Published schema versions are not removed or mutated incompatibly.
- Manifest `outputSchema` matches emitted `ctx.structuredOutput` payload.
- JSON fixtures validate against current schema contracts.
- `$ref` usage remains compatible with bundling in `structured-output-schema.ts`.

## Validation

- `npm run test:schema-fixtures`
- `npm test -- src/core/__tests__/structured-output-schema.test.ts`
- `npm run typecheck`
- `npx skill-check .agents/skills/xcodebuildmcp-structured-output-review`