Intellectual Frontiers

Log the Help Flag and the Actor with Every Event on the Path

Sample instrumentation schema

The chapter “Instrument Each Transition on the Path” gives ten questions to ask of every transition. This page turns them into a sample event. Adapt the names to your system, and do not collect personal or regulated data you do not need.

One event

{
  "event": "first_intake_completed",
  "path_stage": "first_useful_action",
  "occurred_at": "2026-10-12T14:31:07Z",
  "account_id": "acct_0421",
  "actor_role": "front_desk_coordinator",
  "icp_version": "2",
  "product_version": "4.2",
  "message_version": "3",
  "source_channel": "paid_search",
  "minutes_since_stage_start": 11,
  "prerequisite_missing": null,
  "intervention": {
    "occurred": false,
    "actor": null,
    "category": null
  },
  "voluntary": true,
  "test_data": false
}

What each field answers

Field Question from the chapter

event, path_stage

What event tells us the transition occurred?

minutes_since_stage_start

How long did it take?

prerequisite_missing

What prerequisite was missing?

intervention

Was there an intervention, and who performed it?

voluntary

Was the transition voluntary?

icp_version, product_version, message_version

Which version does this evidence describe?

The question “what happened next” comes from the next event on the same account.

Events for the intake path

Stage Event

Setup

schedule_import_completed

First useful action

first_intake_completed

Repeated use

third_intake_in_week_completed

Demonstrated value

time_saved_reported

Continuation

renewal_decided, user_added, referral_made

Rules

  1. Record the help flag from the person who gave the help, at the time, in the system they already use.

  2. Keep acceptance telemetry free of patient or other regulated data.

  3. Tell users what you record, and keep a retention limit.