Tender brief

A cited brief on a tender: everything known about it and how you are placed to pursue it.

Part of Opportunities in the register catalog.

Register ID

tender_briefUse this name to ask for the register. The API calls it a shelf ID.

Each record is

A stateThe current value of something, replaced when it changes.

Status

DeclaredDefined, and fills when a source produces its first record.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1Current version.

Download JSON SchemaSee an example record

Standards

This register holds records these standards and laws ask for. Holding them does not by itself certify compliance.

• OC4IDSOpen Contracting for Infrastructure Data StandardInternational

Connectors

Connected today

Demiton keeps this register current from these systems now.

No system fills this register yet.

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

None planned yet.

Fields

18 fields: 16 required, 2 optional.

Required

Every record carries these fields.

source_opportunity_refText

The opportunity identifier the brief is anchored to.

Example: vendorpanel_upcoming:https://www.vendorpanel.com.au/Publi…

briefed_atDate and timeISO 8601, with time zoneUnit: UTC

When the brief was composed; the as-of anchor against which the 720-hour freshness window is measured.

Example: 2026-08-20T09:00:00

statusText

The composing run's outcome, including the honest "too little to compose" and "could not read" states.

Example: composed

review_stateText

The record's human-review / publication marker: agent-proposed, not human-approved and not emittable.

Example: agent-proposed

headlineText

One-sentence statement of the brief.

Example: ITT242 Caloundra Transport Corridor Upgrade is a strong f…

sectionsList

The brief body: one object per fixed section.

sections[].keyText

Which section this object is.

Example: scope_summary

sections[].markdownText

The section prose.

Example: Road widening and intersection upgrade along the Caloundr…

sections[].citationsList

The evidence for every figure or factual claim in the section.

citations[].kindText

Whether the citation points at a memory fact or a document read.

citations[].refText

The fact id, or the document path plus page.

data_coverageGroup of fields

The honesty ledger: what was consulted, what came back empty, what documents were read.

data_coverage.conduits_consultedList

The Civil Memory shelves the run read.

data_coverage.conduits_emptyList

Shelves read that returned nothing — the ledger that makes an empty brief honest.

data_coverage.documents_readList

The tender documents read, by path and page range.

open_question_countWhole numberUnit: count

How many material questions the facts did not answer.

Example: 2

Optional

Present when the source system records them.

citations[].noteText

Free qualifier on the citation.

agent_run_idText

Which AgentRun produced the brief.

Example: run-77120

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

tender_brief.example.json

{
  "agent_run_id": "run-77120",
  "briefed_at": "2026-08-20T09:00:00",
  "data_coverage": {
    "conduits_consulted": [
      "job_budget",
      "asset_utilisation",
      "profit_and_loss"
    ],
    "conduits_empty": [
      "subcontractor_list"
    ],
    "documents_read": [
      {
        "pages": "1-8",
        "path": "ITT242_Scope_of_Works.pdf"
      }
    ]
  },
  "headline": "ITT242 Caloundra Transport Corridor Upgrade is a strong fit for Bridgeworks' Sunshine Coast delivery footprint.",
  "open_question_count": 2,
  "review_state": "agent-proposed",
  "sections": [
    {
      "citations": [
        {
          "kind": "document",
          "note": "Scope description",
          "ref": "ITT242_Scope_of_Works.pdf#p3"
        }
      ],
      "key": "scope_summary",
      "markdown": "Road widening and intersection upgrade along the Caloundra Transport Corridor, comparable in scale to BWG-2025-001."
    },
    {
      "citations": [
        {
          "kind": "fact",
          "ref": "fact:asset_utilisation:9301"
        }
      ],
      "key": "capacity_check",
      "markdown": "Bridgeworks currently runs 3 delivering projects with combined plant utilisation below 80%, leaving capacity to mobilise."
    }
  ],
  "source_opportunity_ref": "vendorpanel_upcoming:https://www.vendorpanel.com.au/PublicTenderAccess.aspx?id=1bc13508218f4795a38bdf5c85dc01ecs492876",
  "status": "composed"
}

Use this contract

The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.

Schema URL

https://docs.demiton.io/registers/tender_brief/v1.json

Show the full JSON Schema

Loading the schema…