roof-measurement-vision-qa

Validates roof measurement geometry, perimeter refinement, and topology outputs against QA gates.

Updated Sep 24, 2025
One-click install
npx skills add https://github.com/chriso789/pitch-1 --skill roof-measurement-vision-qa-chriso789
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: roof-measurement-vision-qa
Source: https://github.com/chriso789/pitch-1/tree/main/.agents/skills/roof-measurement-vision-qa
Command: npx skills add https://github.com/chriso789/pitch-1 --skill roof-measurement-vision-qa-chriso789

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI-generated roof measurements can silently produce collapsed perimeters, missing ridge/valley topology, invalid pitch values, or customer reports that do not match the aerial imagery. This Skill enforces a QA contract that catches destructive perimeter edits, topology failures, and unsafe report gating before bad geometry reaches customers. ## Core Features & Use Cases - Perimeter Do-No-Harm Gates: Detects destructive refinement collapse (area ratio below 0.85), enforces region-based tree/patio/shadow exclusion, and bounds vertex snap distance with IoU regression reverts. - Topology & Structural Evidence Rules: Preserves deferred DSM ridge/valley/hip candidates, locks backbone seeds before face extraction, and requires a repair pass before rejecting undersegmented topology. - Customer Report Gating: Blocks customer-facing reports unless canonical route provenance, typed roof_lines, valid pitch (with Solar fallback), and all phase diagnostics pass. - Use Case: Before modifying perimeter-refinement.ts or the autonomous graph solver, run the Fonsica regression checklist to verify the eight hard-fail conditions and confirm safe fallback behavior on the canonical 4063 Fonsica Ave test case. ## Quick Start Review my changes to the perimeter refinement phase and verify they pass the Fonsica regression checklist and all geometry QA gates.

Frequently Asked Questions about roof-measurement-vision-qa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent AI roof measurement from producing collapsed perimeters?▼

Apply the destructive refinement gate: if the raw perimeter is within 15% of benchmark or target mask area and the refined-to-raw area ratio drops below 0.85, reject the refinement and fall back to the raw perimeter when the conservative gate passes. Never promote a collapsed polygon to the selected perimeter.

What is the Fonsica regression checklist for roof measurement QA?▼

It is a canonical regression test using 4063 Fonsica Ave with eight hard-fail conditions covering destructive refinement, silent perimeter replacement, missing phase blocks, and backbone loss. Any change to Phase 3A.5/3C/3D/3E must pass this checklist before being considered done.

When should pitch come from Solar roofSegmentStats instead of topology?▼

Use the Solar fallback whenever topology is invalid, topology fidelity is low or medium, or computed pitch is below 2/12. If Solar data is unavailable, mark pitch as unavailable rather than emitting collapsed-plane values like 0.11/12 or 1.67/12.

Why does the measurement run fail with backbone_not_applied?▼

This hard failure occurs when seed ridge or valley chains existed before solving but the final graph has zero ridge and valley linear feet. It means locked backbone edges were removed during pruning, so the run is marked ai_failed_topology and the customer report is blocked.

What conditions must pass before a customer roof report is generated?▼

The report gate requires a confirmed roof target, canonical measurement route, validated perimeter or safe raw fallback, typed roof_lines, valid pitch, non-undersegmented topology, structurally valid ridge/valley evidence, and no developer bugs or runtime failures. Any failure sets customer_report_ready to false and renders a diagnostic overlay instead.

What perimeter sources are forbidden in roof topology extraction?▼

Forbidden final perimeter sources include solar segment unions or hulls, solar bounding boxes, parcel boundaries, global mask bounding boxes, interior solar plane contours, and unmatched OSM footprints. Only validated target mask contours, refined aerial boundaries, DSM boundaries, or high-IoU footprints are allowed.