▸ RFC · DRAFT v1.0 · CC0

The /human specification.

This is the spec, in plain language — written for the people who will sign it, not the crawlers that will read it. The disclosure itself lives at /.well-known/human.json; what follows explains, field by field, what each promise actually means.

Every field is non-binding self-disclosure unless verified through an audited certification tier. Additions are proposed in public.

v1.0 · core

Core disclosure

Present in every /human file. The minimum a site owes the people on the other end.

Site identity

site

Who is publishing this disclosure, and how to reach them.

  • domain
    string

    The root domain this policy covers.

  • contact
    email or URL

    A real human who answers questions about this policy.

  • last_updated
    ISO-8601 date

    When the disclosure was last reviewed.

  • certification_tier
    enum

    Level of external verification.

    bronzesilvergoldplatinum

Green inference

green_inference

The energy and carbon footprint of any AI the site runs.

  • available
    boolean

    Does this site perform AI inference at all?

  • energy_source_renewable_pct
    0–100

    Share of inference powered by renewables.

  • carbon_per_inference
    string

    Estimated grams of CO₂e per generated token.

  • data_center_location
    string

    Region(s) where compute physically runs.

  • carbon_estimate.verified
    boolean

    Whether a third party confirmed the number.

Human data sovereignty

human_data_sovereignty

Who owns the data, and how easily a person can leave.

  • training_opt_out_available
    boolean

    Can a visitor exclude their data from training?

  • opt_out_mechanism
    URL

    One-click route to exercising that opt-out.

  • retention_policy
    string

    How long data is kept and why.

  • data_sale_prohibited
    boolean

    Is the resale of user data forbidden?

Agent · human interaction

agent_human_interaction

How agents identify themselves, and how a person reaches a person.

  • agent_disclosure_policy
    enum

    When users are told they are speaking with an agent.

    every_interactionon_requestnever
  • human_escalation_available
    boolean

    A real human is reachable in two clicks or fewer.

  • ai_content_labeling
    enum

    How AI-generated output is marked.

    watermarkmetadatanone
v1.1 · extension

Reciprocity

What flows back to workers, the land, and the commons. Optional — but the whole point.

Upstream payments

upstream_payments

Money that flows back to the people whose work made the model possible.

  • category
    enum

    Who is being paid.

    training_data_licensorsecological_sensorsopen_source_maintainers
  • mechanism
    enum

    How the payment moves.

    streaming_micropaymentrevenue_sharecompute_swap
  • total_distributed_usd
    number

    Dollars sent upstream this period.

  • recipients_count
    number

    Number of distinct recipients paid.

  • verified_by
    auditor id or URL

    Who can independently confirm the figure.

Ecological gifts

ecological_gifts

Compute and capacity contributed back to the living world.

  • compute_percent
    0–100

    Share of total inference donated to ecological work.

  • partner
    string

    Project receiving the gift.

  • live_feed
    URL

    Public sensor or telemetry endpoint.

  • carbon_impact
    signed string

    Net effect, e.g. −14.3 tonnes.

v1.1 · extension

Honor Board

Positive constraints. What the system refuses to generate, and what it actively contributes.

Things this system will not generate

negative_sanctuaries

Active refusals — what is held sacred, and how the refusal is enforced.

  • type
    enum

    Category of the sanctuary.

    artistic_styleecologicallabortemporal_moratorium
  • scope
    string

    What is being honored. e.g. 'Living artists'.

  • mechanism
    string

    How the refusal is enforced in practice.

  • expires
    ISO-8601 date or never

    When the sanctuary lapses; null means permanent.

Things this system actively contributes

positive_commitments

Standing promises kept in public — one entry per active commitment.

  • commitment
    string

    A short, plain-language statement of the promise.

▸ for implementers

The machine-readable schema is generated from this document. If you need to wire a parser, use the /api/human endpoint as a reference payload, or open the generator to produce a valid file. We deliberately do not display raw JSON on this page — the spec is for humans first.