From 492d3803e596afbe30c16ff94dfd608441d982ff Mon Sep 17 00:00:00 2001
From: pyr0ball <pyr0ball@noreply.opensourcesolarpunk.com>
Date: Fri, 27 Feb 2026 13:37:41 -0800
Subject: [PATCH] docs: initial product overview and flock table

---
 README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8209f1c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# Circuit-Forge — The Menagerie
+
+> *"AI for the tasks the system made hard on purpose."*
+
+**Privacy · Safety · Accessibility — co-equal, non-negotiable.**
+
+Circuit Forge LLC builds privacy-first, safety-first, accessible AI tools for high-stakes,
+opaque, and time-consuming tasks. **Neurodivergent and adaptive needs users are a primary audience.**
+
+All products follow the open-core model: MIT discovery/pipeline layers, BSL 1.1 AI features.
+
+---
+
+## The Flock
+
+| Product | Code | Status | Domain |
+|---------|------|--------|--------|
+| [Peregrine](https://git.opensourcesolarpunk.com/pyr0ball/peregrine) | PRNG | 🟡 Active Dev | Job search — discovery → cover letters → interviews |
+| Heimdall | — | 🔵 Design | License server (infrastructure) |
+| Falcon | FLCN | 💡 Concept | Government forms — benefits, FAFSA, immigration |
+| Osprey | OSPY | 💡 Concept | Customer service — IVR queues, complaint letters |
+| Kestrel | KSTR | 💡 Concept | Gov't appointments — DMV, passport, USCIS |
+| Harrier | HRRR | 💡 Concept | Insurance — prior auth, claim disputes, appeals |
+| Merlin | MRLN | 💡 Concept | Rentals — listings, applications, lease review |
+| Ibis | IBIS | 💡 Concept | Healthcare — referrals, waitlists, prior auth |
+| Tern | TERN | 💡 Concept | Travel — flights, visas, disruption rebooking |
+| Wren | WREN | 💡 Concept | Contractors — quotes, scope of work, disputes |
+| Flicker | FLKR | 💡 Concept | Home/car — maintenance, scheduling, warranties |
+| Egret | EGRT | 💡 Concept | Privacy rights — CCPA/GDPR/LGPD DSARs |
+| Swift | SWFT | 💡 Concept | Event tickets — queues, price tracking, FTC/DOJ |
+| Snipe | SNPE | 💡 Concept | Auction sniping — CT Bids, antiques, eBay |
+| Kiwi | KIWI | 💡 Concept | Pantry tracking + leftover recipe suggestions |
+| Bittern | BTRN | 💡 Concept | Workplace accommodations — ADA, retaliation docs |
+| Bunting | BNTG | 💡 Concept | IEP/504 plans — accommodations, dispute letters |
+
+---
+
+## Tracking
+
+Each product has a tracking issue in this repo.
+Use label filters to see by status (`status:*`) or priority (`priority:*`).
+
+Launch milestones mark the big public flag-plants.
+Business milestones (revenue targets, user counts) are issues within each launch milestone.
+
+---
+
+*Open-core: MIT (discovery pipeline) · BSL 1.1 (AI features, converts to MIT after 4 years)*