Engineering Architecture Walkthrough
Soma AI Onboarding Redesign
Launch Full 4-Stage Simulator

Brand Information → AEO Topics → Buyer Prompts

An interactive engineering demonstration for Project Management detailing how raw domain information is ingested, enriched with Cloro AI, transformed into institutional AEO topic clusters, and synthesized into conversational buyer queries with a strict 40/30/30 intent distribution.

Quick Presets:

The 4 Sequential Architecture Stages

Click any stage to inspect the engineer's thinking, data contracts, and live telemetry.

Zero-Downtime Fallbacks Active
01

Brand Information Fetch & AI Extraction

POST /api/v1/onboarding/lookup
The Problem in Legacy Flow

Legacy onboarding forced users to manually type their industry, ICP personas, and competitors. This caused massive drop-offs, user frustration, and incomplete brand context.

Uriah's Architectural Solution

Implemented an automated phased lookup pipeline: DNS resolution -> Brandfetch visual asset extraction -> Cloro AI deduction pass. Cloro deduces the Ideal Customer Profile (ICP) constrained to under 120 characters and infers 2-4 direct competitors. Deterministic heuristic fallbacks guarantee 100% uptime if external APIs time out.

Key Design Decisions & Invariants:
  • ICP constrained to <120 chars: Keeps the persona dense and prevents prompt dilution in downstream models.
  • Direct Competitor Inference: Identifies 2-4 direct rivals automatically to seed competitive search queries.
  • 3-Tab Brand Context Editor: Splits inputs into Brand & Offerings, Target Markets, and Competitor Pills with batch comma entry.
  • Auto-Tab Error Focus: If validation fails, UI automatically jumps to the invalid tab so users never get stuck.
  • Deterministic Fallbacks: In-memory heuristics infer defaults from domain name and TLD if Brandfetch or Cloro is unavailable.
Output feeds directly into Step 2 topic generation.Experience in Full Wizard

Live Sandbox & API Inspector

Target: linear.app
li
LINEAR
linear.app
Inferred Ideal Customer Profile (ICP <120 chars):

Engineering squads, technical PMs, and product development leaders.

Inferred Competitors:
Jira
Asana
ClickUp
Linear
HTTP 200 OK
Contract Verified