{
  "name": "Open Hiring Harness",
  "short_name": "OHH",
  "version": "0.2.0",
  "status": "experimental",
  "licence": "Apache-2.0",
  "description": "An open, privacy-first specification for publishing hireable professional identity — for humans and AI agents.",
  "website": "https://aklodhi98.github.io/ohh/",
  "repository": "https://github.com/aklodhi98/ohh",

  "schema": {
    "version": "0.2.0",
    "url": "https://raw.githubusercontent.com/aklodhi98/ohh/main/schema/open-hiring-harness.v0.2.schema.json",
    "format": "JSON Schema (draft 2020-12)"
  },

  "discovery": {
    "well_known_path": "/.well-known/hiring-harness.json",
    "dns_txt_record": "_hiring-harness.{domain}",
    "html_link_rel": "hiring-harness",
    "consent_log_path": "/.well-known/hiring-consent-log.json"
  },

  "entity_types": [
    {
      "type": "individual",
      "description": "A human professional publishing their hireable identity",
      "status": "stable"
    },
    {
      "type": "delegated_agent",
      "description": "An AI agent acting on behalf of a human, declared within the human's harness",
      "status": "proposed"
    },
    {
      "type": "autonomous_agent",
      "description": "An AI agent publishing its own harness as an independent hireable entity",
      "status": "proposed"
    }
  ],

  "visibility_tiers": ["public", "permissioned", "private"],

  "examples": [
    {
      "name": "Individual harness",
      "url": "https://raw.githubusercontent.com/aklodhi98/ohh/main/examples/harness.v0.2.example.json",
      "entity_type": "individual"
    },
    {
      "name": "Consent log",
      "url": "https://raw.githubusercontent.com/aklodhi98/ohh/main/examples/consent-log.v0.2.example.json"
    }
  ],

  "docs": [
    {
      "title": "MCP Interface",
      "url": "https://github.com/aklodhi98/ohh/blob/main/docs/mcp-interface.md",
      "description": "How AI agents interact with a harness via Model Context Protocol"
    },
    {
      "title": "Consent Log",
      "url": "https://github.com/aklodhi98/ohh/blob/main/docs/consent-log.md",
      "description": "How consent receipts are stored and managed"
    },
    {
      "title": "Agent Entities",
      "url": "https://github.com/aklodhi98/ohh/blob/main/docs/agent-entities.md",
      "description": "Proposal for AI agents as hireable entities (delegated and autonomous)"
    }
  ],

  "agent_instructions": {
    "to_discover": "Check /.well-known/hiring-harness.json on the target domain",
    "to_read_public": "Access the harness JSON directly — public fields require no consent",
    "to_request_access": "Provide requester identity, purpose, and requested scopes via the consent flow",
    "to_publish": "Host a valid harness at your operator's domain under /.well-known/hiring-harness.json",
    "integration_protocol": "MCP (Model Context Protocol)"
  }
}