{
  "schemaVersion": 1,
  "study": "cold-email-first-sentence-experiment",
  "title": "First sentence experiment: study protocol",
  "status": "awaiting-real-data",
  "scope": "Collection template, not a dataset or completed field study. All null values are intentionally uncollected.",
  "unitOfObservation": "prospect",
  "requiredInputs": "Verified source evidence that makes either treatment appropriate for each eligible prospect.",
  "controls": "Determine eligibility before assignment; keep the rest of the body fixed.",
  "primaryAnalysis": "Qualified replies alongside unsupported-claim incidence; neither metric hides the other.",
  "registration": {
    "owner": null,
    "protocolVersion": "1",
    "registeredAt": null,
    "population": null,
    "eligibilityRules": null,
    "primaryOutcomeDefinition": null,
    "denominator": null,
    "observationWindow": null,
    "targetSampleAndJustification": null,
    "assignmentProcedureAndSeed": null,
    "exclusionRules": null,
    "safetyStopConditions": null,
    "missingDataPolicy": null,
    "retentionAndAccessOwner": null
  },
  "collectionRules": [
    "Assign pseudonymous IDs; do not store mailbox passwords, access tokens or unnecessary identifiers.",
    "Freeze the outcome and exclusions before collection; retain exclusions with reasons.",
    "Do not use repeated observations as independent people. Record clustering by person, company or mailbox.",
    "Do not treat a software test, simulated reply or researcher-written example as participant or campaign evidence.",
    "Record complaints and opt-outs and follow the actual suppression workflow.",
    "For interviews obtain permission before recording and respect withdrawal.",
    "Publish aggregate or redacted evidence only after review; keep original private records outside the public website."
  ],
  "fieldDictionary": {
    "assignment_id": {
      "required": true,
      "type": "string, number or boolean as specified by the registered protocol; null until collected",
      "meaning": "assignment id",
      "missingValue": null
    },
    "company_id": {
      "required": true,
      "type": "string, number or boolean as specified by the registered protocol; null until collected",
      "meaning": "company id",
      "missingValue": null
    },
    "arm": {
      "required": true,
      "type": "string, number or boolean as specified by the registered protocol; null until collected",
      "meaning": "arm",
      "missingValue": null
    },
    "first_sentence": {
      "required": true,
      "type": "string, number or boolean as specified by the registered protocol; null until collected",
      "meaning": "first sentence",
      "missingValue": null
    },
    "source_reference": {
      "required": true,
      "type": "string, number or boolean as specified by the registered protocol; null until collected",
      "meaning": "source reference",
      "missingValue": null
    },
    "source_verified": {
      "required": true,
      "type": "string, number or boolean as specified by the registered protocol; null until collected",
      "meaning": "source verified",
      "missingValue": null
    },
    "body_version": {
      "required": true,
      "type": "string, number or boolean as specified by the registered protocol; null until collected",
      "meaning": "body version",
      "missingValue": null
    },
    "qualified_reply": {
      "required": true,
      "type": "string, number or boolean as specified by the registered protocol; null until collected",
      "meaning": "qualified reply",
      "missingValue": null
    },
    "factual_error": {
      "required": true,
      "type": "string, number or boolean as specified by the registered protocol; null until collected",
      "meaning": "factual error",
      "missingValue": null
    }
  },
  "blankRecord": {
    "observation_id": null,
    "assignment_id": null,
    "company_id": null,
    "arm": null,
    "first_sentence": null,
    "source_reference": null,
    "source_verified": null,
    "body_version": null,
    "qualified_reply": null,
    "factual_error": null,
    "excluded": false,
    "exclusion_reason": null,
    "protocol_deviation": null
  },
  "records": [],
  "analysisStatus": "not-run",
  "results": null,
  "interpretationLimits": "An observation available only for some companies changes the eligible population. Do not compare that subset with an unrelated control. Publish results only after the evidence, method and limitations have been reviewed. This protocol provides no benchmark, expected lift or completed-study claim.",
  "procedure": [
    "Keep the remaining body identical. Save evidence for every observation and reject claims that cannot be verified.",
    "Assign at random only after determining both treatments are appropriate. Track claim accuracy as a guardrail alongside replies.",
    "Before collection, write the primary outcome, observation window, exclusion rules and stopping conditions. Preserve excluded observations with a reason rather than quietly removing them.",
    "Pilot the procedure with fictional or owned test data, resolve ambiguous fields, and freeze a dated protocol version before the main run."
  ],
  "interviewPrompts": []
}
