docs: finalise Circuit Forge product suite naming + product brief

This commit is contained in:
pyr0ball 2026-02-25 14:16:56 -08:00
parent f5dd49666c
commit 1d61683c5b
2 changed files with 115 additions and 2 deletions

View file

@ -71,9 +71,15 @@ Each product ships as a **separate app** sharing the same underlying scaffold (p
- **Harrier** — Insurance navigation. Prior authorization tracking, claim dispute drafting, EOB reconciliation, appeal letters. High willingness-to-pay: a denied $50k claim is worth paying to fight.
- **Merlin** — Rental / housing applications. Monitors listings, auto-applies to matching properties, generates cover letters for competitive rental markets (NYC, SF), tracks responses, flags lease red flags.
- **Merlin** — Rental / housing applications. Monitors listings, auto-applies to matching properties, generates cover letters for competitive rental markets, tracks responses, flags lease red flags.
- **Hobby** — Healthcare scheduling & coordination. Referral tracking, specialist waitlist monitoring, prescription renewal reminders, medical record request management.
- **Ibis** — Healthcare coordination. The sacred ibis was the symbol of Thoth, Egyptian god of medicine — the name carries genuine medical heritage. Referral tracking, specialist waitlist monitoring, prescription renewal reminders, medical record request management, prior auth paper trails.
- **Tern** — Travel planning. The Arctic tern makes the longest migration of any animal (44,000 miles/year, pole to pole) — the ultimate traveler. Flight/hotel monitoring, itinerary generation, visa requirement research, travel insurance comparison, rebooking assistance on disruption.
- **Wren** — Contractor engagement. Wrens are legendary nest-builders — meticulous, structural, persistent. Contractor discovery, quote comparison, scope-of-work generation, milestone tracking, dispute documentation, lien waiver management.
- **Martin** — Car / home maintenance. The house martin nests on the exterior of buildings and returns to the same site every year to maintain it — almost too on-the-nose. Service scheduling, maintenance history tracking, recall monitoring, warranty tracking, finding trusted local providers.
### Shared architecture decisions

107
docs/product-brief.md Normal file
View file

@ -0,0 +1,107 @@
# Circuit Forge LLC — Product Brief
**Tagline:** AI for the tasks you hate most.
**Company:** Circuit Forge LLC
**Status:** Proof-of-concept (Peregrine) in active development. All other products deferred until Peregrine proves the model.
---
## The Idea
There is a category of task that is:
- **High-stakes** — getting it wrong has real consequences (denied claim, missed appointment, bad lease)
- **Opaque** — the rules are unclear, the process is inconsistent, the UI is hostile
- **Time-consuming** — hours of hold music, form-filling, or inbox-watching
- **Repeated** — you'll face this again, and so will everyone you know
These tasks are not hard because they require intelligence. They are hard because they are designed — intentionally or by neglect — to exhaust the person trying to complete them. Bureaucratic friction as a feature.
The Circuit Forge model: AI handles the research, drafting, monitoring, and preparation. A human reviews and approves before anything is submitted or committed. For the hardest cases (CAPTCHAs, phone calls, wet signatures), an operator steps in under the Ultra tier.
---
## Architecture
Every Circuit Forge product shares the same underlying scaffold:
```
Monitor / Discover → AI Assist → Human Approval → Execute → Track
```
Implemented as:
- **Pipeline engine** — SQLite staging DB, status machine, background task runner
- **LLM router** — fallback chain across local (Ollama/vLLM) and cloud (Anthropic/OpenAI-compat) backends
- **Wizard** — 7-step first-run onboarding, tier-gated features, crash recovery
- **Integrations** — pluggable connectors (calendar, storage, notifications)
- **Operator interface** — thin admin UI for Ultra tier human-in-the-loop execution
Products are **separate apps** sharing a private `circuitforge-core` package (extracted when the second product begins). Each ships as a Docker Compose stack.
---
## Product Suite
| Product | Domain | Key pain | Status |
|---------|--------|----------|--------|
| **Peregrine** | Job search | Applications, cover letters, interview prep | Active development |
| **Falcon** | Government forms | Benefits, immigration, permits, FAFSA | Backlog |
| **Osprey** | Customer service | IVR queues, complaint letters, dispute tracking | Backlog |
| **Kestrel** | Gov't appointments | DMV, passport, USCIS slot monitoring | Backlog |
| **Harrier** | Insurance | Prior auth, claim disputes, appeals | Backlog |
| **Merlin** | Rentals | Listing monitor, applications, lease review | Backlog |
| **Ibis** | Healthcare | Referrals, waitlists, records, prior auth | Backlog |
| **Tern** | Travel | Flights, itineraries, visas, disruption | Backlog |
| **Wren** | Contractors | Quotes, scope of work, milestones, disputes | Backlog |
| **Martin** | Home / car | Maintenance, scheduling, warranties, recalls | Backlog |
---
## Tiers (across all products)
| Tier | What you get |
|------|-------------|
| **Free** | Core pipeline, basic AI assist, local LLM only |
| **Paid** | Cloud LLM, integrations, email sync, full AI generation suite |
| **Premium** | Fine-tuned models, multi-user, advanced analytics |
| **Ultra** | Human-in-the-loop execution — operator handles what AI can't |
---
## Ultra Tier — Human-in-the-Loop
The hardest tasks can't be fully automated: CAPTCHAs, phone calls, wet signatures, in-person appearances. The Ultra tier provides a trained human operator who:
1. Receives a queued task with all AI-generated context (brief, filled form, talking points)
2. Executes the task (submits the form, makes the call, books the appointment)
3. Marks it complete with an audit trail
The user must explicitly approve each task before the operator acts. Pricing is per-task or bundled, not flat-rate — complexity varies too much.
**Bootstrap strategy:** Waitlist + small trusted operator team to validate the workflow manually before investing in operator tooling. The browser autofill extension (in development for Peregrine) becomes the operator's primary tool across all products.
---
## Naming
All products are named after birds. The names were chosen for:
- **Peregrine** — the peregrine falcon: fastest animal on earth, precise hunter
- **Falcon** — strength, directness, cutting through bureaucracy
- **Osprey** — patient, circles overhead, dives with precision when ready
- **Kestrel** — hovers perfectly still before striking (waiting for the appointment slot)
- **Harrier** — low, fast, persistent — the insurance fight you don't give up on
- **Merlin** — small but fierce; also evokes the wizard (documents, magic)
- **Ibis** — sacred to Thoth, Egyptian god of medicine and healing
- **Tern** — Arctic tern: the world's greatest traveler, pole to pole every year
- **Wren** — legendary nest-builder, meticulous and structural
- **Martin** — house martin: nests on buildings, returns every year to maintain them
---
## What to build next
1. Prove Peregrine: paying users, validated LTV, operator workflow tested
2. Extract `circuitforge-core` when starting the second product
3. Second product TBD based on Peregrine user feedback — likely **Falcon** (government forms) or **Osprey** (customer service) given overlap in skill set and user base