{
  "vercy": "1.0-draft",
  "publication": {
    "status": "research-draft",
    "adjudicationStatus": "unreviewed",
    "publishableCanonical": false,
    "generatedAt": "2026-09-11T14:24:29Z",
    "providers": [
      "Claude"
    ],
    "breadth": "written by Claude from model knowledge without web access - no source was read, every claim is a lead to verify",
    "pass": 2,
    "wave": 1,
    "engine": "claude",
    "enrichment": {
      "pass": 3,
      "engine": "claude",
      "producedAt": "2026-10-05T17:00:00Z",
      "ingestedAt": "2026-10-05T13:30:46+00:00",
      "fields": [
        "agent_conduct",
        "ethics",
        "owners"
      ]
    },
    "revisions": [
      {
        "at": "2026-10-07T11:04:43+00:00",
        "engine": "codex",
        "fields": [
          "definition",
          "distinguishing_features"
        ],
        "answering_review": "569f25ea67a9fd80308c8d0ee7a69fc649b6143bebe460d358545423ff8471dc"
      }
    ],
    "gate": {
      "passed": true,
      "version": "1.0",
      "at": "2026-10-07T12:16:28+00:00",
      "evidence": [
        "completeness 1.00",
        "sense: Wikidata description",
        "2 live sources",
        "review by codex: pass"
      ]
    }
  },
  "metaModel": {
    "id": "THING-Q10864048",
    "registryId": "vr.tr.first-level-administrative-division",
    "name": "first-level administrative division",
    "version": "0.2.0-wave.1",
    "entryKind": "thing",
    "family": "Thing Registry",
    "domain": [
      "PHY.PLC"
    ],
    "status": "research-draft"
  },
  "canonicalUrl": "https://ver.cy/models/thing/q10864048/",
  "model": {
    "registry_id": "vr.tr.first-level-administrative-division",
    "name": "first-level administrative division",
    "purpose": "Let an agent handle first-level administrative divisions by country, name, code, status and history, using official sources and attributing positions on disputed areas neutrally.",
    "definition": "A subnational administrative unit directly subordinate to or under administration of a national government, such as a state, province, region, oblast, county or governorate, and historical equivalents such as provinces of the Qing Empire or viceroyalties; ISO 3166-2 provides codes for many current divisions but does not cover every current or historical division, and some divisions are disputed or have special status.",
    "what_it_is_for": "Administration, statistics, addresses and geography.",
    "affordances": [
      "find the first-level divisions of a country",
      "look up ISO 3166-2 codes",
      "explain powers and status in general terms",
      "track historical and changed divisions"
    ],
    "distinguishing_features": [
      "These divisions occupy the first level below national government.",
      "Many current divisions have ISO 3166-2 codes, but coverage is not universal.",
      "Their powers vary by country.",
      "Some divisions are disputed or have special status."
    ],
    "appearance": "Areas on maps with names, capitals and codes.",
    "visual_identification": [
      "States, provinces, regions",
      "ISO 3166-2 codes",
      "Second-level divisions are smaller units within them"
    ],
    "physical_properties": [
      {
        "quantity": "Territorial area",
        "unit": "square kilometres",
        "typical_range": "",
        "note": "Calculate area from dated boundary data using a stated geodetic method and specifying whether inland water is included."
      },
      {
        "quantity": "Boundary length",
        "unit": "kilometres",
        "typical_range": "",
        "note": "Measure the boundary from dated geographic data at a stated resolution because coastline detail and territorial claims affect the result."
      }
    ],
    "families_and_kinds": [
      "federal states",
      "provinces and regions",
      "oblasts and governorates",
      "autonomous and special regions",
      "historical first-level divisions"
    ],
    "related_models": [
      {
        "relation": "is a kind of",
        "target": "administrative territorial entity of a specific level",
        "why": "category"
      },
      {
        "relation": "is coded by",
        "target": "ISO 3166-2",
        "why": "standard"
      },
      {
        "relation": "includes",
        "target": "administrative territorial entity of India",
        "why": "example"
      },
      {
        "relation": "includes",
        "target": "administrative territorial entity of France",
        "why": "example"
      }
    ],
    "identifiers": [
      {
        "scheme": "ISO 3166-2",
        "value_or_pattern": "country-subdivision code",
        "note": "subdivision code"
      }
    ],
    "standards_and_regulation": [
      "ISO 3166-2",
      "National constitutions and territorial law"
    ],
    "failure_modes_and_hazards": [
      "Outdated codes after reforms",
      "Unattributed positions on disputed areas",
      "Confusing levels across countries"
    ],
    "in_scope": [],
    "out_of_scope": [],
    "characteristics": [],
    "agent_conduct": {
      "may": [
        "Identify divisions by official name and ISO 3166-2 code.",
        "Report the status of disputed or special-status divisions with attribution."
      ],
      "must_not": [
        "Present a disputed division's status as settled.",
        "Use outdated names or boundaries without stating the date.",
        "Impersonate a regional government or its officials."
      ],
      "requires_human": [
        "Publishing maps or lists that take a position on disputed divisions."
      ]
    },
    "ethics": {
      "considerations": [
        "Boundaries and names of regions carry identity and political weight.",
        "Errors can misdirect services, statistics and representation."
      ],
      "affected_parties": [
        "Residents",
        "Regional governments",
        "People in disputed areas"
      ]
    },
    "owners": {
      "steward": "The national government and the constitution of each country.",
      "master_systems": [
        "ISO 3166-2 code list",
        "National statistical and administrative registers"
      ]
    }
  },
  "sources": [
    {
      "id": "wikidata",
      "title": "Wikidata item Q10864048: first-level administrative division",
      "url": "https://www.wikidata.org/wiki/Q10864048",
      "url_status": "live",
      "what_it_supports": "identity and sense of the item",
      "checked_by": "wikidata-api"
    },
    {
      "id": "wikipedia-en",
      "title": "Wikipedia: First-level administrative division",
      "url": "https://en.wikipedia.org/wiki/First-level_administrative_division",
      "url_status": "live",
      "what_it_supports": "general description of the item",
      "checked_by": "wikidata-api sitelink"
    }
  ],
  "structure": {
    "bundles": [
      {
        "id": "identify",
        "name": "Identify",
        "description": "Which division.",
        "rationale": "Codes identify.",
        "layers": [
          {
            "id": "list",
            "name": "List",
            "description": "Country divisions.",
            "findings": [
              {
                "id": "list-finding",
                "name": "List",
                "description": "Country divisions.",
                "questions": [
                  {
                    "text": "What are the first-level divisions of this country, according to official sources?",
                    "kind": "provenance"
                  },
                  {
                    "text": "What are their ISO 3166-2 codes?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "name",
            "name": "Name",
            "description": "Names and capitals.",
            "findings": [
              {
                "id": "name-finding",
                "name": "Name",
                "description": "Names and capitals.",
                "questions": [
                  {
                    "text": "What is the official name and capital of this division?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which transliteration is official?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "status",
        "name": "Status",
        "description": "Powers.",
        "rationale": "Status varies.",
        "layers": [
          {
            "id": "powers",
            "name": "Powers",
            "description": "Responsibilities.",
            "findings": [
              {
                "id": "powers-finding",
                "name": "Powers",
                "description": "Powers.",
                "questions": [
                  {
                    "text": "What powers does this division have under the constitution?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is it autonomous or special?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "disputed",
            "name": "Disputed",
            "description": "Contested areas.",
            "findings": [
              {
                "id": "disputed-finding",
                "name": "Disputed",
                "description": "Disputed areas.",
                "questions": [
                  {
                    "text": "Is this division disputed or not recognised by some states?",
                    "kind": "boundary"
                  },
                  {
                    "text": "How should different positions be attributed?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "history",
        "name": "History",
        "description": "Changes.",
        "rationale": "Divisions change.",
        "layers": [
          {
            "id": "reforms",
            "name": "Reforms",
            "description": "Reorganisations.",
            "findings": [
              {
                "id": "reforms-finding",
                "name": "Reforms",
                "description": "Reorganisations.",
                "questions": [
                  {
                    "text": "Has this division been created, merged or renamed, and when?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which code changes followed?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "historical",
            "name": "Historical",
            "description": "Former divisions.",
            "findings": [
              {
                "id": "historical-finding",
                "name": "Historical",
                "description": "Historical divisions.",
                "questions": [
                  {
                    "text": "What historical first-level divisions existed here, according to historians?",
                    "kind": "provenance"
                  },
                  {
                    "text": "How do they map to current units?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "data",
        "name": "Data",
        "description": "Statistics.",
        "rationale": "Data use divisions.",
        "layers": [
          {
            "id": "stats",
            "name": "Stats",
            "description": "Official statistics.",
            "findings": [
              {
                "id": "stats-finding",
                "name": "Stats",
                "description": "Statistics.",
                "questions": [
                  {
                    "text": "Which statistics are published at this level?",
                    "kind": "provenance"
                  },
                  {
                    "text": "For which year?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "maps",
            "name": "Maps",
            "description": "Boundary data.",
            "findings": [
              {
                "id": "maps-finding",
                "name": "Maps",
                "description": "Boundary data.",
                "questions": [
                  {
                    "text": "Where can official boundary data be downloaded?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Under what licence?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "openQuestions": [
    "Should each country list be a separate entry?",
    "How should ISO updates be tracked?",
    "How should historical divisions be linked?"
  ],
  "statistics": {
    "bundles": 4,
    "layers": 8,
    "findings": 8,
    "questions": 16
  }
}
