Wren — Contractor Engagement

Part of the Circuit Forge LLC "AI for the tasks you hate most" suite.

Status: Backlog — not yet started. Peregrine must prove the model first.

What it does

Wren manages the full contractor relationship lifecycle: discovery and vetting, quote requests, scope-of-work generation, milestone tracking, dispute documentation, and lien waiver management.

Wrens are legendary nest-builders — meticulous, structural, and persistent. They build complex, intricately woven nests. The metaphor writes itself.

Why it's hard

Hiring contractors is painful because:

Vetting is opaque: reviews are gamed, licensing is hard to verify, references are curated
Scope of work is undefined: vague quotes lead to scope creep and disputes
Payment milestones are rarely tracked rigorously — disputes arise at completion
Lien waivers are legally important but rarely requested by homeowners

Core pipeline

Describe project → AI generates scope of work (SOW) draft
→ Discover contractors (Angi, Yelp, local boards) → Request quotes
→ Human review + select → Track milestones + payment schedule
→ On dispute: document timeline + generate demand letter
→ Lien waiver generation on final payment

Key differentiators vs. Peregrine

SOW generation: structured project description → legal-quality scope document
Quote comparison: normalize across different contractor pricing formats
Milestone tracker: payment tied to completion criteria, not just dates
Dispute documentation: timestamped photo logs, communication thread export

Product code (license key)

CFG-WREN-XXXX-XXXX-XXXX

Tech notes

Shared circuitforge-core scaffold
Contractor discovery: Angi, HomeAdvisor, Yelp, Thumbtack scrape + APIs
License verification: state contractor licensing board APIs (varies by state)
SOW template library: kitchen, bathroom, roofing, HVAC, electrical, plumbing
Vision module: photo documentation of work-in-progress milestones

2 KiB Raw Blame History