construction-takeoff

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: construction-takeoff
description: Automated construction quantity surveying from PDF plans using AI. Processes construction drawings, extracts quantities/materials, analyzes competitor solutions via Firecrawl, calculates costs, and generates Excel-based takeoff reports for stakeholder collaboration.
---

# Construction Takeoff Agent

Agentic AI system for automated construction quantity surveying from PDF construction plans.

## Overview

The Construction Takeoff Agent is a specialized LangGraph orchestration that processes PDF construction plans (site plans, floor plans, elevations, details) to extract quantities, materials, and measurements. It integrates competitive intelligence via Firecrawl API and generates comprehensive Excel workbooks suitable for stakeholder collaboration.

## Core Capabilities

### 1. PDF Plan Analysis
- Processes construction plans using Claude's native vision capabilities
- Supports multiple drawing types: site plans, floor plans, elevations, details
- Extracts drawing scale, dimensions, annotations, and specifications
- Handles multi-page PDFs with page-by-page analysis

### 2. Quantity Extraction
- Identifies and quantifies construction materials
- Categorizes items by CSI MasterFormat divisions:
  - Earthwork (excavation, grading, fill)
  - Concrete (slabs, footings, walls, columns)
  - Masonry (brick, block, stone)
  - Metals (structural steel, rebar)
  - Wood & Plastics (framing, joists, decking)
  - Finishes (drywall, paint, flooring, tile)
  - Site Work (paving, curbs, landscaping, utilities)
  - Mechanical/Electrical/Plumbing systems
- Measures areas, linear dimensions, and volumes
- Counts discrete items (doors, windows, fixtures)

### 3. Competitor Analysis (via Firecrawl)
- Scrapes leading construction takeoff solutions:
  - PlanSwift
  - Bluebeam Revu
  - On-Screen Takeoff
  - STACK Construction Technologies
- Extracts competitor features and automation capabilities
- Identifies best practices and differentiators
- Incorporates insights into report generation

### 4. Cost Estimation
- Calculates material costs using Florida market unit prices (2025)
- Estimates labor hours per construction task
- Applies labor rates ($75/hour for Florida construction)
- Provides detailed cost breakdown by category
- Generates total project estimate (materials + labor)

### 5. Excel Report Generation
- Creates multi-sheet workbook:
  - **Project Summary:** Overview, cost totals, labor hours
  - **Detailed Takeoff:** Line-item quantities with unit costs
  - **Materials List:** Categorized materials with specifications
  - **Competitor Insights:** Features and best practices discovered
- Professional formatting with headers, colors, borders
- Currency and number formatting
- Auto-sized columns for readability

### 6. Supabase Integration
- Logs all takeoff results to `insights` table
- Category: `spd_construction_takeoff`
- Stores project metadata, costs, report paths
- Enables historical analysis and reporting

## Workflow Stages

```
1. PDF Processing → Analyze construction plans with Claude Vision
2. Quantity Extraction → Structure quantities using AI
3. Competitor Analysis → Scrape competitors via Firecrawl
4. Cost Calculation → Apply unit costs and labor rates
5. Report Generation → Create Excel workbook
6. Supabase Logging → Store results for tracking
```

## Usage

### Via GitHub Actions (Recommended)

Trigger the workflow from GitHub Actions UI or API:

```bash
curl -X POST \
  -H "Authorization: token YOUR_GITHUB_TOKEN" \
  -H "Accept: application/vnd.github.v3+json" \
  https://api.github.com/repos/breverdbidder/spd-site-plan-dev/actions/workflows/construction_takeoff_workflow.yml/dispatches \
  -d '{
    "ref": "main",
    "inputs": {
      "pdf_url": "https://example.com/construction_plan.pdf",
      "project_name": "Bliss Palm Bay Phase 2",
      "project_id": "SPD-2025-003"
    }
  }'
```

### Via Python API

```python
from construction_takeoff_agent import run_construction_takeoff