# AI Lead Qualification — Score Semantics & Schema

**Document Version:** 1.0.0 (Phase 12)

---

## 1. Score Categories & Semantics

The AI lead score (0–100) measures **estimated commercial purchase intent** based on information supplied in the inbound enquiry.

| Score Range | Category | Temperature | Meaning |
|:---:|:---:|:---:|---|
| **85–100** | Hot | `HOT` | Explicit requirement, stated budget, defined timeline, or urgent quote request. |
| **70–84** | Warm / High | `WARM` | Clear commercial requirement; missing budget or immediate timeline. |
| **40–69** | Medium | `WARM` | General service inquiry or preliminary research. |
| **0–39** | Low | `COLD` | Generic curiosity, pricing tire-kicker, spam, or student research. |

> **Important:** The score does *not* indicate guaranteed deal closure, creditworthiness, or legal eligibility.

---

## 2. Structured Output Schema

The AI engine must output strict JSON adhering to:

```json
{
  "score": 86,
  "temperature": "HOT",
  "intent": "High Purchase Intent - Enterprise Software",
  "urgency": "TODAY",
  "confidence": "HIGH",
  "fit_summary": "Prospect is requesting immediate proposal with $25k budget.",
  "reason": "Clear commercial requirement with stated budget and explicit timeline.",
  "recommended_action": "Contact within 15 minutes to schedule technical demo.",
  "positive_signals": [
    "Budget stated ($25,000)",
    "Timeline specified (Q3 rollout)",
    "Decision maker identified"
  ],
  "risk_signals": [
    "Competitor evaluation mentioned"
  ]
}
```

---

## 3. Urgency Definitions

| Urgency | SLA Guidance |
|---------|-------------|
| `IMMEDIATE` | Contact within 15–30 minutes |
| `TODAY` | Respond before end of business day |
| `THIS_WEEK` | Schedule discovery within 3–5 business days |
| `LOW` | Standard automated nurture |