Files
cad-building-showcase/references/agent_review.md
zhengwr a6ac166049 Initial commit: cad-building-showcase skill
Agent-led CAD-drawing → 3D web showcase pipeline. Inspects CAD reports,
maps layers/floors, extracts a normalized building spec (with block-probed
glazing and audit gates), builds Blender/trimesh GLB variants, and assembles
a Three.js web viewer. Includes XREF-shell detection and a regression test.

Large inputs/outputs (work/, outputs/, source_cad/, renders) are gitignored.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-12 16:16:04 +08:00

3.1 KiB

Agent Review Checklist

Use this checklist after building_spec.json, extraction audit, and overlay SVGs exist.

Accept for Web Showcase

Accept when:

  • Main floor outlines, walls, columns, beams, floor detail, and grid are visible in overlays.
  • Unclassified geometry is mostly annotation, dimensions, text, furniture, landscaping, or detail symbols.
  • High-risk INSERT/HATCH entities are either irrelevant or visually accounted for by extracted linework.
  • Blender preview is nonblank, correctly framed, and visually matches the floor-plan intent.
  • Web viewer loads with clean console logs and controls work.
  • Presentation/digital-twin views show readable slab edges from side views; floor plates do not disappear behind glazing.
  • Generated roofs use roof-floor footprints unless CAD evidence supports a canopy/overhang.
  • Ground/podium columns that have no upper plate plus nearby upper structure are shortened or documented as intentional.
  • Web delivery exposes overview, standard, and detail GLB downloads when lightweight variants were requested.

State known gaps in the notes.

Iterate Extraction

Return to config or parser work when:

  • Red dashed overlay geometry forms obvious walls, columns, beams, grids, stairs, or slab outlines.
  • A large unclassified layer has high supported vector length and architectural names.
  • Frequent INSERT blocks likely contain architectural geometry.
  • HATCH or SOLID represents primary filled walls/columns and line extraction missed it.
  • Multiple floors are misaligned after overlay/Blender review.
  • Generated slabs are much larger/smaller than the true building footprint.
  • Slabs are technically present but visually unreadable from side views.
  • Generated roof caps extend across unrelated lower-floor footprints.
  • Many columns stand full-height with no upper floor/roof or nearby upper structural support.
  • Web/digital-twin output has only one heavy GLB when the user requested lightweight download tiers.

Escalate Beyond Line Extraction

Use additional strategies when needed:

  • Recursive block expansion for INSERT.
  • Hatch boundary extraction for filled wall/slab/column regions.
  • OCR/title-block reading for floor labels when filenames are ambiguous.
  • Manual floor split rectangles for complex sheet layouts.
  • Footprint tuning with wall/glazing/floor-line/railing/column source categories.
  • Variant generation with build_showcase_variants.py before writing the Web viewer.
  • IFC/BIM generation only after extracted geometry passes showcase-level review.

BIM Claim Rules

Never call the Web showcase a BIM replacement.

Call it an IFC/BIM proof only when:

  • IFC entities exist with storeys and spatial containment.
  • IfcWall, IfcColumn, IfcBeam, IfcSlab counts are reported.
  • IfcOpenShell geometry generation succeeds or failures are explained.
  • Remaining gaps are listed: openings, rooms/spaces, doors/windows, quantities, materials, classifications, georeferencing, and coordination.

Call it a BIM replacement candidate only after discipline-specific semantic validation, quantity validation, and human review.