Labsco
getsentry logo

xcodebuildmcp-structured-output-review

✓ Official★ 6,033

by getsentry · part of getsentry/xcodebuildmcp

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

🧰 Not standalone. This skill ships with getsentry/xcodebuildmcp and only works together with that tool — install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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