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