Predictika · Building products

An AI sales agent's board and batten siding order, checked before it goes out

An AI sales agent prepares an order and installation plan for a contractor: LP SmartSide 38 Series vertical siding with battens, the sheathing and water-resistive barrier behind it, the fasteners and their spacing, the batten size and nailing, and the joints at floors and masonry. Before the order goes out, the agent sends it to Predictika, which checks it against a declarative model of LP's published technical note and returns a verdict, every reason and the nail total it computed.

Scope: LP SmartSide 38 Series strand substrate vertical siding in board and batten applications (LP Technical Note 028): sheathing, barrier, fasteners, spacing, battens and joints. See everything this validator covers

This validator models board and batten orders for LP SmartSide 38 Series vertical siding, not just the scenarios shown below.

  • Substrate and barrier — wood structural panel sheathing of at least 7/16 category (or LP FlameBlock fire-rated OSB) and a water-resistive barrier behind the siding.
  • Fasteners — hot-dip galvanized ring shank nails of at least 0.092 inch shank, penetration of at least 1/4 inch, placement within 3/8 inch of ends and edges, siding nails at most 6 inches on centre.
  • Battens — minimum 1.5 by 0.5 inch actual size; nails at both ends (two per end for battens 2.5 inches or wider, one per end for narrower ones) and spacing of at most 12 or 24 inches; the nail total at batten ends is computed and compared with the figure the order states.
  • Joints — a 3/16 inch gap between siding boards, a 3/8 inch gap to stucco, brick or cultured stone, and sloped metal Z-flashing with a 3/8 inch space between floors, with no siding or battens bridging floors.
  • Approvals — trim nails on battens and battens narrower than 2.5 inches go to a person, because the note ties them to warranty cautions.

Any board and batten order for this siding is in scope — not only the scenarios pictured here. Not covered: prices (LP does not publish them), other LP siding products and the accessory, trim and lap siding instructions, local building codes, the batten nail pattern beyond the end nails, and the warranty itself. The model reflects Technical Note 028 as last revised on May 13, 2022; always use LP's current instructions.

The AI sales agentBuilds the siding and batten order and installation plan from the conversation and says it is ready.
Predictika validatorChecks every rule at once and returns the verdict, each finding, and the computed figures.

6 scenarios in 3 groups · each group runs from the agent’s first attempt to the outcome · click one to switch

What the agent proposes

The AI sales agent says

Illustrative agent statement. The validator receives the structured request below.

Proposing agent: AI sales agent (scripted)

Before sending, the agent must call Recorded run

Predictika validator


      
Waiting for the call.

Where rules-based CPQ gets it wrong

Click to expand

Our assessment of what a typical rules-based CPQ (product rules, price rules and validation rules, as in Salesforce CPQ) does with the same cases. It is a judgment about effort and reliability, not a claim that nothing can be built.

What the validator caughtTypical rules-based CPQPredictika
Minimums and maximums from the installation note (nail spacing, gaps, penetration)Only with care
Each limit is a product or validation rule, written and kept up to date by hand; a limit nobody wrote down is easy to let through.
Each limit is part of the model and every one is checked on every call.
Batten rules that change with batten widthOnly with care
The end-nail count and the spacing limit both depend on whether the batten is under 2.5 inches wide, so a rule is needed for each branch.
The requirement is derived from the batten width and compared with the plan.
Nail total at batten ends reconciled with the figure the order statesOnly with workarounds
A rules engine does not usually recompute a total from the plan and compare it with what the document says.
The total is computed from the plan and compared with the stated figure on every call.
Warranty cautions to be confirmed by a person (not blocked)Only with workarounds
A rules engine either allows or blocks; it has no way to say a person should confirm.
The case goes to a person with the reason, and is not guessed.
Every problem returned in one answerOnly with workarounds
Rules tend to fire as a step is completed, so a person often fixes one error and meets the next.
All findings come back together, whatever order the choices arrived in.

What this validator catches: findings from its test cases

Click to expand

Every rule is checked on every call, in any order the choices arrive; one problem never hides another. Blocking findings stop the quote; approval findings need a person to sign off; everything else is computed.

1The order states 120 nails at batten ends; the plan gives 160.
2The siding must be installed over wood structural panels of at least 7/16 category with an APA trademark (DOC PS 1 or PS 2), or LP FlameBlock fire-rated OSB sheathing.
3LP SmartSide vertical siding shall not be installed horizontally.
4Vertical siding or battens may span only one floor to ceiling or one floor to top of gable; do not bridge floors.
5A properly installed water-resistive barrier is required behind the siding.
6Fasteners must be hot-dip galvanized (ASTM A153) or equivalent corrosion resistant.
7The siding must be fastened with ring shank nails.
8The nail shank diameter is 91 thousandths of an inch; the minimum is 92 (0.092 inch).
9The siding nail penetrates the sheathing by 5 mm; it must penetrate wood structural panel sheathing by at least 6 mm (1/4 inch).
10The batten nail penetrates the siding by 5 mm; it must penetrate the vertical siding by at least 6 mm (1/4 inch).
11Siding nails are spaced 7 inches on centre along the perimeter; the maximum is 6 inches.
12Siding nails are placed 11 mm from ends and edges; the maximum is 10 mm (3/8 inch).
13Batten nails are placed 11 mm from ends and edges; the maximum is 10 mm (3/8 inch).
14The gap between vertical siding boards is 4 mm; the minimum is 5 mm (3/16 inch).
15The batten is 37 mm wide and 13 mm thick; the minimum is 38 mm (1.5 inch) wide by 13 mm (0.5 inch) thick, actual size.
16A batten narrower than 64 mm (2.5 inch) may not conceal the nail heads on the vertical siding, and visible nail heads are not covered by the LP warranty; a person should confirm.
17The batten is 64 mm wide and 12 mm thick; the minimum is 38 mm (1.5 inch) wide by 13 mm (0.5 inch) thick, actual size.
181 nails are planned at each end of a batten; this batten width needs at least 2.
19Batten nails are spaced 13 inches on centre along alternating edges; the maximum for this batten width is 12.
20Batten nails are spaced 25 inches on centre along alternating edges; the maximum for this batten width is 24.
21Trim nails are used to fasten the battens; LP says ring shank nails should be used where negative wind loads are a concern, and detachment of battens is not covered by the limited warranty, so a person should confirm.
22The siding is 9 mm from adjacent stucco, brick or cultured stone; the minimum is 10 mm (3/8 inch), sealed with sealant.
23A multi-story wall needs a horizontal joint between floors flashed with sloped metal Z-flashing.
24The space at the Z-flashing is 9 mm; the minimum is 10 mm (3/8 inch).
25Siding nails are spaced 8 inches on centre along the perimeter; the maximum is 6 inches.
26The order states 100 nails at batten ends; the plan gives 80.

Scenarios and results

Click to expand

The recorded result of the validator for each scenario on this page: the request the AI agent sent, the verdict, and every finding, in the order they appear above.

1. Nail spacing: Siding nails 8 inches apart and batten nails 14 inches apart

The agent's request. Please check a board and batten order for Hollis Ridge Builders: 48 battens, 2 nails at each end of each batten, siding nails every 8 inches and batten nails every 14 inches, a one-story wall. The order states 192 nails at batten ends in total. It is ready to send.

Verdict: Blocked.

  • Siding nails spaced too far apart. Siding nails are spaced 8 inches on centre along the perimeter; the maximum is 6 inches.
  • Batten nails spaced too far apart. Batten nails are spaced 14 inches on centre along alternating edges; the maximum for this batten width is 12.

2. Nail spacing: The agent resubmits after fixing the errors

The agent's request. Please check a board and batten order for Hollis Ridge Builders: 48 battens, 2 nails at each end of each batten, siding nails every 6 inches and batten nails every 12 inches, a one-story wall. The order states 192 nails at batten ends in total. It is ready to send.

Verdict: Allowed.

  • Order summary. 48 battens, 2 nails at each end, 192 nails at batten ends in total.

3. Substrate and barrier: Siding over unrated sheathing with no water-resistive barrier

The agent's request. Please check a board and batten order for Hollis Ridge Builders: 60 battens, 2 nails at each end of each batten, siding nails every 6 inches and batten nails every 12 inches, a one-story wall. The order states 240 nails at batten ends in total. The sheathing is not 7/16 category panels and the water-resistive barrier is not included. It is ready to send.

Verdict: Blocked.

  • Sheathing is not 7/16 category WSP. The siding must be installed over wood structural panels of at least 7/16 category with an APA trademark (DOC PS 1 or PS 2), or LP FlameBlock fire-rated OSB sheathing.
  • No water-resistive barrier. A properly installed water-resistive barrier is required behind the siding.

4. Substrate and barrier: The agent resubmits after fixing the errors

The agent's request. Please check a board and batten order for Hollis Ridge Builders: 60 battens, 2 nails at each end of each batten, siding nails every 6 inches and batten nails every 12 inches, a one-story wall. The order states 240 nails at batten ends in total. It is ready to send.

Verdict: Allowed.

  • Order summary. 60 battens, 2 nails at each end, 240 nails at batten ends in total.

5. Floor and masonry joints: Two-story wall with no Z-flashing and a 6 mm gap to masonry

The agent's request. Please check a board and batten order for Hollis Ridge Builders: 36 battens, 2 nails at each end of each batten, siding nails every 6 inches and batten nails every 12 inches, a 2-story wall with no Z-flashing between floors, siding 6 mm from adjacent masonry. The order states 144 nails at batten ends in total. It is ready to send.

Verdict: Blocked.

  • Gap to masonry or veneer too small. The siding is 6 mm from adjacent stucco, brick or cultured stone; the minimum is 10 mm (3/8 inch), sealed with sealant.
  • No Z-flashing at the floor joint. A multi-story wall needs a horizontal joint between floors flashed with sloped metal Z-flashing.

6. Floor and masonry joints: The agent resubmits after fixing the errors

The agent's request. Please check a board and batten order for Hollis Ridge Builders: 36 battens, 2 nails at each end of each batten, siding nails every 6 inches and batten nails every 12 inches, a 2-story wall with Z-flashing, siding 10 mm from adjacent masonry. The order states 144 nails at batten ends in total. It is ready to send.

Verdict: Allowed.

  • Order summary. 36 battens, 2 nails at each end, 144 nails at batten ends in total.

Narration transcript

Click to expand

The text of the narrated walkthrough, step by step.

  1. Welcome to a demo of Predictika's Validator. An AI sales agent prepares an order and installation plan for a contractor: LP SmartSide 38 Series vertical siding with battens, the sheathing and water-resistive barrier behind it, the fasteners and their spacing, and more. Before the order goes out, the agent sends it to Predictika, which checks it against a declarative model of LP's published technical note and returns a verdict, every reason and the nail total it computed.
  2. I will start with the first request by the agent.
  3. The agent says. Please check a board and batten order for Hollis Ridge Builders: 48 battens, 2 nails at each end of each batten. The order states 192 nails at batten ends in total. The rest of the request is on screen.
  4. Before it goes out, the agent calls the validator.
  5. Blocked, with two findings, all in one answer. Siding nails are spaced 8 inches on centre along the perimeter; the maximum is 6 inches. Batten nails are spaced 14 inches on centre along alternating edges; the maximum for this batten width is 12.
  6. The validator returned two blocking findings in one answer. A check that reads one field at a time would pass most of this; it shows only when the choices in the quote are checked against each other.
  7. What this shows: for nail total at batten ends reconciled with the figure the order states, a rules-based CPQ can do this only with workarounds.
  8. Now the agent resubmits.
  9. The corrected request. It changes the siding nail spacing to 6 in and the batten nail spacing to 12 in.
  10. It calls the validator again.
  11. This time the validator clears it.
  12. Both earlier findings are cleared.
  13. Two problems caught in one call, fixed in one pass, and a clean quote. That is the value of Predictika's validator: catching mistakes before they reach the customer.