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

60 lines
3.1 KiB
Markdown

# 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.