Readiness assessments

Readiness assessments are standalone scored quizzes at /assessments/[slug]. They differ from learning path certification assessments (configured per path at /admin/learning-paths/[id]/assessment).

Admin path

/admin/assessments → New assessment → /admin/assessments/new

Fields

Field	Purpose
Title / Slug	Assessment name and URL
Description	Intro text and default teaser
Visibility / Teaser	See Access & gating
Category	Learn, Research, Systems, Governance, Media, or Resources
Scoring model (JSON)	Questions and result level bands — required
Published	Live on public site

Scoring model JSON

The entire quiz is defined in one JSON object with questions and levels arrays.

Full example

{
  "questions": [
    {
      "id": "q1",
      "text": "How would you rate your team's AI literacy?",
      "weight": 1,
      "options": [
        { "value": 0, "label": "Not started" },
        { "value": 1, "label": "Exploring" },
        { "value": 2, "label": "Piloting" },
        { "value": 3, "label": "Scaling" }
      ]
    },
    {
      "id": "q2",
      "text": "Do you have an AI governance policy?",
      "weight": 2,
      "options": [
        { "value": 0, "label": "No" },
        { "value": 1, "label": "In draft" },
        { "value": 2, "label": "Approved" },
        { "value": 3, "label": "Enforced" }
      ]
    }
  ],
  "levels": [
    {
      "min": 0,
      "max": 25,
      "label": "Emerging",
      "color": "#94a3b8",
      "description": "You're at the start of your readiness journey.",
      "recommendations": [
        "Review the AI Literacy framework",
        "Subscribe to The Signal newsletter"
      ]
    },
    {
      "min": 26,
      "max": 50,
      "label": "Developing",
      "color": "#f59e0b",
      "description": "Foundations are forming but gaps remain.",
      "recommendations": ["Complete the governance learning path"]
    },
    {
      "min": 51,
      "max": 75,
      "label": "Advancing",
      "color": "#2563eb",
      "description": "Strong progress with room to mature.",
      "recommendations": []
    },
    {
      "min": 76,
      "max": 100,
      "label": "Leading",
      "color": "#16a34a",
      "description": "Your organization demonstrates high readiness.",
      "recommendations": []
    }
  ]
}

Question fields

Field	Type	Notes
id	string	Unique per question (e.g. q1)
text	string	Question prompt
weight	number	Multiplier for option values
options	array	Each option: { "value": number, "label": string }

Level fields

Field	Type	Notes
min / max	number	Inclusive score range (0–100 scale)
label	string	Result tier name
color	string	Hex color for result UI
description	string	Shown to the user at this level
recommendations	string[]	Optional action items

Level bands should cover 0–100 without gaps for predictable results.

How scoring works

1. User answers all questions
2. Each selected option's value is multiplied by the question's weight
3. Scores are normalized to a 0–100 scale
4. The matching level band (min–max) determines the result label, description, and recommendations

Step-by-step: publish an assessment

1. Draft questions and level bands in a JSON editor first
2. /admin/assessments/new
3. Title, description, category
4. Paste Scoring model JSON — validate syntax before saving
5. Set Visibility if gating is needed
6. Check Published
7. Save → take the quiz at /assessments/[slug] in a private window

Readiness vs certification

Feature	Readiness assessment	LP certification
Admin path	/admin/assessments	/admin/learning-paths/[id]/assessment
Public URL	/assessments/[slug]	On learning path page
Question format	JSON scoring model	Visual question builder
Scoring	Weighted levels 0–100	Points + passing %
Purpose	Standalone readiness quiz	Path completion certificate

Tips

• Start from the placeholder template in the new assessment form
• Use weight to emphasize critical questions
• Test edge cases: all minimum answers, all maximum answers
• Link recommendations to real site URLs or learning paths in prose