Prompt Architecture & Code Compliance Methodology
A transparent explanation of how ScopeCrafters models trade terminology, verifies governing code references, enforces scope-gap protections, and acknowledges operating limitations.
1. Domain-Specific Prompt Engineering
Generic large language models are trained on general web prose, resulting in proposals that sound overly conversational, miss trade codes, or omit critical warranty conditions. ScopeCrafters solves this by routing inputs through curated, trade-isolated prompt matrices (HVAC, Roofing, Electrical, and Plumbing).
Engineering Principles Applied
- Strict JSON Schema Enforcement: Proposals must resolve into structured nodes (Scope, Materials, Labor/Permits, Terms, and Warranty) before rendering to PDF.
- Brand Preservation: The model cannot invent fictitious shingle lines, condenser models, or panel brands. Explicit inputs anchor the output.
- Mandatory Scope-Gap Clauses: Clauses for unapproved insurance supplements, rotted roof decking replacement allowances, and utility disconnect coordination are systematically injected.
2. Governing Code Standards Referenced
Every trade supported on the platform is benchmarked against current model building codes and regulatory standards:
HVAC Standards
DOE 2023 SEER2 efficiency guidelines, AHRI certified matchup requirements, EPA AIM Act A2L refrigerant transition (R-454B / R-32), and ACCA Manual J/D/S principles.
Roofing Standards
IRC Section R806 (roof ventilation ratios), ASTM D3462 fiberglass shingle specifications, and regional climate-zone ice and water shield mandates.
Electrical Standards
2023 National Electrical Code (NFPA 70), Article 210.12 (AFCI), Article 210.8 (GFCI), Article 625 (Level 2 EVSE continuous loads), and Article 230 service calculations.
Plumbing Standards
Uniform Plumbing Code (UPC) and International Plumbing Code (IPC), thermal expansion tank rules on closed systems, and TPR valve gravity drain piping.
True engineering credibility requires stating what the software does not do:
- •No Automated Municipal Permit Fee Calculation: Building permit fees vary across thousands of local AHJs (Authorities Having Jurisdiction). ScopeCrafters includes standard permit coordination language, but the contractor must input the specific municipality fee.
- •Material Price Fluctuations: ScopeCrafters does not sync with live distributor counter pricing. Material estimates are based on industry standard baselines; contractors retain 100% control to edit line items prior to sending.
- •On-Site Physical Inspection: Software cannot verify concealed structural deficiencies (such as rotted rafter tails or undersized service drops). ScopeCrafters protects against this by including mandatory inspection disclaimers.
Frequently Asked Questions
How does ScopeCrafters prevent AI hallucinations in trade proposals?▼
ScopeCrafters uses strict schema-constrained outputs combined with few-shot domain exemplars rather than free-form conversational prompting. If an input references specific manufacturer brands (such as GAF, Owens Corning, or Carrier), the model is explicitly constrained from substituting alternate or fictitious brand names.
How frequently are building code references updated?▼
Our trade research team reviews code cycles on a quarterly cadence. For example, during the 2025/2026 refrigerant transition, prompts were updated to account for EPA AIM Act rules regarding A2L refrigerants (R-454B and R-32) and the phaseout of R-410A systems.
What are the stated limitations of ScopeCrafters?▼
ScopeCrafters drafts scope narratives, warranty terms, and estimated line items, but does not query live distributor pricing or real-time city permit fee schedules. Contractors are expected to review labor rates, material totals, and local municipal amendments before sending.