Estimating Rules (codified)
These are the rules the estimate generator follows. Every one of them is enforced in
engine/replicate.py; the rule number (R1, R2, …) appears in the evidence text on each
estimate line so a reviewer can trace why a line looks the way it does.
0. The one rule above all others
Never write a number without proof. Every price, labor hour, paint hour and part
number on an estimate comes from one of three places, in this order:
- a comparable archived estimate (same make, model, body style, generation);
- a CCC line the estimator typed in (part #, price, labor/paint);
- an OEM catalog lookup whose MSRP equals the CCC price (small parts only — hoods, roofs and other big panels must come from CCC).
If none of those exist the generator stops and lists exactly what it needs, in plain
words. It never fills a gap with a guess, an average from a different vehicle, or a
placeholder on a sent estimate.
1. Scope-sheet shorthand (what the estimator writes per panel)
| Written | Meaning |
24N, 105Q, 23D, 8H | dent count + size: N nickel, Q quarter, D dime, H half-dollar |
6OS / 6 o.s. | oversize dents on that panel (priced each, R3) |
+25 or ALU | force the +25% aluminum / high-strength-steel markup |
REPL | replace the panel (needs an archived or supplied CCC line) |
CCC: PART# $PRICE LABOR/PAINT | the exact CCC replacement line, typed in |
14 hrs | conventional repair at those hours (R7); paint 3.2 adds CCC refinish hours |
@2500 | off-matrix PDR price, markup already inside; @1000 +25 = base, markup on top |
UPD | unrelated prior damage — noted on the line, not priced |
BAD PDR | poor prior repair — still PDR, noted on the line |
mirror R&I, belt molding REPL, headliner R&I, … | access / trim items (R&I hours from comparables, parts from CCC or catalog) |
Positions: LF / RF / LR / RR doors, L/R fender, L/R rail (aperture / roof rail /
uniside), L/R quarter (bedside on pickups), L/R cab corner, roof, hood, deck lid
(trunk / liftgate / tailgate).
2. Dent counts → price (R1, R2)
- Brackets: 1–5, 6–15, 16–30, 31–50, 51–75, 76–100, 101–150, 151–200, 201–250, 251–300, 301–350, 351–400, 401+.
- Bump rule (R2): scope counts miss 20–30 % of dents, so a count within 3 of the next bracket floor is written at that floor (28 → 31).
- Price per bracket/size comes first from the insurer hail price matrix (
engine/matrix.json, Progressive's schedule: dime/nickel/quarter/half by bracket for hood, roof, deck lid, fender, door, quarter, roof rail, cowl), cross-checked against the mode of archived PDR lines in the last ~270 days for that panel class (HOOD; SMALL: fenders/doors/deck lid; BIG: quarters and bedsides; RAIL: rails/apertures/cab corners; ROOF). Where the matrix and UHP's own recent estimates disagree, the review list says so. - Rail ladder: 31–50 nickel = $550 flat, markup included; 51–75 = $575 base; 76–100 = $775 base. Rails under 31 use the small-panel ladder with +25 % on top (6N → $187.50, 16N → $281.25). Cab corners fold into the rail on that side unless the rail converts to hours.
- A roof at 251–300 quarters should carry oversize dents (≈13+); if the sheet shows none the reviewer is told, never silently added.
3. Oversize (R3)
Accept-only pricing set by the insurer: $40 each for State Farm, American Family,
Travelers; $50 for everyone else (GEICO, Progressive, USAA, Allstate, Bristol West…).
Oversize is written exactly as scoped; the generator notes when the estimator usually
bumps it but never bumps on its own.
4. Markups (R4)
+25%= aluminum or HSS. Applied when (a) the sheet says+25/ALU, (b) the CCC wording carries(ALU)/(HSS)/(UHS), (c) the majority of comparables marked that panel up, or (d) the panel is on the known-aluminum table (Ram 1500 2019+ hood and tailgate; Ram 2500/3500 hood; F-150 2015+ and Super Duty 2017+ every panel; Ranger hood; Silverado/Sierra 1500 2019+ hood and tailgate). The table wins over an inconsistent archive.- The $550 rail bracket never takes a second markup.
5. Conversion repairs (R7)
Hours written on the sheet become a Rpr line at those hours. Refinish hours come from a
comparable repair of that panel on the same model, or from the CCC refinish figure typed
in (paint 3.2), together with the comparable's add-on pattern (Add for Clear Coat,
Overlap Major Adj.). No comparable and no CCC figure → stop.
6. Replacement panels (R5)
REPL needs ≥ 3 archived replacements of that panel on the same generation, or a typed
CCC line. Variant wording (w/ or w/o sunroof, cab style, model-year splits like
"to 04/25/2022") is chosen from the comparables by year/cab/sunroof; if the archive
can't decide, the options are listed and the generator stops. Archived part prices
older than ~90 days are flagged for a freshness check.
7. Access operations (R&I) voted from comparables
R&I lines (bumper, headlamps, hood, insulator, headliner, mirrors, liners, liftgate…)
are written when the majority of same-generation vehicles that had PDR on the touched
panel carried them, with the most common hours. Fallback chain when the generation is
thin: all generations of the model → same body style, any make → whole archive, each
step flagged in the review notes. A vehicle with one comparable never carries default
ops silently.
8. Standing lines (always written)
- Every vehicle: R&I tail lamps (both), R&I antenna, pre- and post-repair scans at the mechanical rate, Corrosion Protection.
- Every pickup: R&I both bed caps (CCC: "Side rail" / "Rail cover"), R&I tailgate, R&I back glass, R&I rear seat, R&I high mount stop lamp.
- Roof replacement only: R&I head air bags + air bag system diagnosis.
- A lamp written for replacement carries no R&I on that side; one mirror R&I per side.
- Hood/roof replacements carry the refinish add-ons UHP always writes (clear coat, underside, overlap) — two-stage unless the colour is a tri-coat.
- Write PDR, never "Sublet". Mechanical labor rate $155.
9. Part numbers and VIN-first
- Decode the VIN before asking anyone anything: trim, engine, drivetrain, body. Use it to pick between CCC option rows (trim codes, sunshade, power liftgate…).
- Part numbers with no archive precedent are looked up in an OEM catalog; the MSRP must equal the CCC price. A placeholder never ships.
- Subaru embeds the part number in the description — extracted automatically.
10. Taxes and locations
Colorado (Commerce City) 7.96 % on parts and paint supplies; Arizona (Phoenix) 8.6 %;
Kansas City taxes labor as well (separate profile). The location on the sheet picks the
letterhead and the tax rule.
11. Photo-only scoping (when there is no scope sheet)
Sort every photo to a side first. Hail almost always hits one side harder; the driver
and passenger sides are read separately and never mirrored. A count on a panel must trace
to photos of that panel, and oversize is written only where an oversize dent is actually
seen on that panel. The number of photos of a panel says nothing about its severity.
Photos capture roughly half the dents on a panel and shallow dents barely show. A
count read from photos is doubled on fenders, doors, quarters and liftgates (shows
8–11 → write 16–30) and roughly quadrupled on the big flat panels: a hood that shows
~20 is 76–100, a roof that looks "dense" is 201–250 with +25 % and oversize. A
photo-scoped estimate is always marked for review before it goes anywhere.
12. What the generator reports back
- STOP list — data it needs, in plain words, one line each.
- REVIEW list — judgment calls it made (markup applied, fallback pool used, OS as scoped, off-matrix price) so a reviewer can override.
- PROMISE CHECK — every item written on the sheet and what became of it, so nothing the estimator asked for is silently dropped.