From 37ce9fb1f89dc18a8d04e9843cb4a06163f3dc3d Mon Sep 17 00:00:00 2001 From: pyr0ball Date: Wed, 25 Feb 2026 14:16:56 -0800 Subject: [PATCH] docs: finalise Circuit Forge product suite naming + product brief --- docs/backlog.md | 10 +++- docs/product-brief.md | 107 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 115 insertions(+), 2 deletions(-) create mode 100644 docs/product-brief.md diff --git a/docs/backlog.md b/docs/backlog.md index ca1f03b..dd870ae 100644 --- a/docs/backlog.md +++ b/docs/backlog.md @@ -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 diff --git a/docs/product-brief.md b/docs/product-brief.md new file mode 100644 index 0000000..89d2f85 --- /dev/null +++ b/docs/product-brief.md @@ -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