reference-analysis-validatorlisted

# Reference Analysis Validator This skill converts “looks close” into measurable gates. For brand/logo/mascot work, **do not model or export until a source manifest and validation thresholds exist**. ## Required outputs Create these in the asset output folder: - `reference_manifest.json` — classified source files, expected parts, thresholds. - `source_analysis/*.json` — image metadata, masks/components/landmarks. - `validation/front_overlay_reference.png` — reference and render overlay. - `validation/front_mask_validation.json` — IoU/SSIM/bbox/centroid report. ## Workflow 1. Classify sources: front, side, back, top, texture atlas, decals, maps, lightmap, aura/context. 2. Build/refresh `reference_manifest.json` with hard expected counts and view roles. 3. Extract masks/components from each source using `scripts/reference_manifest_compiler.py` or existing analyzers. 4. Render model from matching orthographic camera with reference planes hidden. 5. Compare reference mask vs render mask using `scripts/render_overlay_validator.py`. 6. Refuse final export if hard gates fail. ## Modality rule Compare like with like. A wireframe edge mask compared against a shaded beauty render gives misleadingly low IoU. For hard gates, render a flat silhouette/matte pass from Blender or compare reference edges to render edges. Use `render_overlay_validator.py --reference-mode ... --render-mode ...` when the source and render need different mask extraction modes. ## Default validation gates