Specification-Ready Repair Documentation: How to Write a Building Envelope Repair Scope a Contractor Can Bid and an Insurer Can Approve

The Problem I See in Almost Every Claim File

Over more than 25 years in building science and construction forensics, I have reviewed a lot of repair scopes. Many of them were prepared by capable people. The trouble is rarely competence. The trouble is that the scope was written as a narrative, and a narrative leaves room for interpretation. “Repair water damage around windows as needed.” “Replace damaged sheathing.” “Reseal and flash per manufacturer.” Each of those phrases sounds reasonable. None of them tells a contractor which windows, how many square feet, what flashing sequence, or who decides when the work is done. Each contractor fills the gaps with their own assumptions, and those assumptions show up as bids that are hard to compare, adjusters who cannot reconcile the numbers, and change orders once the cladding comes off. Specification-ready repair documentation is the discipline of closing those gaps before the work is bid. In plain terms, it is an elevation-keyed, detail-referenced scope that a contractor can bid and an insurer can evaluate without having to interpret it.

Figure 1. The same window leak, written two ways. The difference is not length; it is how much each reader has to guess.

What “Specification-Ready” Actually Means

I use a simple test. A scope is specification-ready when a qualified contractor who has never been to the site can answer five questions from the documents alone:

• Where? The exact location of every repair, tied to something visible on the building.
• What? The condition being corrected and the action required.
• How? A drawn detail and a referenced specification section for each assembly.
• How much? A measured quantity, with a stated method for handling unknowns.
• How do we know it is done? Defined inspection hold points and, where appropriate, field testing.

If any of those answers depends on a phone call to the consultant, the document is not ready yet.

Element 1: Elevation Keying — Every Repair Gets an Address

The foundation of the method is an elevation key. I take each building elevation, establish a reference grid (column lines, bays, or simple lettered and numbered grids when the building has no structural grid), identify each floor level, and tag every window, door, and penetration. Each repair condition then receives a unique ID tied to that coordinate system. On our projects, the base drawings often come from 3D reality capture and drone imagery rather than tape measurements alone, which helps keep dimensions and opening locations consistent from elevation to elevation. The method works with hand-measured elevations too; the point is consistency, not technology. Figure 2. An elevation key (composite illustration). R-07 is not “a window on the north side”; it is Grid B–C, Level 2, window W2-02, built per Detail 3/A-501. That repair ID then follows the work everywhere: the photo log, moisture and test data, the bid form, the pay application, and the close-out record. When an adjuster asks why R-07 costs what it does, the answer is traceable from the original finding to the final invoice.

Element 2: Detail Referencing — Drawn, Not Described

Most envelope failures I investigate occur at transitions: windowsills and heads, base of wall, roof-to- wall intersections, deck ledgers, and penetrations. Those are exactly the locations where written instructions are weakest. “Integrate flashing with the WRB” can be built several ways, and only some of them shed water. A specification-ready scope includes repair details for each recurring condition, showing layer sequence, laps, end dams, back dams, and the tie-in to existing materials that will remain. Each keyed repair references its detail by number.

Figure 3. A schematic sill repair detail (not for construction). Each numbered note answers a question a narrative scope would leave open. Details must reflect the actual assembly found during investigation and the installation requirements of the products specified. A generic detail copied from another project can create a new problem at the tie-in to existing materials.

Element 3: Specifications Organized the Way Contractors Price Work

I organize repair specifications using CSI MasterFormat section numbers, because that is how contractors, estimators, and many owners already think about work. A window reflash scope might reference sections such as 06 16 00 (Sheathing), 07 25 00 (Weather Barriers), 07 62 00 (Sheet Metal Flashing and Trim), and 07 92 00 (Joint Sealants), with Division 01 sections covering quality control, allowances, and unit prices. Specifications state what the details cannot show: acceptable products or performance criteria, substrate preparation, compatibility requirements, weather limitations, submittals, and the manufacturer instructions that govern installation. When substitutions are allowed, the specification says how they are submitted and evaluated.

Element 4: Quantities, Allowances, and Unit Prices

Hidden conditions are the most common source of dispute in envelope repair. Destructive testing tells us a great deal, but it does not reveal every square foot of wet sheathing behind intact cladding. Pretending otherwise invites conflict. Instead, I document measured quantities for what can be verified, and I set out transparent mechanisms for what cannot:

• Unit prices for recurring unknowns, such as additional sheathing replacement per square foot.
• Defined limits of removal on the elevation, so everyone knows where the base scope ends.
• Documentation requirements before concealment: photographs keyed to the repair ID and consultant or owner review before additional work is covered.

This does not eliminate hidden-condition costs. It makes them predictable, documented, and easier for an insurer or owner to evaluate on their merits. Figure 4. The eight fields I expect in every repair line item.

Element 5: Verification Before the Cladding Goes Back On

A scope that ends at “install new flashing” has no defined finish line. I build inspection hold points into the documents: typically after removal and before sheathing replacement, after WRB and flashing installation and before cladding, and at substantial completion. Where water testing is appropriate, the scope names the procedure and acceptance criteria in advance. Depending on the assembly and the question being answered, that may mean referencing guidance such as ASTM E2128 for evaluating water leakage of building walls, ASTM E1105 or AAMA 502 for field testing of installed fenestration, or a project-specific protocol. Choosing the right test, and the right pressure and duration, is an engineering judgment that belongs in the scope, not in a field argument.

A Composite Example

The following is a composite example drawn from common conditions, not a description of any specific project or client. Picture a three-story wood-framed building with stained interior drywall below several second-floor windows and efflorescence at the base of the north wall. Investigation, including infrared screening, moisture readings, and targeted openings, finds missing sill pans at two windows, a failed head flashing at a third-floor window, and a reversed WRB lap at the weep screed. The resulting scope schedule is short, and every line can be priced:

ID Location Action Detail / Spec Qty / Verify R-03 North Elev., Grid A–C, L1 Remove bottom course 1/A-502; 07 25 00 42 LF; hold base of wall cladding; replace weep screed; point before correct WRB lap at screed cladding R-07 North Elev., Grid B–C, Remove cladding/WRB to limits; 3/A-501; 06 16 38 SF sheathing L2, window W2-02 replace sheathing; install sill 00, 07 25 00, 07 (field-verify); 1 pan; reintegrate WRB 62 00 EA pan; water test R-08 North Elev., Grid C–D, Same as R-07 3/A-501; same as Sheathing by L2, window W2-03 R-07 unit price; 1 EA pan; water test R-11 North Elev., Grid D–E, Remove cladding at head; install 4/A-501; 07 62 1 EA; hold point L3, window W3-04 head flashing with end dams; 00, 07 92 00 before cladding reintegrate WRB UP-1 All zones Unit price: additional sheathing 01 22 00 Per SF, photo- beyond measured quantity, documented when documented and approved before cover Table 1. Excerpt from a composite repair schedule. Every line ties to a location, a detail, a specification section, and a verification step. Compare that with “repair north elevation water intrusion as needed.” Both describe the same building. Only one can be bid consistently by multiple contractors and reviewed by an adjuster line by line.

Who Benefits, and How

• Contractors price defined work rather than risk. Clearer scopes generally mean tighter bid spreads and fewer disputes once walls are open.
• Insurers and adjusters can evaluate each item against the documented cause and the policy terms. Coverage decisions remain the carrier’s to make; good documentation simply makes the basis for them clear.
• Owners and associations can compare bids on equal terms and know what they are paying for.
• Attorneys get a scope that ties investigation findings to repair costs through a traceable record, which matters when the scope itself is scrutinized.

Figure 5. The workflow behind a specification-ready scope.

Common Mistakes I See

• “As needed” and “where required” language without a defined decision-maker or limit.
• Symptom-based scopes that repair the stain but not the water path that caused it.
• Details that ignore existing conditions, especially the tie-in between new WRB and old WRB.
• No plan for hidden conditions, which turns every discovery into a negotiation.
• No verification requirement, leaving “complete” undefined.

Frequently Asked Questions

What is a specification-ready repair scope?

It is a repair document in which every item is keyed to a specific location on a building elevation, referenced to a drawn detail and a specification section, quantified, and paired with a verification step, so it can be bid and reviewed without interpretation.

What does “elevation-keyed” mean in building envelope repair?

It means each repair is located using a grid on the building elevation, the floor level, and the tag of the opening or component involved, with a unique repair ID that follows the item through bidding, construction, and close-out.

Does a detailed scope guarantee insurance approval?

No. Approval depends on policy language, cause of loss, and the carrier’s evaluation. A specification- ready scope makes the relationship between cause, damage, and repair cost clear and reviewable, which supports a better-informed decision.

How are hidden conditions handled?

Through defined limits of removal, unit prices for recurring unknowns, and documentation and review requirements before any additional work is concealed.

Who should prepare the scope?

Ideally, the professional who investigated the cause, working with a cost estimator and, where structural elements are involved, a licensed engineer. Separating diagnosis from scope preparation is a frequent source of gaps.

Closing Thought

A good repair scope is quiet. Contractors bid it without a string of RFIs, adjusters review it without calling for clarification, and the finished work can be checked against it line by line. That outcome is not luck. It is the product of an investigation that finds the water path and documentation that leaves little to interpret. If you are an owner, association, insurer, attorney, or contractor facing an envelope repair and would like to discuss scope development or repair verification oversight, you can reach Construction Science Forensics at csforensics.ai or (503) 313-5961.