version: "1.0.0" name: xcodebuildmcp-structured-output-review description: Use when reviewing XcodeBuildMCP structured output schema changes, schema versioning, manifest outputSchema metadata, and JSON fixture compatibility.

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