{
  "name": "The AIR Diagnostic",
  "version": "1.1.0",
  "updated": "2026-11-18",
  "about": "The one home for the AIR self-check's stages, problems, questions, scores and rules, and for what each stage looks like when it's stuck and one thing to try this week. The web self-check at deliberateinc.com/diagnostic.html and the downloadable kit both read this file. Code applies these rules; no model decides a status.",
  "framework": "https://deliberatework.com/blog/aaaerrr-complete-framework.html",
  "stages": [
    { "id": "awareness", "name": "Awareness", "question": "Do the people you want to reach know you exist?",
      "looksLike": "few people outside your customers know you exist. Buyers who look you up find your website and little else, so they can't tell whether you're real, good, or right for them.",
      "thisWeek": "search for your company and your problem the way a buyer would, and write down what comes up. Ask three happy customers if they'll leave a review where your buyers look." },
    { "id": "acquisition", "name": "Acquisition", "question": "Do you turn interest into the right conversations?",
      "looksLike": "leads wait, nobody owns the first reply, and the team only sells to whoever happens to show up.",
      "thisWeek": "name one person who answers every new lead within four hours. Write down, in one sentence, who is a good fit and who isn't." },
    { "id": "activation", "name": "Activation", "question": "When someone says yes, is everyone clear on what they're getting?",
      "looksLike": "deals close on a handshake, and the questions nobody asked come back as scope fights, delays and unhappy customers.",
      "thisWeek": "write a one-page \"what you're getting\" for your most common sale, and send it before the next signature." },
    { "id": "engagement", "name": "Engagement", "question": "Do you deliver what you promised?",
      "looksLike": "you deliver, but late, with defects, or not quite what was promised. In software, a bug list that keeps growing.",
      "thisWeek": "group your open problems by kind, not by date. The biggest group is usually one fix, not twenty." },
    { "id": "retention", "name": "Retention", "question": "Do customers stay, and trust you while they do?",
      "looksLike": "customers leave quietly, you find out at renewal, and sales spends its year replacing them.",
      "thisWeek": "list the customers you lost in the last six months and the last thing that went wrong for each. The pattern is usually there." },
    { "id": "revenue", "name": "Revenue", "question": "Do you get paid cleanly for what you deliver?",
      "looksLike": "invoices get questioned, paid late or written off, because the customer can't see what they're paying for.",
      "thisWeek": "make every invoice name what was delivered for that charge." },
    { "id": "referral", "name": "Referral", "question": "Do happy customers bring you new ones?",
      "looksLike": "customers are happy, and still nobody refers you, because nobody asked at the right moment.",
      "thisWeek": "pick the moment a customer first gets real value, and ask for one introduction then." }
  ],
  "problems": [
    { "id": "pipeline",   "label": "We can't fill the pipeline",               "shows": "in your pipeline",       "stages": ["awareness", "acquisition", "retention", "referral"] },
    { "id": "conversion", "label": "Leads come in, but few of them buy",       "shows": "in leads that don't buy", "stages": ["acquisition", "activation", "awareness"] },
    { "id": "stall",      "label": "New customers stall after they sign",      "shows": "after customers sign",   "stages": ["activation", "engagement"] },
    { "id": "churn",      "label": "Customers leave, or don't renew",          "shows": "in customers leaving",   "stages": ["engagement", "retention", "activation"] },
    { "id": "billing",    "label": "Getting paid is slow or messy",            "shows": "in getting paid",        "stages": ["revenue", "activation", "engagement"] },
    { "id": "referrals",  "label": "Customers like us, but nobody refers us",  "shows": "in referrals",           "stages": ["referral", "retention", "engagement"] },
    { "id": "unknown",    "label": "Growth stalled, and we can't say why",     "shows": "as stalled growth",      "stages": ["awareness", "acquisition", "activation", "engagement", "retention", "revenue", "referral"] }
  ],
  "questions": [
    { "id": "awareness-1", "stage": "awareness", "text": "If a likely buyer looked you up today, what would they find?",
      "answers": [ { "label": "Not much beyond our website", "score": 0 }, { "label": "Some reviews or posts, but thin", "score": 1 }, { "label": "Plenty: reviews, articles, people talking about us", "score": 2 } ] },
    { "id": "awareness-2", "stage": "awareness", "text": "Where do most new leads first hear about you?",
      "answers": [ { "label": "We're not sure", "score": 0 }, { "label": "Mostly one source", "score": 1 }, { "label": "Several steady sources we can name", "score": 2 } ] },
    { "id": "acquisition-1", "stage": "acquisition", "text": "When someone raises a hand, how fast do they hear back?",
      "answers": [ { "label": "Days, or it depends who sees it", "score": 0 }, { "label": "Usually within a day", "score": 1 }, { "label": "Within hours, every time, from a named person", "score": 2 } ] },
    { "id": "acquisition-2", "stage": "acquisition", "text": "Do you reach out to likely buyers, or only wait for them to find you?",
      "answers": [ { "label": "We only wait", "score": 0 }, { "label": "Now and then, when someone has time", "score": 1 }, { "label": "Yes, on a plan, aimed at buyers showing signs they're ready", "score": 2 } ] },
    { "id": "activation-1", "stage": "activation", "text": "Before work starts, are scope, price and timing written down and agreed?",
      "answers": [ { "label": "Often not", "score": 0 }, { "label": "Mostly", "score": 1 }, { "label": "Always", "score": 2 } ] },
    { "id": "activation-2", "stage": "activation", "text": "How often do new customers say \"that's not what I thought I was getting\"?",
      "answers": [ { "label": "Often", "score": 0 }, { "label": "Sometimes", "score": 1 }, { "label": "Rarely", "score": 2 } ] },
    { "id": "engagement-1", "stage": "engagement", "text": "How long until a new customer gets their first real result?",
      "answers": [ { "label": "Too long, or we don't know", "score": 0 }, { "label": "About what we promised", "score": 1 }, { "label": "Fast, and we track it", "score": 2 } ] },
    { "id": "engagement-2", "stage": "engagement", "text": "Your list of open problems (bugs, defects, redo work): is it growing or shrinking?",
      "answers": [ { "label": "Growing", "score": 0 }, { "label": "About the same", "score": 1 }, { "label": "Shrinking", "score": 2 } ] },
    { "id": "retention-1", "stage": "retention", "text": "Do you know a customer is about to leave before they tell you?",
      "answers": [ { "label": "No, we find out when they cancel", "score": 0 }, { "label": "Sometimes", "score": 1 }, { "label": "Yes, we watch for the signs and reach out", "score": 2 } ] },
    { "id": "retention-2", "stage": "retention", "text": "Are you winning new customers mostly to replace the ones you lose?",
      "answers": [ { "label": "Yes", "score": 0 }, { "label": "Partly", "score": 1 }, { "label": "No, most customers stay", "score": 2 } ] },
    { "id": "revenue-1", "stage": "revenue", "text": "How often are invoices questioned, paid late or written off?",
      "answers": [ { "label": "Often", "score": 0 }, { "label": "Sometimes", "score": 1 }, { "label": "Rarely", "score": 2 } ] },
    { "id": "revenue-2", "stage": "revenue", "text": "Does every charge say clearly what the customer got for it?",
      "answers": [ { "label": "No", "score": 0 }, { "label": "Sometimes", "score": 1 }, { "label": "Yes", "score": 2 } ] },
    { "id": "referral-1", "stage": "referral", "text": "How many of your new customers come from referrals?",
      "answers": [ { "label": "Almost none, or we don't know", "score": 0 }, { "label": "Some", "score": 1 }, { "label": "Many", "score": 2 } ] },
    { "id": "referral-2", "stage": "referral", "text": "Do you ask happy customers for introductions, at a set moment?",
      "answers": [ { "label": "Never", "score": 0 }, { "label": "Now and then", "score": 1 }, { "label": "Yes, it's part of how we work", "score": 2 } ] }
  ],
  "statuses": [
    { "id": "stuck",   "label": "Stuck",   "min": 0, "max": 1 },
    { "id": "weak",    "label": "Weak",    "min": 2, "max": 2 },
    { "id": "healthy", "label": "Healthy", "min": 3, "max": 4 }
  ],
  "result": {
    "list": ["stuck", "weak"],
    "limit": 3,
    "order": "Listed stages are the ones whose status is in `list`, in that status order. Within one status, the stages tied to the picked problem come first, in the problem's own order, then the rest in customer order (Awareness to Referral). At most `limit` are listed."
  }
}
