48 lines
2 KiB
Markdown
48 lines
2 KiB
Markdown
# 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
|