Scope Pack Exchange Format v1.0

What is a Scope Pack?

A Scope Pack is a homeowner's finished renovation scope, sealed into an immutable, versioned artifact: the rooms, the jobs, the quality tier of each job, the answers that shaped them, and the finishes chosen — by name only. It is the one artifact that crosses between parties.

What's in a pack

• Spaces — each room with a name, kind, floor area, and a relatable size band.
• Jobs — each piece of work with its quality tier, the spaces it covers, an aggregate quantity, the homeowner's selections, and the chosen finishes.
• Quality tiers — a whole-job Good / Better / Best level; finishes also carry a tier band.
• Selections — the recap of the homeowner's answered choices, as a label and a value.
• Finishes — the chosen category and option, by name and tier (never a price).

Versioning and compatibility

Version 1 is frozen: it is never changed in place, so a v1 pack stays parseable forever. Backward-compatible additions stay on the v1 line; any breaking change is published as a new version alongside v1. Every document declares the spec version it conforms to.

Example document

{
  "format": "briked.scope-pack",
  "specVersion": "1.0",
  "id": "01900000-0000-7000-8000-0000000000a1",
  "project": {
    "id": "01900000-0000-7000-8000-0000000000b1"
  },
  "version": 1,
  "sealedAt": "2026-06-01T10:00:00.000Z",
  "defaultTier": "better",
  "spaces": [
    {
      "id": "01900000-0000-7000-8000-0000000000c1",
      "name": {
        "en": "Kitchen",
        "ar": "مطبخ"
      },
      "type": "kitchen",
      "floorArea": {
        "value": 12,
        "unit": "m²"
      },
      "sizeBand": "typical"
    },
    {
      "id": "01900000-0000-7000-8000-0000000000c2",
      "name": {
        "en": "Main bathroom",
        "ar": "الحمام الرئيسي"
      },
      "type": "bathroom",
      "floorArea": {
        "value": 6,
        "unit": "m²"
      },
      "sizeBand": "small"
    }
  ],
  "jobs": [
    {
      "id": "01900000-0000-7000-8000-0000000000d1",
      "name": {
        "en": "Renovate kitchen",
        "ar": "تجديد المطبخ"
      },
      "type": "room",
      "tier": "best",
      "spaces": [
        {
          "id": "01900000-0000-7000-8000-0000000000c1",
          "name": {
            "en": "Kitchen",
            "ar": "مطبخ"
          }
        }
      ],
      "quantity": {
        "value": 12,
        "unit": "m²",
        "assumed": false
      },
      "selections": [
        {
          "label": {
            "en": "Cabinet style",
            "ar": "نمط الخزائن"
          },
          "value": {
            "en": "Modern",
            "ar": "عصري"
          }
        }
      ],
      "finishes": [
        {
          "category": {
            "id": "01900000-0000-7000-8000-0000000000f1",
            "name": {
              "en": "Cabinets",
              "ar": "خزائن"
            }
          },
          "choice": {
            "id": "01900000-0000-7000-8000-0000000000f2",
            "name": {
              "en": "Solid oak",
              "ar": "بلوط صلب"
            }
          },
          "tier": "premium"
        }
      ]
    },
    {
      "id": "01900000-0000-7000-8000-0000000000d2",
      "name": {
        "en": "Bathroom waterproofing",
        "ar": "عزل الحمام المائي"
      },
      "type": "trade",
      "tier": "better",
      "spaces": [
        {
          "id": "01900000-0000-7000-8000-0000000000c2",
          "name": {
            "en": "Main bathroom",
            "ar": "الحمام الرئيسي"
          }
        }
      ],
      "quantity": {
        "value": 6,
        "unit": "m²",
        "assumed": true
      },
      "selections": [],
      "finishes": []
    }
  ],
  "assumedQuantityCount": 1
}