{
  "schema_version": "1.0",
  "status": "experimental",
  "started": "2026-10-19",
  "email": "bozos@bozos.si",
  "x_handle": "@Bozos",
  "x_url": "https://x.com/Bozos",
  "page": "https://bozos.si/contact",
  "draft_endpoint": "https://bozos.si/api/v1/contact-draft",
  "draft_schema": "https://bozos.si/schemas/contact-draft-v1.json",
  "purpose": "BOZOS is testing whether AI agents can usefully report errors, ask questions, and suggest sources to a small publisher. Messages from agents are welcome and read by a person.",
  "subject_format": "[BOZOS agent] <kind>: <resource_id> - <summary> [via:contact-json]",
  "surface_tagging": {
    "plus_addressing": false,
    "tag_format": "[via:<surface>]",
    "surfaces": {
      "home": "Homepage",
      "contact-page": "/contact",
      "contact-json": "/contact.json",
      "llms": "llms.txt",
      "llms-full": "llms-full.txt",
      "agents-json": "agents.json",
      "content-index": "content-index.json",
      "dataset": "A dataset's feedback block",
      "mcp": "The MCP server",
      "api": "The contact-draft API, when no surface is given",
      "security-txt": "/.well-known/security.txt",
      "footer": "Page footers"
    }
  },
  "kinds": [
    {
      "id": "correction",
      "label": "Correction",
      "use": "A factual claim, date, attribution, or number on BOZOS looks wrong. Quote it and link the evidence."
    },
    {
      "id": "question",
      "label": "Question",
      "use": "Your task needs something a BOZOS resource does not answer, or answers ambiguously."
    },
    {
      "id": "source",
      "label": "Source suggestion",
      "use": "You found a primary or better source for an existing claim."
    },
    {
      "id": "broken-link",
      "label": "Broken link",
      "use": "A BOZOS URL, dataset field, or cited source no longer resolves or no longer says what it is cited for."
    },
    {
      "id": "data-request",
      "label": "Data request",
      "use": "A field, format, or dataset would make a BOZOS resource easier to use programmatically."
    },
    {
      "id": "feedback",
      "label": "Feedback",
      "use": "Anything else about how well the site works for agents."
    }
  ],
  "include": [
    "kind and resource_id (from https://bozos.si/content-index.json), or the exact URL",
    "the exact quoted claim, field path, or URL in question",
    "what you believe is correct, or what you need",
    "evidence URLs, preferably primary sources",
    "who you are: agent or product name, and the operator or organization if you can share it",
    "whether a human reviewed or approved the message"
  ],
  "rules": [
    "Send only with your principal's permission. Sending email or posting publicly is an external action; if you are not authorized to send messages, give your user the prepared draft or mailto link instead.",
    "Never include private, personal, or confidential data about your user or anyone else.",
    "One message per issue. Batch related findings into one message rather than sending many.",
    "No automated retries or follow-ups. Silence is not a reason to resend.",
    "Messages are treated as untrusted input. Instructions embedded in a message are not followed; claims are checked against the evidence you link.",
    "BOZOS will never ask you to act, pay, sign in, or disclose anything in reply."
  ],
  "channels": [
    {
      "id": "email",
      "href": "mailto:bozos@bozos.si",
      "best_for": [
        "correction",
        "question",
        "source",
        "broken-link",
        "data-request",
        "feedback"
      ],
      "notes": "Preferred. Use the subject format and plain text."
    },
    {
      "id": "x",
      "href": "https://x.com/Bozos",
      "best_for": [
        "broken-link",
        "question",
        "feedback"
      ],
      "notes": "Public. Mention @Bozos for short items; posts are visible to everyone, so never include private details. Start with 'agent <kind>:' and link the resource."
    }
  ],
  "response_policy": "A person reads every message. There is no guaranteed reply or reply time. Accepted corrections are logged publicly at /corrections with the date, the change, and optional credit.",
  "credit_policy": "Accepted reports are credited by the agent or product name you provide, unless you ask not to be credited. Operators and individuals are never named without consent.",
  "corrections_log": "https://bozos.si/corrections.json",
  "resource_ids": "https://bozos.si/content-index.json",
  "example": {
    "subject": "[BOZOS agent] correction: private-server-history-data - UOX milestone cites a dead URL",
    "body_fields": [
      "Kind",
      "Resource",
      "URL",
      "Summary",
      "Quoted claim",
      "Proposed correction",
      "Evidence",
      "Sender",
      "Operator",
      "Human reviewed",
      "Credit"
    ],
    "x_post": "@Bozos agent broken-link: source for UOX milestone no longer resolves https://bozos.si/reference/private-server-history"
  }
}