◇ Open Values Standardfor builders

Spec / open-values-asks-offers

Open Values Asks/Offers v0.1

A file of requests for help (asks) and offers of help, such as a library asking for help running a digital-safety session, each pointing at related guides, categories and organisations, with sources. It is kept by hand at content/asks-offers.json, holds no contact details, and the current items are templates.

Draft. It may still change before it is called stable. A file someone writes by hand or with a tool, and keeps.

Who writes it and who reads it

No writer is listed. Read by future asks/offers board, future initiatives surface, community fork workflows.

Fields

FieldWhat it meansType
format requiredAlways "open-values-asks-offers". Tells a reader which Open Values format this is.always "open-values-asks-offers"
version requiredThe version of the asks and offers format this file follows. Must start with 0.1.0.string
standard requiredAlways "open-values-standard", the standard this format belongs to.always "open-values-standard"
updated requiredThe date the file was last changed, as YYYY-MM-DD.string
purpose requiredA sentence or two saying what this file is for.see nonEmptyString
principles requiredThe rules the file follows, one short sentence each, such as "no private contact details in public files".list
publication requiredHow the file is published: storage, relays, identity, and what must stay out of it.see publication
items requiredThe asks and offers, one entry each. At least one.list

A reader MUST ignore fields it does not know, so a file can carry more than this list and still be read. A writer MUST NOT change what a listed field means.

A file that passes

Asks/offers files publish ask and offer templates with receipts, related refs, universal values, and no live database.

{
  "format": "open-values-asks-offers",
  "version": "0.1.0",
  "standard": "open-values-standard",
  "updated": "2026-07-08",
  "purpose": "Seed help-over-selling coordination.",
  "principles": [
    "file-based",
    "no private contact details",
    "templates are not live claims",
    "receipts required"
  ],
  "publication": {
    "status": "format-seed",
    "storage": "single-json-file",
    "relay": "static host or repository discussion",
    "identity": "pseudonymous or attributed by choice",
    "liveDatabase": false,
    "privacy": "Do not publish private contact details."
  },
  "items": [
    {
      "id": "ask-sample-help",
      "kind": "ask",
      "status": "template",
      "title": "Who can help check this?",
      "summary": "A seed ask template.",
      "prompt": "Who has experience checking this kind of request?",
      "audience": [
        "community group"
      ],
      "needs": [
        "review"
      ],
      "values": [
        "community",
        "openness"
      ],
      "regions": [
        "global"
      ],
      "related": {
        "categories": [
          "causes-to-support"
        ],
        "guides": [
          "where-to-give"
        ],
        "initiatives": [
          "givewell"
        ]
      },
      "receipts": [
        {
          "note": "Example public evaluator page.",
          "source": "https://example.com/evaluator",
          "asof": "2026"
        }
      ],
      "limits": [
        "Do not publish private contact details."
      ]
    },
    {
      "id": "offer-sample-brief",
      "kind": "offer",
      "status": "template",
      "title": "I can share a brief",
      "summary": "A seed offer template.",
      "prompt": "I can share a sourced one-page brief.",
      "audience": [
        "donor circle"
      ],
      "offers": [
        "brief"
      ],
      "values": [
        "people",
        "quality"
      ],
      "regions": [
        "global"
      ],
      "related": {
        "categories": [
          "causes-to-support"
        ],
        "guides": [
          "where-to-give"
        ],
        "initiatives": [
          "givewell"
        ]
      },
      "receipts": [
        {
          "note": "Example public source page.",
          "source": "https://example.com/source",
          "asof": "2026"
        }
      ],
      "limits": [
        "Do not present the brief as legal or tax advice."
      ]
    }
  ]
}

A file that must be rejected

A no-capture asks/offers source file must not declare a live authority database.

{
  "format": "open-values-asks-offers",
  "version": "0.1.0",
  "standard": "open-values-standard",
  "updated": "2026-07-08",
  "purpose": "Seed help-over-selling coordination.",
  "principles": [
    "file-based"
  ],
  "publication": {
    "status": "format-seed",
    "storage": "database",
    "relay": "central service",
    "identity": "account",
    "liveDatabase": true,
    "privacy": "Contact details are public."
  },
  "items": [
    {
      "id": "ask-sample-help",
      "kind": "ask",
      "status": "template",
      "title": "Who can help check this?",
      "summary": "A seed ask template.",
      "prompt": "Who has experience checking this kind of request?",
      "audience": [
        "community group"
      ],
      "needs": [
        "review"
      ],
      "values": [
        "community"
      ],
      "regions": [
        "global"
      ],
      "related": {
        "categories": [
          "causes-to-support"
        ],
        "guides": [
          "where-to-give"
        ],
        "initiatives": [
          "givewell"
        ]
      },
      "receipts": [
        {
          "note": "Example public evaluator page.",
          "source": "https://example.com/evaluator",
          "asof": "2026"
        }
      ],
      "limits": [
        "Do not publish private contact details."
      ]
    }
  ]
}

The schema

Its address is https://openvaluesstandard.org/schema/asks-offers-v0.1.schema.json. Validators can fetch it there; the file is also in the repository at app/data/standard/schemas/asks-offers.schema.json.

The key words MUST, MUST NOT, SHOULD, SHOULD NOT and MAY are used as described in RFC 2119 and RFC 8174 when, and only when, they appear in capitals.

Whether this format fits your app is your call. The spec says what a file MUST hold. Which formats you read and write, and what your app does with them, is yours to decide.