# LeadPilot — AI Intelligence & Qualification UX Architecture

**Document Version:** 1.0.0 (Phase 3 UX Architecture Lock)  
**Status:** Approved & Formally Recorded  
**Philosophy:** AI as Transparent Decision Support (Not Autonomous Autopilot)  

---

## 1. AI Decision-Support Presentation

```
+---------------------------------------------------------------------------------------------------------------+
| AI LEAD ASSESSMENT                                                     Model: GPT-4o-mini • Scored 2 min ago  |
+---------------------------------------------------------------------------------------------------------------+
|                                                                                                               |
|  [ 92 / 100 ]     [ HOT TEMPERATURE ]     [ HIGH URGENCY ]     [ BUDGET DETECTED: $10k - $15k ]               |
|                                                                                                               |
|  DETECTED INTENT                                                                                              |
|  Custom E-Commerce Portal Development with immediate Q3 launch timeline.                                      |
|                                                                                                               |
|  SCORE RATIONALE & SIGNALS                                                                                    |
|  * Explicit budget range provided ($12,000 matches workspace target).                                         |
|  * Verified corporate email domain (`apexstudio.in`).                                                         |
|  * High urgency signals detected ("need to launch next month").                                               |
|                                                                                                               |
|  RECOMMENDED NEXT ACTION                                                                                      |
|  "Dispatch Custom Agency Proposal Intro template and request a 15-minute discovery call."                     |
|                                                                                                               |
|  [ 1-Click: Send Recommended Proposal Intro ]               [ Re-run AI Assessment ]                         |
+---------------------------------------------------------------------------------------------------------------+
```

---

## 2. Graceful Failure & Heuristic Fallback UX

If the AI provider is offline, rate-limited, or times out, the system scores the lead using deterministic keyword rules. The UI displays an honest, non-alarming badge:

```
+---------------------------------------------------------------------------------------------------------------+
| AI LEAD ASSESSMENT                                                [ Heuristic Fallback Active ]  [ Retry AI ] |
+---------------------------------------------------------------------------------------------------------------+
|  [ 70 / 100 ]     [ WARM TEMPERATURE ]     [ MEDIUM URGENCY ]                                                 |
|                                                                                                               |
|  Scored via deterministic keyword rules (AI provider temporarily busy). High budget keyword detected.        |
|  [ Send Intro Template ]                                                                                      |
+---------------------------------------------------------------------------------------------------------------+
```