From cec195358198abf7abf2216714936ecdff3ac0bf Mon Sep 17 00:00:00 2001
From: pyr0ball <pyroballpcs@gmail.com>
Date: Mon, 11 May 2026 06:22:32 -0700
Subject: [PATCH] docs: initial product stub

---
 PRIVACY.md |  7 +++++++
 README.md  | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 PRIVACY.md
 create mode 100644 README.md

diff --git a/PRIVACY.md b/PRIVACY.md
new file mode 100644
index 0000000..afc7b9f
--- /dev/null
+++ b/PRIVACY.md
@@ -0,0 +1,7 @@
+# Privacy Policy
+
+CircuitForge LLC's privacy policy applies to this product and is published at:
+
+**<https://circuitforge.tech/privacy>**
+
+Last reviewed: March 2026.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3fda559
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# 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