Agent Playbook

See also: MCP Reference

Core Execution Loop

1. preflight_session(action=load)
2. preflight_diagnose(action=validation)
3. If texture issues exist, run preflight_diagnose(action=texture)
4. Apply targeted fixes (preflight_fix(action=apply) or preflight_fix(action=texture_convert))
5. Re-validate
6. preflight_session(action=export)

Texture-First Playbook

Use when users ask, “Are my textures right?”

1. Choose workflow target:
   • openusd for core interoperability
   • visionos (RealityKit extension) for platform constraints
2. Run preflight_diagnose(action=texture, target_profile=openusd|visionos)
3. Group by severity:
   • errors first (missing_file, unreadable_or_corrupt)
   • warnings (unsupported_container, budget, colorspace)
   • advisories (mips, npot)
4. Select conversion backend:
   • openSource/automatic for general OpenUSD workflows
   • automatic (or optional appleTextureConverter) for RealityKit KTX2-centric flows
5. For conversion-capable cases, run preflight_fix(action=texture_convert, backend=..., ...)
6. Re-run texture diagnose and summarize deltas

Cross-Surface Consistency

• Same rule IDs across app, MCP/ACP, and CLI JSON
• Same health impact mapping in Materials category
• Same diagnosis-to-tool recommendations returned per issue