/construction-docs

name: construction-docs
version: 1.0.0
description: "Generates complete construction documentation packages — BOM, installation sequences, commissioning checklists, and O&M manuals — from verified engineering designs."
user-invocable: true
allowed-tools: Read Grep Glob Bash
metadata:
  extensions:
    gsd-skill-creator:
      version: 1
      createdAt: "2026-02-27"
      triggers:
        intents:
          - "bill of materials"
          - "BOM"
          - "installation sequence"
          - "commissioning"
          - "pre-commissioning"
          - "O&M manual"
          - "operations and maintenance"
          - "construction documents"
          - "hydrostatic test"
          - "megger test"
          - "insulation resistance"
          - "punch list"
          - "startup procedure"
          - "spare parts"
          - "maintenance schedule"
        contexts:
          - "construction documentation"
          - "infrastructure engineering"
          - "commissioning procedures"
          - "data center construction"
domain: physical-infrastructure
tier: output
depends_on:
  - fluid-systems
  - power-systems
  - thermal-engineering
  - blueprint-engine
safety: mandatory-pe-disclaimer
applies_to:
  - skills/physical-infrastructure/**
  - "*.calc"
  - "*.pid"
  - "*.sld"

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 exchan