# 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