woogiandClaude Opus 4.8
1d248a8808
Cross-discipline design-contradiction checker for construction drawing sets. Standalone tool broken out from Iron_Bid; a pipeline stage may later fold back into Iron_Bid. Pipeline: PDF->images -> per-sheet assertion extraction -> deterministic clustering by location -> per-cluster reasoning -> report. Includes CLI (cli/run_check.py) and web UI (backend/main.py). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 line
15 KiB
JSON
1 line
15 KiB
JSON
{"issues": [{"issue_id": "CBI-001", "source_stage": "constructability", "category": "other", "severity": "critical", "confidence": "high", "location": "Electrical Panel 'L' and Water Heater EWH-1", "disciplines": ["Plumbing", "Electrical"], "sheets": ["P01.01", "E01.02"], "description": "The plumbing fixture schedule specifies a 480V, 3-phase electric water heater (EWH-1). The electrical one-line diagram and schedules show the 'WATER HEATING' load is served from Panel 'L', which is fed by Panel 'H', with a voltage of 208Y/120V. The specified equipment is incompatible with the provided power source. This will result in ordering the wrong equipment or requiring significant electrical redesign and rework.", "evidence": [{"discipline": "Plumbing", "sheet": "P01.01", "source_text": "EHW-1 ... VOLTS 480 PHASE 3", "asserted_value": "480V, 3-Phase"}, {"discipline": "Electrical", "sheet": "E01.02", "source_text": "PANEL SCHEDULE 'H', VOLTS: 208Y/120... CKT 1,2,3 DESCRIPTION: PNL 'L'", "asserted_value": "Panel L is 208Y/120V"}, {"discipline": "Electrical", "sheet": "E01.02", "source_text": "PANEL SCHEDULE 'L', VOLTS: 208Y/120... CKT 1,2,3 DESCRIPTION: WATER HEATING", "asserted_value": "Water Heater is on a 208Y/120V panel"}], "recommended_resolution": "Coordinate electrical and plumbing drawings to ensure the specified water heater voltage matches the provided power circuit voltage.", "code_reference": null}, {"issue_id": "CBI-002", "source_stage": "constructability", "category": "access_clearance", "severity": "critical", "confidence": "high", "location": "Above ceiling in Lounge and Corridor", "disciplines": ["Electrical", "Plumbing", "Architectural"], "sheets": ["E02.01", "P02.02", "A23.01"], "description": "Both the electrical Transformer (Keynote 7, E02.01) and the 30-gallon water heater (EWH-1, Keynote 1, P02.02) are specified to be suspended above the ceiling. The notes require access (e.g., 'ABOVE ACCESSIBLE CEILING' for the transformer). However, the architectural finish plan (A23.01) shows a hard-lid gypsum board ceiling (C1) in the Lounge area where these units may be located. Installing heavy equipment above a non-accessible hard-lid ceiling makes future service or replacement impossible without demolishing the ceiling.", "evidence": [{"discipline": "Electrical", "sheet": "E02.01", "source_text": "7 TRANSFORMER TO BE SUSPENDED FROM STRUCTURE AT HIGH LEVEL ABOVE ACCESSIBLE CEILING.", "asserted_value": "Transformer requires accessible ceiling"}, {"discipline": "Plumbing", "sheet": "P02.02", "source_text": "KEYED NOTE: 1 EWH-1 ABOVE CEILING SUSPENDED AS HIGH AS POSSIBLE IN CEILING PLENUM.", "asserted_value": "Water heater suspended above ceiling"}, {"discipline": "Architectural", "sheet": "A23.01", "source_text": "FINISH LEGEND: CEILING TYPES: C1, FINISH: GYPSUM BOARD CEILING... LOCATION: ...LOUNGE", "asserted_value": "Lounge has a GWB hard-lid ceiling"}], "recommended_resolution": "Relocate suspended equipment to be above an accessible ceiling (e.g., acoustic tile in corridor/restrooms) or specify access panels in the hard-lid ceiling of sufficient size for equipment replacement. Confirm locations on all disciplined drawings.", "code_reference": null}, {"issue_id": "CBI-003", "source_stage": "constructability", "category": "support_anchorage", "severity": "critical", "confidence": "high", "location": "Above ceiling in Lounge area", "disciplines": ["Electrical", "Plumbing"], "sheets": ["E05.02", "P03.01"], "description": "Details for suspending the electrical transformer and water heater delegate the structural design of the supports. The electrical detail (5/E05.02) states 'Verify support sizing and designed with project structural engineer prior to assembly.' The plumbing detail (4/P03.01) simply shows unistrut and threaded rods. The structural design for supporting heavy, suspended equipment cannot be delegated to the field. This poses a significant life-safety and buildability risk. The drawings must include a fully engineered support design, including member sizes, connections to the building structure, and load calculations, coordinated with the structural engineer of record.", "evidence": [{"discipline": "Electrical", "sheet": "E05.02", "source_text": "VERIFY SUPPORT SIZING AND DESIGNED WITH PROJECT STRUCTURAL ENGINEER PRIOR TO ASSEMBLY.", "asserted_value": "Delegation of structural support design for transformer"}, {"discipline": "Plumbing", "sheet": "P03.01", "source_text": "DETAIL 4 - EWH-1 ABOVE CEILING DETAIL: 2\" UNISTRUT SUPPORT. 1/2\" ALL THREADED RODS...", "asserted_value": "Generic, non-engineered support shown for water heater"}], "recommended_resolution": "Provide engineered structural details for the suspension of the transformer and water heater, signed and sealed by the structural engineer. Details must show connection to the building structure and specify all components.", "code_reference": null}, {"issue_id": "CBI-004", "source_stage": "constructability", "category": "detail_gap", "severity": "high", "confidence": "high", "location": "Restrooms", "disciplines": ["Architectural"], "sheets": ["A23.01", "A51.01"], "description": "The finish plan (A23.01) specifies Polished Concrete (PC-1) for the restroom floors. The typical restroom elevation detail (3/A51.01) explicitly calls out for 'TILE FLOOR'. These are mutually exclusive finishes requiring different slab preparation, sequencing, and installation methods. This conflicting information makes it impossible to bid or build as drawn.", "evidence": [{"discipline": "Architectural", "sheet": "A23.01", "source_text": "FINISH LEGEND PC1 ... LOCATION: CORRIDOR, RESTROOMS, LOUNGE...", "asserted_value": "Restroom floor is Polished Concrete"}, {"discipline": "Architectural", "sheet": "A51.01", "source_text": "TYPICAL RESTROOM FLOOR PLAN - DETAIL 3 - TILE FLOOR (SEE A-101)", "asserted_value": "Restroom floor is Tile"}], "recommended_resolution": "Clarify the intended floor finish for the restrooms and ensure all plans, elevations, and details are consistent.", "code_reference": null}, {"issue_id": "CBI-005", "source_stage": "constructability", "category": "routing", "severity": "high", "confidence": "high", "location": "Sales Area Ceiling", "disciplines": ["Architectural", "Electrical"], "sheets": ["E03.01", "A23.01"], "description": "The electrical lighting plan (E03.01) shows a simple grid of fixtures for the sales area, but a handwritten note on the plan states 'fixture locations not matching arch'. The architectural reflected ceiling plan, based on the ceiling grid spec C4-A from A23.01, would typically define the final layout. This conflict will cause confusion during layout and installation, potentially leading to installing fixtures in the wrong locations and requiring rework.", "evidence": [{"discipline": "Electrical", "sheet": "E03.01", "source_text": "fixture locations not matching arch", "asserted_value": "Explicit note indicates a conflict between electrical and architectural layouts."}, {"discipline": "Electrical", "sheet": "E03.01", "source_text": "FLOOR PLAN - LIGHTING (layout in Sales Area)", "asserted_value": "Shows a simple rectangular grid of fixtures."}], "recommended_resolution": "Reconcile the electrical lighting plan with the architectural reflected ceiling plan. The electrical drawing should be updated to reflect the final, coordinated lighting layout.", "code_reference": null}, {"issue_id": "CBI-006", "source_stage": "constructability", "category": "sequencing", "severity": "high", "confidence": "high", "location": "Roof", "disciplines": ["General", "Architectural"], "sheets": ["G11.03", "A25.01"], "description": "There is a contractual and sequencing conflict regarding roofing work. The Landlord Work Letter (G11.03) mandates that ALL roof penetrations be performed by the Landlord's designated roofing contractor. However, the architectural roof plan (A25.01) directs the General Contractor (GC) to install flashing for the new RTUs. This ambiguity over responsibility for roof work will cause bidding confusion, delays, and potential warranty voidance for the existing roof.", "evidence": [{"discipline": "General", "sheet": "G11.03", "source_text": "ALL ROOF PENETRATIONS MUST BE MADE BY LANDLORD'S ROOFING CONTRACTOR, AT TENANTS COST.", "asserted_value": "Landlord's roofer performs work."}, {"discipline": "Architectural", "sheet": "A25.01", "source_text": "2 NEW RTU... GC TO INSTALL FLASHING PER PER ROOFING MANUFACTURING STANDARDS...", "asserted_value": "GC performs work."}], "recommended_resolution": "Clarify which entity is responsible for making and flashing roof penetrations and update the drawings consistently. If the Landlord's roofer must be used, provide their contact info and coordination requirements.", "code_reference": null}, {"issue_id": "CBI-007", "source_stage": "constructability", "category": "support_anchorage", "severity": "high", "confidence": "high", "location": "Inventory Room", "disciplines": ["Architectural"], "sheets": ["A24.01"], "description": "A wall-mounted network 'RACK SYSTEM' is shown in the Inventory room. A note instructs to 'COORDINATE WITH TENANT FOR PLYWOOD BACKING FOR MOUNTING NETWORK RACK.' This is insufficient for construction. The drawings must specify the size, thickness, and fire-rating of the plywood backing, and more importantly, the method of attachment to the wall structure (e.g., fasteners, gauge of metal studs, additional blocking) to safely support the full weight of the rack and its equipment.", "evidence": [{"discipline": "Architectural", "sheet": "A24.01", "source_text": "RACK SYSTEM ABOVE SAFE @ ~74\" TO BOTTOM", "asserted_value": "Heavy equipment is wall mounted."}, {"discipline": "Architectural", "sheet": "A24.01", "source_text": "COORDINATE WITH TENANT FOR PLYWOOD BACKING FOR MOUNTING NETWORK RACK", "asserted_value": "Support design is undefined and delegated."}], "recommended_resolution": "Provide a detail specifying the plywood backing dimensions, fire-treatment requirements, and engineered fastening to the wall structure adequate for the anticipated load of the fully-populated network rack.", "code_reference": null}, {"issue_id": "CBI-008", "source_stage": "constructability", "category": "detail_gap", "severity": "medium", "confidence": "high", "location": "Project Wide", "disciplines": ["General", "Electrical"], "sheets": ["G21.01", "E01.01"], "description": "The drawing set specifies conflicting versions of the governing codes, creating ambiguity for bidding and construction. Sheet G21.01 lists the 2018 IBC and 2014 NEC. Sheet E01.01 lists the 2021 IBC and 2023 NEC. The contractor cannot determine which set of rules to follow without clarification, which poses a significant risk for inspection failures and rework.", "evidence": [{"discipline": "General", "sheet": "G21.01", "source_text": "2018 INTERNATIONAL BUILDING CODE (IBC)", "asserted_value": "2018 IBC"}, {"discipline": "General", "sheet": "G21.01", "source_text": "2023 STATE OF TEXAS ADOPTED 2014 NFPA 70 NATIONAL ELECTRICAL CODE (NEC)", "asserted_value": "2014 NEC"}, {"discipline": "Electrical", "sheet": "E01.01", "source_text": "CONTRACTOR SHALL CONFORM TO ALL LOCAL, STATE, AND APPLICABLE CODES, 2023 NEC, 2021 IBC...", "asserted_value": "2023 NEC, 2021 IBC"}], "recommended_resolution": "Verify the applicable code editions with the Authority Having Jurisdiction and update all references throughout the drawing set to be consistent.", "code_reference": null}, {"issue_id": "CBI-009", "source_stage": "constructability", "category": "tolerance_fit", "severity": "medium", "confidence": "high", "location": "Throughout Space", "disciplines": ["Architectural"], "sheets": ["A23.01"], "description": "The ceiling specifications on the Finish Plan (A23.01) are contradictory. The acoustic tile (AT-1) is specified with an 'Angled Tegular' edge profile, while the grid (C4-A) is specified for a 'Square Lay In' edge profile. These two profiles are incompatible. Tegular tiles drop below the face of the grid, while lay-in tiles sit flush within the grid opening. The wrong combination will not fit together.", "evidence": [{"discipline": "Architectural", "sheet": "A23.01", "source_text": "AT-1 MANUF: ARMSTRONG MODEL: DUNE #1774 ... EDGE PROFILE: ANGLED TEGULAR 15/16\"", "asserted_value": "Tile has a Tegular edge"}, {"discipline": "Architectural", "sheet": "A23.01", "source_text": "C4-A MANUF: ARMSTRONG PRODUCT: ULTIMA 1910 ... GRID: PRELUDE XL 15/16\" EXPOSED TEE IN WHITE EDGE PROFILE: 15/16\" SQUARE LAY IN", "asserted_value": "Grid is for a Square Lay-in tile"}], "recommended_resolution": "Clarify the intended ceiling tile edge profile (Tegular or Square Lay-in) and ensure both the tile and grid specifications are coordinated to match.", "code_reference": null}, {"issue_id": "CBI-010", "source_stage": "constructability", "category": "sequencing", "severity": "medium", "confidence": "high", "location": "CLEANING SUPPLIES/STORAGE Room", "disciplines": ["Plumbing", "Architectural"], "sheets": ["P02.01", "A24.01"], "description": "The Plumbing plan (P02.01) shows a mop sink (MS-1), floor drain (FD-1) and floor sink (FS-1) in the 'CLEANING SUPPLIES/STORAGE' room. These fixed pieces of equipment are not indicated on the Architectural plans (e.g., A24.01). The omission from architectural plans creates a risk of conflict with finishes, casework, or other wall-mounted items, and raises questions about required wall backing for the faucet and sink.", "evidence": [{"discipline": "Plumbing", "sheet": "P02.01", "source_text": "MS-1", "asserted_value": "Plumbing plan shows Mop Sink MS-1"}, {"discipline": "Architectural", "sheet": "A24.01", "source_text": "CLEANING SUPPLIES/STORAGE", "asserted_value": "Architectural plan shows an empty room with no mop sink."}], "recommended_resolution": "Add the mop sink and other fixed plumbing equipment to the architectural floor plans to ensure proper spatial coordination, and add blocking details as required.", "code_reference": null}, {"issue_id": "CBI-011", "source_stage": "constructability", "category": "dimension_closure", "severity": "low", "confidence": "high", "location": "Restrooms", "disciplines": ["Architectural"], "sheets": ["A51.01"], "description": "There is a dimensional conflict for the side grab bar in the typical restroom. The elevation (2/A51.01) dimensions the grab bar as 3'-4\" long. However, the associated blocking detail (6/A51.01) calls for a minimum length of 3'-6\". The elevation shows a bar that does not meet the minimum length required by the blocking detail. This could lead to ordering the wrong size bar or failing inspection.", "evidence": [{"discipline": "Architectural", "sheet": "A51.01", "source_text": "2/A51.01 (showing grab bar dimension) 3'-4\"", "asserted_value": "3'-4\" grab bar length"}, {"discipline": "Architectural", "sheet": "A51.01", "source_text": "6/A51.01 (showing blocking for grab bar) 3'-6\" MIN.", "asserted_value": "3'-6\" minimum grab bar length"}], "recommended_resolution": "Coordinate the grab bar length shown in elevation with the minimum length specified in the blocking detail. Adjust one of the details to be consistent.", "code_reference": null}]} |