Roofing contractors spend hours writing proposals, supplement documentation, and adjuster correspondence. Claude AI handles that writing work, turning measurement reports, damage photos, and scope details into finished documents in minutes. This guide covers the specific workflows, prompts, and input requirements that produce professional, client-ready output.
Where AI Fits in Your Roofing Workflow
A residential roofer runs 200 to 500 estimates a year. A commercial contractor puts together 20 to 60 detailed bids. An insurance restoration company handles hundreds of claims. Across all three, the writing work — proposals, scopes, supplement documentation, adjuster correspondence — eats hours per job that do not need to.
Claude handles that writing work. It does not measure a roof from a satellite photo. Hover, EagleView, and Roofr do that. What Claude does is turn the measurement report, the damage photos, and the scope details into finished proposals, insurance supplements, and negotiation letters in minutes instead of hours.
What Claude Handles
- Writing residential proposals from your takeoff report and material selections
- Producing commercial roof scope narratives with proper spec references (ASTM, FM Global, ANSI/SPRI)
- Drafting insurance supplement documentation with Xactimate line-item justifications
- Writing correspondence to adjusters, homeowners, and property managers
- Producing damage narratives from your inspection photos and notes
- Converting your standard operating procedures into project-specific work plans
- Reviewing insurance estimates for missing line items you should be requesting
What Claude Cannot Do
- Measure a roof from a satellite image or drone photo (use Hover, EagleView, Roofr)
- Estimate quantities visually (use your aerial measurement tool)
- Apply your specific pricing without you providing it
- Produce final Xactimate estimates (use Xactimate)
- Replace the physical inspection
The Input Checklist for Quality AI Output
Bad inputs produce generic output. Missing any of these forces Claude to guess. Include them and the output is 80 to 90 percent ready to send.
| Input | What to Include | Why It Matters |
|---|---|---|
| Aerial measurement report | Squares, pitch, penetrations, valleys, ridges, hips, perimeter | Claude references specific measurements in scope language |
| Photo documentation | Damage photos, existing condition, penetrations | Claude writes damage narratives and justification letters |
| Insurance estimate | Carrier's initial Xactimate estimate | Claude identifies missing, undervalued, or incorrect line items |
| Material specifications | Exact underlayment, shingles, drip edge, ridge cap, accessories | "GAF Timberline HDZ" produces specific output; "architectural shingles" produces generic output |
| Labor and disposal assumptions | Tear-off layers, dumpster costs, ground protection, roof access | These affect the scope narrative and pricing justification |
| Property specifics | Roof access difficulty, obstructions, HOA requirements, permit requirements, HOA-approved colors | Prevents boilerplate that ignores job-specific details |
Four Roofing Workflows That Save the Most Time
Workflow 1: Residential Proposal From a Takeoff Report
You have inspected the roof. You have an aerial measurement report. You know what materials you are proposing. Turn this into a homeowner proposal.
Example prompt:
Write me a residential roof replacement proposal for [homeowner name] at [property address].
Measurement report (from EagleView):
- Total squares: 32.5
- Predominant pitch: 6/12
- Penetrations: 3 (bathroom vent, kitchen vent, plumbing stack)
- Skylights: 0
- Chimneys: 1 brick chimney requiring new flashing
- Valleys: 68 LF
- Ridges: 42 LF
- Hips: 26 LF
- Eaves: 128 LF
- Rakes: 84 LF
Existing conditions:
- Two layers of architectural shingles, both to be removed
- Decking condition unknown, allow for 4 sheets of OSB replacement
- Gutters staying, need protection during work
Scope:
- Full tear-off both layers
- Install new 15-lb synthetic underlayment
- Install GAF Timberline HDZ shingles, color Charcoal
- New drip edge on all eaves and rakes
- Ice and water shield on all valleys, eaves, and around chimney
- New pipe boot flashings on all penetrations
- New step and counter flashing at chimney
- New ridge vent (replace existing)
- Full clean-up including magnetic sweep
Warranty: GAF System Plus 50-year workmanship
Investment: $18,500
Payment schedule: 50% at material delivery, 50% at completion
What you get back: a client-ready proposal with sections for scope of work, materials specifications, warranty, timeline, payment terms, and signature block. Adjust the prompt with your firm's boilerplate for warranty language and payment terms, and Claude produces the same format every time.
Workflow 2: Insurance Supplement Documentation
The carrier's Xactimate estimate came in short. You need to document supplements for the adjuster. This is where Claude saves the most time in restoration work.
Example prompt:
I need to draft a supplement for an insurance claim. Attached is the carrier's Xactimate estimate.
Property: [address], hail damage claim from [date of loss] storm
The carrier's estimate is missing these items I documented on inspection:
- Ice and water shield around chimney (roof is 8/12 pitch, code required)
- Drip edge replacement (existing is corroded, damaged by hail impact)
- Ridge vent replacement (existing damaged, must be replaced with new shingle installation)
- Two additional pipe boot flashings not listed
- Detach and reset satellite dish (roof-mounted, must be removed for proper installation)
- Ground protection (three landscape beds, adjacent to work area)
- Debris removal on second-story roof (dumpster placement restricted)
Write a professional supplement request letter to the adjuster that:
- References the specific line items missing from the original estimate
- Cites relevant code requirements where applicable (local IRC amendments for ice barrier)
- Provides justification for each line item
- Requests specific line item additions with Xactimate line item codes where I have provided them
- Maintains professional tone appropriate for adjuster correspondence
Attached documentation:
- Roof inspection report with photos
- Existing condition photos of drip edge, ridge vent, chimney
- Local code excerpts on ice barrier requirements
What you get back: the letter with proper structure, code citations, and justification language. The Xactimate line-item codes are yours to provide (Claude does not have Xactimate's database), but the writing and structure are done in minutes.
Workflow 3: Commercial Roof Scope for RFP Response
Commercial bid work requires detailed scope narratives that reference specific standards, warranties, and installation requirements. Claude produces this format-specific writing fast.
Example prompt:
Write a commercial roof replacement scope of work narrative for a [building type] at [address].
Roof system: EPDM to be replaced with 60-mil fully-adhered TPO
Total area: 85,000 sq ft, single-ply roof
Substrate: existing insulation over metal deck
Deck condition: sound, no replacement anticipated
Scope items:
- Remove existing EPDM membrane, base sheet, and top layer of insulation
- Salvage bottom layer of polyiso insulation (verified R-25 minimum, sound)
- Install new tapered polyiso insulation to achieve minimum R-30 and positive drainage to existing drains
- Install cover board (DensDeck Prime, 1/4")
- Install 60-mil TPO membrane, fully adhered, white
- New membrane flashings at all penetrations, curbs, walls
- New 26 GA prefinished sheet metal edge metal
- Replace all pitch pans with new lead-based pitch pans, sealed
- Install new walkway pads (10' wide) between rooftop equipment
- Install new drain flashings, connect to existing drains
- Clean and reseal all drain bowls
- Provide 20-year system warranty (Carlisle or GAF)
Applicable standards:
- SPRI ES-1 wind uplift compliance for perimeter and corners
- FM 4470 Class 1-90 minimum
- ASTM C1289 for insulation
- NRCA quality assurance protocols
Include structural sections for:
- Preliminary conditions
- Scope of work by system component
- Materials specifications
- Installation requirements
- Warranty
- Cleanup and closeout
Do not include pricing (that goes in the fee proposal separately).
What you get back: a scope narrative that can go directly into the RFP response. Adjust the prompt for your specific manufacturers, your firm's standard warranty language, and your standard installation requirements.
Workflow 4: Adjuster Correspondence and Negotiation
Insurance restoration involves consistent correspondence with adjusters, homeowners, and mortgage companies. Claude handles this quickly.
Example prompt:
Draft a professional letter to [adjuster name] at [carrier] regarding claim [claim number].
Situation: the carrier's estimate for [property] came in at $16,400. Our estimate for the same scope is $24,800. The difference is:
- Carrier scoped the roof at 28 squares. Aerial measurement shows 32.5 squares.
- Carrier's estimate uses builder's grade shingles. Existing shingles are architectural (visible in adjuster's photos).
- Carrier omitted ice and water shield (code required in this county for slopes above 4/12).
- Carrier omitted the chimney flashing replacement (existing flashing is torn and cannot be reused).
Write a letter that:
- Is professional and non-confrontational
- Provides specific evidence for each disagreement
- Requests a re-inspection with our estimator present
- Proposes specific dates for the re-inspection in the next 10 days
- Cites the specific supporting documentation attached (aerial measurement report, code excerpt, damage photos)
Do not overstate. Keep the tone collaborative.
What you get back: a letter that would take 20 to 30 minutes to write manually. Claude produces it in seconds with the tone calibrated for adjuster correspondence.
Six Mistakes That Kill AI-Generated Roofing Output
1. Vague material specifications
- Bad: "Architectural shingles"
- Good: "GAF Timberline HDZ, color Charcoal, matched to existing"
2. Missing measurement report Asking Claude to write a proposal without measurements forces it to use placeholders. Attach the report or paste the numbers.
3. No pricing context Claude cannot invent your prices. Give it the pricing structure (materials cost, labor cost, disposal, overhead, profit margin), or provide the total price and let Claude write around it.
4. Skipping property specifics HOA requirements, permit requirements, access difficulty, obstructions all belong in the prompt. Missing them produces boilerplate that ignores the specifics that make each job different.
5. Not naming the recipient "Write a proposal" produces generic tone. "Write a proposal for a homeowner named [name] whose house was damaged in the March storm" produces language calibrated for that specific person.
6. Treating Claude like Xactimate Claude cannot produce Xactimate estimates. It can produce supplement documentation and justification narratives that reference Xactimate line items. Keep the tools separate.
Quality Checklist Before You Send
The first draft is 80 to 90 percent ready. Check the remaining 10 to 20 percent for:
Numbers accuracy
Did Claude use the exact measurements from your report? If you provided 32.5 squares, did the proposal say 32.5 squares? Check every number.
Material specificity
Are the exact materials you specified in the proposal? Some readers compare specifications line by line.
Code citations
If Claude cited a code (ice barrier, drip edge, roof deck attachment), verify the citation is current and applies to your jurisdiction.
Tone check
Does the proposal sound like your firm? Or does it sound like generic AI marketing copy? If it is the second, add more specifics to the prompt.
Line item completeness
For insurance supplements, verify that every line item you documented in the field appears in the supplement letter with proper justification.
Automate Your Roofing Documentation With Octopus Builds
If you are spending more time writing proposals and arguing with adjusters over supplements than you are on actual roof work, the bottleneck is not your trade skills. It is the paperwork layer that surrounds every job.
At Octopus Builds, we help roofing contractors connect their aerial measurement data, inspection notes, and pricing to AI systems that write homeowner proposals, supplement letters, and commercial scope narratives without sounding like a chatbot. We build the prompt libraries, the review workflows, and the integration logic so your team stays in control while the repetitive writing gets handled automatically.
Build with Octopus Builds
Need help turning the article into an actual system?
We design the operating model, product surface, and delivery plan behind AI systems that need to ship cleanly and keep working in production.
