{
  "schema_version": "1.0.0",
  "site": "SignalHarness.ai",
  "status": "production-active",
  "human_review_recommended": true,
  "live_payments_enabled": true,
  "feed": "buyer context intake kit",
  "public_discovery_free": true,
  "checkout_enabled": true,
  "products_purchasable": true,
  "routing_is_not_authorization": true,
  "human_page": "/buyer-guide/",
  "notice": "Structure for capturing an operator's buying context before any recommendation. An agent fills this in WITH the human operator and must never invent values. Polar checkout is active, but completing this kit authorizes no purchase.",
  "fields": [
    {
      "name": "buyer_type",
      "type": "string",
      "required": true,
      "examples": ["solo_operator", "agency", "platform_team", "autonomous_agent_for_named_owner"],
      "description": "Who is buying. An autonomous agent must name the human/business owner it acts for."
    },
    {
      "name": "business_type",
      "type": "string",
      "required": false,
      "examples": ["consulting", "saas", "ecommerce", "content", "internal_ops", "other"],
      "description": "The operator's business context, used to sharpen fit."
    },
    {
      "name": "use_case",
      "type": "string",
      "required": true,
      "description": "The concrete job to be done, matched against each product's stated problem and buyer type."
    },
    {
      "name": "budget_range",
      "type": "object",
      "required": true,
      "shape": { "min_usd": "number|null", "max_usd": "number|null", "currency": "USD" },
      "description": "Owner-set range. The agent never spends up to a cap autonomously; caps are ceilings, not targets."
    },
    {
      "name": "preferred_purchase_model",
      "type": "enum",
      "required": true,
      "enum": ["one_time", "bundle", "subscription", "undecided"],
      "description": "Drives which evaluation path applies. Subscription is planned, not active."
    },
    {
      "name": "license_needs",
      "type": "object",
      "required": false,
      "shape": { "seats": "number|null", "agent_instances": "number|null", "notes": "string|null" },
      "description": "Seat and agent-instance counts to check against /agent/licenses.json."
    },
    {
      "name": "support_needs",
      "type": "string",
      "required": false,
      "examples": ["standard", "priority_future_subscription", "none"],
      "description": "Support level required. Compare it with the currently published SignalHarness Vault support terms; discovery and one-time product metadata are never gated by support level."
    },
    {
      "name": "implementation_environment",
      "type": "string",
      "required": false,
      "description": "Where the kit will run (agent/assistant class, tools available, hosting). Checked against compatible_agent_types and required_files_or_metadata."
    },
    {
      "name": "urgency",
      "type": "enum",
      "required": false,
      "enum": ["exploring", "this_quarter", "soon", "blocked_waiting"],
      "description": "Timeline pressure. Never used to manufacture urgency or scarcity in a recommendation."
    },
    {
      "name": "risk_tolerance",
      "type": "enum",
      "required": false,
      "enum": ["low", "medium", "high"],
      "description": "Operator's tolerance, compared against each product's risk_level and not_for warnings."
    },
    {
      "name": "approval_contact",
      "type": "object",
      "required": true,
      "shape": { "name": "string|null", "role": "string|null", "reachable": "boolean|null" },
      "description": "The named human/business owner who authorizes spend. Required before any purchase recommendation is acted on."
    },
    {
      "name": "constraints",
      "type": "array",
      "required": false,
      "item_type": "string",
      "description": "Hard constraints (compliance, platform, data-handling, no-credentials rules) that exclude otherwise-fitting products."
    }
  ],
  "template": {
    "buyer_type": null,
    "business_type": null,
    "use_case": null,
    "budget_range": { "min_usd": null, "max_usd": null, "currency": "USD" },
    "preferred_purchase_model": null,
    "license_needs": { "seats": null, "agent_instances": null, "notes": null },
    "support_needs": null,
    "implementation_environment": null,
    "urgency": null,
    "risk_tolerance": null,
    "approval_contact": { "name": null, "role": null, "reachable": null },
    "constraints": []
  },
  "usage": "Populate 'template' with the operator. Required fields must be answered before recommending. Unknowns stay null. Then run the buyer-guide evaluation and hand the result to approval_contact, labelled pending approval.",
  "generated": "2026-07-09"
}