blender-asset-qa

1# Asset QA (review gate)
2 
3Never assume a generated or edited mesh is correct. Check it with numbers, then look at it.
4 
5## Procedure
61. **Automated check**, passing one asset's objects together:
7   `scripts/qa_check.py -- --objects Body Head Hat --profile game`
8   Profiles: `game` (default), `render` (lenient), `print` (watertight required), `roblox` (20k tris/mesh, watertight, no n-gons, ≤4 influences).
92. **Fix every `errors` entry** (table below), then re-run until `"pass": true`. Each warning must be either fixed or explicitly accepted, with the reason reported to the user.
103. **Visual check, always**:
11   - Live: MCP `look` with `mode="angles"` on the targets, once in `material`/`solid` shading and once in `wireframe`. Use `xray` for internals.
12   - Headless: `scripts/review_shots.py -- --objects ... --mode random` (one color per object, which makes detached pieces obvious), then `--mode wire` for topology. Open the returned PNG.
134. Report: tris per object, issues fixed, and remaining accepted warnings.
14 
15## What each finding means → fix
16| Finding | Cause | Fix |
17|---|---|---|
18| `zfighting` A<->B | two surfaces facing the same way within `--eps` (1 mm) that overlap | delete the hidden duplicate, or offset ≥ 2–5 mm along the normal, or boolean/merge them |
19| `back_to_back` | faces touching with opposite normals (boxes glued face-to-face) | delete the hidden faces (wasted tris, bake artifacts) |
20…