construction-docs

Construction Documents Skill

At a Glance

Generate the complete paper package that contractors need to build a system — Bill of Materials, installation sequences, commissioning tests, and Operations & Maintenance manuals — from verified engineering designs.

Activation: After the Architect, Calculator, and Safety agents complete a design and the blueprint engine has generated drawings. InfrastructureRequest with outputFormat including 'construction'.

Four output types:

1. Bill of Materials (BOM): Structured material list with quantities, part numbers, and suppliers extracted from verified design calculations.
2. Installation Sequence: Code-driven ordering of construction activities with trade assignments, prerequisites, and inspection hold points.
3. Commissioning Checklists: Pre-commissioning test procedures (hydrostatic, megger) and system startup procedures with acceptance criteria.
4. O&M Manual: Maintenance schedules, spare parts lists, operating procedures, and emergency procedures for the completed system.

When to use: Design is verified and safety-reviewed, ready for construction. All calculations must pass Safety Warden review before generating construction documents.

Key constraint: All construction documents require review by a licensed Professional Engineer before use in procurement, construction, or installation.

ENGINEERING DISCLAIMER: All construction documents generated by this skill are AI-assisted drafts. They MUST be reviewed, stamped, and signed by a licensed Professional Engineer (PE) before use in procurement, construction, installation, or commissioning. Local building codes, jurisdictional requirements, and site-specific conditions may impose additional requirements not captured here. User assumes all responsibility for PE review and code compliance.

Quick start: Provide a completed BlueprintPackage (from the blueprint engine) and this skill generates all four document types. Templates are available in @references/templates/ for customization.

Input:  BlueprintPackage (drawings + calculations + BOM + safetyReview)
Output: BOM spreadsheet, installation sequence, commissioning checklists, O&M manual

Quick routing:

• BOM generation? See [BOM Generation](#bom-generation-constr-01)
• Installation ordering? See [Installation Sequence](#installation-sequence-constr-02)
• Test procedures? See [Pre-Commissioning Checklists](#pre-commissioning-checklists-constr-03)
• System startup? See [Commissioning Procedures](#commissioning-procedures-constr-04)
• Maintenance docs? See [O&M Manual Generation](#om-manual-generation-constr-05)

BOM Generation (CONSTR-01)

Extracting Materials from Design Specifications

The BOM is derived from verified design calculations and drawings. Each CalculationRecord in the BlueprintPackage identifies materials by their engineering specifications; the BOM skill translates these into procurement-ready line items.

Extraction process:

1. Parse P&ID drawings for pipe sizes, fittings, valves, and equipment tags
2. Parse SLD drawings for conductors, conduit, panelboards, and protective devices
3. Cross-reference with CalculationRecord outputs for exact sizing (pipe NPS, conductor AWG, equipment ratings)
4. Apply material specifications from design basis (ASTM pipe grades, NEC conductor types, equipment model numbers)
5. Add supports, hangers, and insulation per ASME B31.9 (pipe) and NEC 300 (conduit) spacing requirements
6. Include consumables (welding rod, solder, tape, sealant, fasteners)

Standard BOM Columns

Every BOM must include these columns:

| Column | Description | Example | |--------|-------------|---------| | Line Number | Sequential identifier by category | 100, 101, 102... | | Item Description | Engineering description with specification | "Carbon steel pipe, 3" SCH 40, ASTM A53 Gr B" | | Part Number | Manufacturer part number (if applicable) | "VIC-77" | | Quantity | Count or measured amount | 150 | | Unit | Unit of measure | EA, LF, SF, SET | | Unit Cost | Estimated cost per unit (if known) | $12.50 | | Supplier | Preferred vendor or manufacturer | "Ferguson" | | Notes | Installation notes, alternatives, lead time | "Per ASTM A53 Gr B, 21-day lead" |

Material Categories

Organize BOM by category with line number ranges:

| Category | Line Range | Contents | |----------|-----------|----------| | Pipe and Fittings | 100-199 | Pipe by size/material, elbows, tees, reducers, flanges, unions, couplings | | Valves | 200-249 | Gate, globe, ball, check, butterfly, control valves by size and class | | Equipment | 250-299 | Pumps, CDUs, heat exchangers, chillers, cooling towers | | Electrical Equipment | 300-349 | Transformers, UPS, PDUs, panelboards, switchgear | | Cable and Conduit | 350-399 | Conductors by type/gauge, conduit by type/size, cable tray, fittings | | Supports and Hangers | 400-449 | Pipe hangers, conduit straps, cable tray supports, seismic bracing | | Insulation | 450-499 | Pipe insulation, duct insulation, firestopping | | Consumables | 500-549 | Welding rod, solder, joint compound, tape, sealants, fasteners |

Multi-Size Item Handling

For items that come in multiple sizes (e.g., pipe with fittings), create a separate line item for each fitting type and size:

100  Carbon steel pipe, 3" SCH 40          — 150 LF
101  90-deg elbow, 3" SCH 40 BW            — 12 EA
102  Straight tee, 3" SCH 40 BW            — 4 EA
103  Concentric reducer, 3"x2" SCH 40 BW   — 2 EA
104  Gate valve, 3" 150# flanged            — 6 EA
105  Flange, 3" 150# RFWN                   — 12 EA
106  Gasket, 3" 150# spiral wound           — 12 EA
107  Bolting, 3" 150# B7/2H set             — 12 SET

Data Center Cooling BOM Example Elements

For a typical 200 kW chilled water cooling system:

• 3" carbon steel supply/return headers (ASTM A53 Gr B, SCH 40)
• 2" carbon steel branch lines to each CDU
• Butterfly isolation valves at each CDU connection
• Balancing valves for flow adjustment
• Pressure/temperature test ports (Pete's plugs)
• CDU units (sized per thermal-engineering calculations)
• Centrifugal pumps (duty + standby, per pump selection calculations)
• Expansion tank (sized for system volume thermal expansion)
• Air separator (at system high point)
• Chemical treatment pot feeder
• Pipe insulation (per ASHRAE 90.1 minimum thickness)

Template location: @references/templates/bom-template.md

Installation Sequence (CONSTR-02)

Code-Driven Ordering Principles

Installation sequence is not arbitrary — it is driven by building code requirements, trade coordination needs, and inspection hold points.

NEC Article 110 (General Work Requirements):

• All electrical equipment must be installed per manufacturer instructions (110.3(B))
• Working space clearances must be maintained during and after installation (110.26)
• Equipment grounding must be complete before any conductor is energized

IPC Chapter 3 (General Regulations):

• Rough-in inspection required before concealing piping (jurisdictional)
• Pressure testing required before insulation application
• Final inspection required before occupancy

ASHRAE 90.4 / Data Center Commissioning:

• Factory Acceptance Test (FAT) before equipment delivery
• Site Acceptance Test (SAT) on equipment delivery
• Integrated Systems Test (IST) before occupancy

Prerequisite Notation

Installation steps use prerequisite notation to enforce ordering:

• [PREREQ: item X complete before starting] — hard dependency
• [HOLD: Inspection Required] — jurisdictional inspection point; work stops until inspector approves
• [TRADE: E/M/S] — trade assignment (Electrical/Mechanical/Structural)

Trade Sequencing for Data Center Work

Standard data center MEP installation sequence:

Phase 1: Pre-Construction

1. [TRADE: S] Structural modifications (floor penetrations, wall openings, equipment pads)
2. [TRADE: S] Seismic brac