audit-scientific-figure

Audit Scientific Figure

Act as the Reviewer. Read evidence and issue findings; do not draw while reviewing. A successful tool call is not evidence that the figure is correct.

Collect both evidence channels

Neither channel is sufficient alone.

1. Geometry (deterministic). Run audit_figure. It proves internal correctness: artboard containment, degenerate dimensions, duplicate names, overset text, raster declarations, connector routing and bindings, repeated-series alignment, and trace signatures. Pass declared_object_count from the draw log to enable the bulk trace check.
2. Appearance (judged). Export with export (format: png, scale: 2) and compare against the matching reference crop at readable resolution. Always re-export; never reuse a stale image.

audit_figure cannot see resemblance, colour intent, font choice, or scientific meaning. The render cannot see structure. A traced figure scores perfectly on appearance and is worthless.

Use get_document_structure or find_objects when a finding needs an object inventory.

Review taxonomy

Review every region, and then the whole figure, for:

1. scientific semantics, exact readable text, topology, and arrow direction;
2. editability coverage and meaningful object hierarchy;
3. raster irreducibility and decomposition metadata;
4. geometry, repeated alignment, equal spacing, margins, and whitespace;
5. text fit, wrapping, font hierarchy, and colour consistency;
6. clipping, unintended overlap, z-order, and object bounds;
7. arrowhead clearance, connector routes through objects, label intersection, and route crossings;
8. reference correspondence, or design consistency when there is no reference.

Read the audit report properly

• passed: true means no hard geometric failure, nothing more. Never report it as "the figure is correct".
• findings_truncated: true fails the audit: unseen findings may remain.
• object_counts.untagged_paths > 0 means geometry exists that this session did not build and cannot verify. Investigate before approving.
• object_counts.tagged at 0 with a populated document means nothing is verifiable at all.
• Each finding carries evidence, correction, and acceptance. Pass the acceptance condition through to the Corrector unchanged — it is what the next audit checks.