Construction Cost Estimator

Do NOT trigger for: reviewing an existing GC budget or contractor bid (use construction-budget-gc-analyzer), managing an active construction project (use construction-project-command-center), procurement and contract negotiation (use construction-procurement-contracts-engine), or cost segregation tax analysis on a completed building (use cost-segregation-analyzer).

Input Schema

Project Profile

Inferred Defaults

If not provided, infer:

• construction_type: wood_frame for 1-4 stories multifamily/self_storage; steel for office/industrial > 3 stories; concrete for hospitality/medical or any building > 8 stories
• union_labor: true for NY, NJ, MA, IL, CA metro areas; false elsewhere
• prevailing_wage: true if public land, public financing, or government tenant; false otherwise
• seismic_zone: look up by location (high for coastal CA; moderate for Pacific NW, Memphis, Charleston)
• climate_zone: look up by location (zone 1-2 for FL/TX/AZ; zone 5-6 for upper Midwest/Northeast; zone 7-8 for northern MN, WI, ME)

Process

Workflow 1: CSI Division Cost Buildup

Build the hard cost estimate bottom-up using the CSI MasterFormat division structure. Reference references/csi-cost-database.yaml for base $/SF ranges by asset type, construction type, and finish level.

Step 1: Select the base cost profile matching the input asset_type, construction_type, and finish_level.

Step 2: For each CSI division, determine the applicable $/SF:

Step 3: Sum all divisions to produce the total hard cost $/SF (before regional adjustment).

Step 4: Present the division-level breakdown as a table:

Division | Description          | $/SF    | Total Cost    | % of Hard
---------|----------------------|---------|---------------|----------
01       | General Requirements | $XX.XX  | $X,XXX,XXX    | XX.X%
03       | Concrete             | $XX.XX  | $X,XXX,XXX    | XX.X%
...      | ...                  | ...     | ...           | ...
         | TOTAL HARD COST      | $XXX.XX | $XX,XXX,XXX   | 100.0%

Workflow 2: Regional Cost Adjustment

Apply a city-specific cost multiplier to convert national-average costs to local market costs. Reference references/regional-cost-factors.yaml for the multiplier database.

Step 1: Match the input location to the nearest city in the regional factors database. If exact city is not listed, use the closest metro area or state average.

Step 2: Retrieve the base multiplier. Example: New York, NY = 1.45; Houston, TX = 0.85.

Step 3: Apply supplemental adjustments on top of the base factor:

• Union labor premium: if union_labor is true and the base factor does not already reflect union pricing, add 10-20% to labor-intensive divisions (03, 04, 05, 06, 09, 22, 23, 26)
• Prevailing wage premium: if prevailing_wage is true, add 5-15% to all labor components (approximately 60% of hard cost is labor)
• Seismic zone premium: high = +5-10% on structural divisions (03, 05); moderate = +2-5%
• Remote site premium: if location is > 50 miles from a major metro, add 5-10% for mobilization and labor travel

Step 4: Calculate the adjusted hard cost:

Adjusted Hard Cost = Base Hard Cost x Regional Factor x (1 + Union Adj) x (1 + Prevailing Wage Adj) x (1 + Seismic Adj)

Step 5: Present the adjustment waterfall:

Base Hard Cost (national avg)           $XXX.XX /SF     $XX,XXX,XXX
Regional Factor (City, ST = X.XX)       $XXX.XX /SF     $XX,XXX,XXX
Union Labor Adjustment (+XX%)           $XXX.XX /SF     $XX,XXX,XXX
Prevailing Wage Adjustment (+XX%)       $XXX.XX /SF     $XX,XXX,XXX
Seismic Adjustment (+XX%)               $XXX.XX /SF     $XX,XXX,XXX
                                        --------        -----------
Adjusted Hard Cost                      $XXX.XX /SF     $XX,XXX,XXX

Workflow 3: Site-Specific Adjustments

Layer additional costs that vary by site condition but are not captured in the CSI division base costs.

Step 1: Evaluate each site adjustment category:

Step 2: For each applicable adjustment, estimate the cost and add to the hard cost total.

Step 3: Present site adjustments as an addendum:

Site-Specific Adjustments
  Demolition (XX,XXX SF)                $XXX,XXX
  Environmental remediation             $XXX,XXX
  Shoring (XXX LF)                      $XXX,XXX
  Stormwater management                 $XXX,XXX
                                        --------
  Total Site Adjustments                $XXX,XXX ($X.XX /SF)

Workflow 4: Soft Cost Estimation

Layer soft costs as percentages of hard cost. Reference references/soft-cost-benchmarks.md for detailed ranges by project type.

Step 1: Calculate each soft cost category:

Step 2: Financing cost estimation methodology:

Construction Loan Interest = Avg Outstanding Balance x Rate x Construction Duration (months) / 12

Where:
  Avg Outstanding Balance = Total Construction Loan x Draw Factor
  Draw Factor = 0.50-0.60 for typical draw curves (S-curve)
  Rate = SOFR + spread (typically 200-400 bps)
  Duration = construction months + 2-3 months for closeout

Origination Fee = 0.50-1.50% of total loan commitment
Inspection Fees = $1,500-$3,000 per draw x number of draws
Title Insurance = per local rate schedule (0.10-0.50% of loan amount)

Step 3: Present soft costs as a summary table:

Soft Cost Category                     % of Hard     Total Cost
Architecture & Engineering             X.X%          $X,XXX,XXX
Civil Engineering                      X.X%          $XXX,XXX
Permits & Fees                         X.X%          $XXX,XXX
Legal                                  X.X%          $XXX,XXX
Insurance (Builder's Risk)             X.X%          $XXX,XXX
Financing Costs                        X.X%          $X,XXX,XXX
Property Taxes During Construction     X.X%          $XXX,XXX
Marketing & Lease-Up                   X.X%          $XXX,XXX
Developer Fee                          X.X%          $X,XXX,XXX
Accounting & Audit                     X.X%          $XXX,XXX
Testing & Inspection                   X.X%          $XXX,XXX
Commissioning                          X.X%          $XXX,XXX
                                       -----         -----------
Total Soft Costs                       XX.X%         $X,XXX,XXX

Workflow 5: Contingency Framework

Structure contingencies by design stage and risk category. Contingency percentages decrease as design progresses and unknowns are resolved.

Step 1: Determine the design stage from context. If not stated, default to "Conceptual/Pre-Design."

Step 2: Break contingency into three buckets:

• Design contingency: covers scope evolution and design changes still to come. Decreases as design is finalized. Applied to hard costs only.
• Construction contingency: covers field conditions, unforeseen conditions, and minor scope adjustments. Applied to hard costs. Typically 5-10% regardless of design stage.
• Owner contingency: covers owner-directed changes, tenant-specific requests, and decisions not yet made. Applied to total project cost. Typically 3-5%.

Step 3: Calculate total contingency:

Design Contingency      = Hard Cost x Design Contingency %
Construction Contingency = Hard Cost x Construction Contingency %
Owner Contingency       = (Hard Cost + Soft Cost) x Owner Contingency %
                          --------
Total Contingency       = Sum of above

Step 4: Present contingency summary with the explicit note that these are not safety margins to be "spent" -- they are risk reserves that should decrease through the design process.

Workflow 6: TDC Summary

Assemble all components into the Total Development Cost budget.

Step 1: Compile the TDC summary:

TOTAL DEVELOPMENT COST SUMMARY
==============================================================

I. LAND & ACQUISITION
   Land Purchase Price                             $XX,XXX,XXX
   Closing Costs (1-2% of land)                    $XXX,XXX
   Due Diligence (Phase I, survey, geotech)        $XXX,XXX
   Subtotal Land                                   $XX,XXX,XXX

II. HARD COSTS
   CSI Division Costs (regional adjusted)          $XX,XXX,XXX
   Site-Specific Adjustments                       $X,XXX,XXX
   Parking (XX spaces x $XX,XXX/space)             $X,XXX,XXX
   Subtotal Hard Costs                             $XX,XXX,XXX

III. SOFT COSTS
   A/E and Professional Fees                       $X,XXX,XXX
   Permits, Fees, and Legal                        $X,XXX,XXX
   Insurance                                       $XXX,XXX
   Financing Costs                                 $X,XXX,XXX
   Marketing & Lease-Up                            $XXX,XXX
   Developer Fee                                   $X,XXX,XXX
   Other Soft Costs                                $XXX,XXX
   Subtotal Soft Costs                             $X,XXX,XXX

IV. CONTINGENCY
   Design Contingency                              $X,XXX,XXX
   Construction Contingency                        $X,XXX,XXX
   Owner Contingency                               $XXX,XXX
   Subtotal Contingency                            $X,XXX,XXX

V. RESERVES
   Operating Reserve (3-6 months stabilized opex)  $XXX,XXX
   Interest Reserve (if required by lender)        $XXX,XXX
   Lease-Up Reserve (vacancy carry to stabilization) $XXX,XXX
   Subtotal Reserves                               $X,XXX,XXX

==============================================================
TOTAL DEVELOPMENT COST                             $XX,XXX,XXX
==============================================================

KEY METRICS
  TDC / SF (gross)         $XXX.XX
  TDC / SF (net rentable)  $XXX.XX
  TDC / Unit               $XXX,XXX  (multifamily/hospitality only)
  Hard Cost / SF            $XXX.XX
  Soft Cost as % of Hard    XX.X%
  Contingency as % of TDC   X.X%
  Land as % of TDC           X.X%

Step 2: Validate the output against rule-of-thumb benchmarks:

• Hard costs should be 60-75% of TDC (excluding land)
• Soft costs should be 20-35% of hard costs
• Land should be 10-25% of TDC (varies widely by market; can be higher in gateway cities)
• Contingency should be 5-15% of hard + soft (depending on design stage)
• TDC/unit for multifamily should be $200K-$600K (varies by market and finish)

If any metric is outside the expected range, flag it with an explanation.

Workflow 7: Sensitivity Analysis

Produce a three-scenario sensitivity analysis to bracket the cost estimate.

Step 1: Define the three scenarios:

Step 2: Calculate TDC for each scenario:

SENSITIVITY ANALYSIS
                        Low Case        Base Case       High Case
Hard Costs              $XX,XXX,XXX     $XX,XXX,XXX     $XX,XXX,XXX
Soft Costs              $X,XXX,XXX      $X,XXX,XXX      $X,XXX,XXX
Contingency Used        $XXX,XXX        $X,XXX,XXX      $X,XXX,XXX
Financing (duration)    $X,XXX,XXX      $X,XXX,XXX      $X,XXX,XXX
                        -----------     -----------     -----------
TDC (excl. land)        $XX,XXX,XXX     $XX,XXX,XXX     $XX,XXX,XXX
TDC / SF                $XXX.XX         $XXX.XX         $XXX.XX
TDC / Unit              $XXX,XXX        $XXX,XXX        $XXX,XXX
Delta from Base         -X.X%           --              +X.X%

Step 3: Identify the top 3 cost drivers that produce the widest variance between low and high cases. Present a tornado-style ranking:

Top Cost Drivers (by variance impact)
1. Hard cost escalation           +/- $X,XXX,XXX
2. Construction duration          +/- $X,XXX,XXX
3. Contingency usage              +/- $XXX,XXX

Step 4: If the high case TDC exceeds a replacement cost or comp-based ceiling, note that the project may not be feasible at current cost levels. This is the "cost kills the deal" signal.

Workflow 8: Comparable Benchmarks

Provide reference ranges for the estimated cost to help the user calibrate whether the estimate is reasonable.

Step 1: Look up comparable construction cost ranges by asset type:

Step 2: Compare the estimate against the reference range. Position the estimate on the spectrum and explain what drives it toward the low or high end (construction type, finish level, site conditions, regional factor).

Step 3: Note the vintage of comparable data. Construction costs have escalated 20-40% from 2019-2024 due to supply chain disruption, labor shortages, and material price inflation. Costs may continue to escalate 3-6% annually. Flag if the user's timeline extends beyond 12 months and recommend an escalation factor.

Workflow 9: Visual Input -- Floor Plans and Building Drawings

Accept architectural drawings, floor plans, building elevations, or site plans as image inputs. Extract dimensional and programmatic data to drive the cost estimate without requiring manual input of every field.

Step 1: Image Intake: When the user provides an image (floor plan, elevation, rendering, site plan, or sketch), analyze it to extract:

• Gross building footprint and estimated SF per floor
• Number of stories (from elevation or section drawings)
• Unit count and unit mix (from floor plans showing unit boundaries)
• Structural system indicators (column grid spacing, slab thickness notes)
• Finish level signals (material callouts, fixture specifications, millwork details)
• Parking layout (surface, structured, underground) and approximate space count
• Site boundaries and orientation

Step 2: Dimension Validation: Present extracted dimensions back to the user for confirmation:

Extracted from floor plan:
  Building footprint:  ~18,000 SF per floor
  Stories:             5 (from elevation)
  Gross SF:            ~90,000 SF
  Unit count:          ~12 units/floor = 60 total
  Avg unit size:       ~1,200 SF (net)
  Efficiency ratio:    ~80% (estimated from corridor/core layout)
  Structural system:   Wood frame (5-story walk-up pattern)
  Parking:             Surface lot visible, ~80 spaces estimated

Confirm or adjust these values before proceeding.

Step 3: Material Identification: Identify finish materials and systems from drawing details:

• Exterior cladding (brick, fiber cement, stucco, curtain wall, metal panel)
• Roofing system (TPO, EPDM, standing seam, green roof)
• Window type (aluminum, vinyl, wood, curtain wall ratio)
• Interior finishes (LVP, tile, carpet, hardwood; granite vs laminate counters)
• MEP systems (packaged units, VRF, chilled water; fixture grade)

If materials are not specified in the drawings, ask the user: "I can see the general layout but the finish specification is not detailed. What finish level are you targeting? (value / standard / premium / luxury) Or tell me specific materials and I will price them."

Step 4: Drawing-to-Estimate Bridge: Map extracted data into the Input Schema fields and proceed to Workflow 1 (CSI Division Cost Buildup). Flag any assumptions made from visual interpretation:

ASSUMPTIONS FROM VISUAL ANALYSIS (verify before relying on estimate):
- SF estimated from floor plan scale bar / grid dimensions -- +/- 10%
- Unit count based on apparent unit boundaries -- confirm with unit schedule
- Structural system inferred from story count and building form
- Finish level assumed [standard] based on material callouts visible

Workflow 10: Generative Output -- Floor Plans and Building Mockups

When the user describes a project concept in words without drawings, generate visual representations to support the co-creation process. This enables a back-and-forth design dialogue before producing the cost estimate.

Step 1: Concept Intake: Parse the user's description to identify:

• Building program (unit count, unit mix, amenities, commercial space)
• Site constraints (lot dimensions, setbacks, height limits, FAR)
• Design preferences (style, materials, layout priorities)

Step 2: Floor Plan Generation (ASCII): Produce an ASCII-art floor plan showing:

• Unit layout with approximate dimensions
• Corridor and core (elevator/stair) placement
• Common areas and amenities
• Parking layout (if applicable)

Example output:

TYPICAL FLOOR PLAN -- 5-Story Multifamily (60 units, ~18,000 SF/floor)
+------------------------------------------------------------------+
|  1BR/1BA   |  2BR/2BA      |  CORE  |  2BR/2BA      |  1BR/1BA  |
|  650 SF    |  1,050 SF     | ELEV   |  1,050 SF     |  650 SF   |
|            |               | STAIR  |               |           |
+------------+---------------+ MECH   +---------------+-----------+
|            |               | TRASH  |               |           |
|  1BR/1BA   |  2BR/2BA      | MAIL   |  2BR/2BA      |  STUDIO   |
|  650 SF    |  1,050 SF     |        |  1,050 SF     |  450 SF   |
+------------------------------------------------------------------+
             DOUBLE-LOADED CORRIDOR (~6' wide)
Units/floor: 12 (4x 1BR, 4x 2BR, 2x Studio, 2x flex)
Floor plate: ~18,000 GSF | ~14,400 NSF | 80% efficiency

Step 3: Building Massing (ASCII): Generate a simple elevation or massing diagram:

BUILDING SECTION -- 5 Stories, Wood Frame over Podium
                    ___________________________
                   |  FLOOR 5  (residential)   |   < TPO roof
                   |  FLOOR 4  (residential)   |
                   |  FLOOR 3  (residential)   |   < wood frame
                   |  FLOOR 2  (residential)   |     typ. floors
                   |__________________________|
                   |  FLOOR 1  (podium/retail) |   < concrete podium
                   |__________________________|
    ============== GRADE ==============
                   |  PARKING (1 level below)  |   < below-grade
                   |__________________________|
Height: ~62' (12' ground + 10' x 4 upper + 6' parapet)

Step 4: Image Generation (when available): If image generation capabilities are available (AI SDK, DALL-E, or similar), produce:

• 3D massing rendering showing building form, scale, and context
• Material study boards showing exterior finish options with cost implications
• Site plan showing building placement, parking, landscaping, and circulation

Present options with cost deltas: "Brick veneer adds ~$8/SF vs fiber cement. Here is a rendering of each option."

Step 5: Co-Creation Iteration: After presenting the initial concept, ask the user to refine:

• "Want to adjust the unit mix? More 2BRs will increase revenue but also construction cost."
• "The podium parking adds ~$15M. Would a surface lot work for this market?"
• "I can show you what a luxury finish package looks like vs standard -- want to compare?"

Each iteration regenerates the relevant visual and updates the cost estimate in real time. Continue the dialogue until the user says "lock it" or "run the full estimate."

Workflow 11: Co-Creation Design Loop

Combines visual input and generative output into an iterative design-cost feedback loop.

Step 1: Start from either direction:

• User provides drawings → Workflow 9 extracts data → Workflow 1-8 estimates cost → present results with the drawing annotated with cost callouts
• User provides text description → Workflow 10 generates mockups → user refines → Workflow 1-8 estimates each iteration

Step 2: Cost-Design Tradeoff Table: After each iteration, present a comparison:

DESIGN OPTION COMPARISON
                        Option A         Option B         Option C
                        (User Original)  (Value-Engineered) (Premium)
Building SF             90,000           85,000           95,000
Units                   60               56               64
Construction Type       Wood frame       Wood frame       Concrete podium
Finish Level            Standard         Value            Premium
Hard Cost               $18.0M           $14.2M           $26.8M
Hard Cost $/SF          $200             $167             $282
Soft Cost               $4.5M            $3.6M            $6.7M
TDC                     $22.5M           $17.8M           $33.5M
TDC $/Unit              $375K            $318K            $523K

Step 3: Lock and Finalize: When the user selects a direction, lock the design parameters and produce the full Workflow 1-8 estimate with all divisions, regional adjustments, and sensitivity analysis.

Red Flags

1. Hard cost below the low end of comparable range: the estimate may be unrealistically aggressive. Verify that all scope is captured, particularly site work, parking, and specialty items. A below-market estimate creates retrade risk when actual bids come in higher.

2. Soft costs below 20% of hard costs: likely missing major categories. Check for missing financing costs (frequently underestimated), permits/impact fees (jurisdiction-specific and easy to miss), and testing/inspection costs.

3. No contingency or contingency below 5%: no institutional lender or equity partner will underwrite a project without contingency. A 0% contingency estimate signals inexperience. Minimum 5% at CD stage; 10-15% at conceptual stage.

4. Land cost exceeds 25% of TDC: the project may be overleveraged on land. The Linneman test suggests land should be 10-20% of TDC for most product types. Higher land cost ratios compress development returns and leave no margin for cost overruns.

5. Parking cost exceeds 20% of hard cost: underground parking at $50K-$75K per space can overwhelm the budget. Evaluate whether structured parking is essential or if surface parking, reduced ratios, or shared parking can reduce cost.

6. Estimate based on conceptual design without site-specific data: the estimate is only as good as the assumptions. Without a geotechnical report, utility survey, and environmental assessment, site cost estimates are guesswork. Flag this uncertainty explicitly.

7. Duration assumption is unrealistic: construction duration directly drives financing costs. Underestimating duration by 6 months on a $50M project with a 7% construction loan adds $1M+ in carry cost. Always validate the assumed construction timeline against comparable project durations.

8. Escalation not applied for future-start projects: if construction start is 12+ months away, costs should be escalated 3-6% per year. Failing to apply escalation creates a budget shortfall before construction begins.

Chains To / From

Chains From (this skill receives inputs from):

• entitlement-feasibility: zoning approval and entitlement conditions set the buildable envelope (SF, stories, use, density)
• land-residual-hbu-analyzer: HBU analysis defines the optimal use type and scale for the site
• comp-snapshot: comparable sales/rents provide the revenue side that the TDC budget must support

Chains To (this skill feeds outputs to):

• dev-proforma-engine: TDC budget is a primary input to the development pro forma (total cost, draw schedule, timeline)
• capital-stack-optimizer: TDC determines total equity + debt required and informs the optimal capital structure
• construction-budget-gc-analyzer: conceptual estimate becomes the benchmark for evaluating actual GC bids
• loan-sizing-engine: TDC drives construction loan sizing (LTC constraint)
• construction-project-command-center: approved TDC budget sets the baseline for cost tracking during construction
• ic-memo-generator: TDC summary and sensitivity analysis feed the cost section of the IC memo

Clarifying Questions

Before producing a full estimate, ask the user about any of the following that are not provided:

1. Design stage: "What stage of design are you in? Conceptual, schematic design, design development, or construction documents? This determines the appropriate contingency level."
2. Land cost: "Do you have a land acquisition price, or should I exclude land and estimate construction costs only?"
3. Parking requirement: "What is the required parking ratio (spaces per unit or per 1,000 SF)? Is structured or underground parking required by zoning or market expectations?"
4. Sustainability requirements: "Are there any green building certification targets (LEED, Energy Star, Passive House) or local energy code requirements beyond baseline code?"
5. Timeline: "When do you expect construction to start, and what is the target duration? This affects escalation and financing cost estimates."

Reference Files

• references/csi-cost-database.yaml -- base $/SF ranges by CSI division, asset type, construction type, and finish level
• references/regional-cost-factors.yaml -- city-level cost adjustment multipliers for 50+ US markets
• references/soft-cost-benchmarks.md -- soft cost category benchmarks with worked examples and financing cost methodology