{
  "protocol": "OIP",
  "version": "1.2.0",
  "kind": "knowledge-action-invocation",
  "key": "DESIGN_LAW",
  "input": null,
  "identity": {
    "id": "kao:design-law",
    "slug": "design-law",
    "key": "DESIGN_LAW",
    "title": "The Laws of Design",
    "class": "law"
  },
  "object_version": "1.2.0",
  "contract": {
    "directory_key": "DESIGN_LAW",
    "contract": "Apply the complete Design Law to the named surface and return removals, hierarchy, rhythm, disclosures, interoperability, and proof.",
    "args": {
      "surface": "string or URL",
      "task": "audit|design|refactor|validate"
    },
    "effects": "Read-only unless the caller separately authorizes edits."
  },
  "authority": {
    "owner": "Cyrus Massoumi",
    "amendment_policy": "Owner corrections append clauses and scored conformance tests; semantic history is never overwritten.",
    "public_read": true,
    "mutation": "owner-authorized"
  },
  "representations": {
    "article": {
      "route": "/a/design-law",
      "audience": "human reader",
      "role": "explain meaning",
      "media_type": "text/html"
    },
    "markdown": {
      "route": "/api/articles/design-law?format=markdown",
      "audience": "human or model reader",
      "role": "portable explanation",
      "media_type": "text/markdown"
    },
    "json": {
      "route": "/api/articles/design-law",
      "audience": "software",
      "role": "transport the complete typed object",
      "media_type": "application/json"
    },
    "directory": {
      "route": "/api/directory/DESIGN_LAW",
      "audience": "router or operator",
      "role": "discover identity and contract",
      "media_type": "application/json"
    },
    "skill": {
      "route": "/api/articles/design-law/skill",
      "audience": "LLM",
      "role": "teach behavior",
      "media_type": "text/markdown"
    },
    "oip_contract": {
      "route": "/api/dispatch?key=DESIGN_LAW",
      "audience": "agent or protocol client",
      "role": "discover authority and invocation",
      "media_type": "application/json"
    },
    "invoke": {
      "route": "/api/dispatch?invoke=DESIGN_LAW",
      "audience": "authorized agent or protocol client",
      "role": "execute behavior and return proof",
      "media_type": "application/json"
    },
    "graph": {
      "route": "/api/articles/design-law/voxels",
      "audience": "graph client",
      "role": "traverse relationships",
      "media_type": "application/json"
    },
    "versions": {
      "route": "/api/articles/design-law/versions",
      "audience": "auditor",
      "role": "inspect amendment lineage",
      "media_type": "application/json"
    },
    "conformance": {
      "route": "/api/articles/design-law/conformance",
      "audience": "test runner or critic",
      "role": "falsify claims and prescribe repair",
      "media_type": "application/json"
    }
  },
  "result": {
    "decision_mandate": [
      "Does it aid clarity or orientation?",
      "Does it provide a material benefit?",
      "Does it relieve a material detriment?",
      "If every answer is no, remove it."
    ],
    "procedure": [
      "Inventory visible objects and repeated words.",
      "Remove every object that fails the decision mandate.",
      "Name the smallest useful hierarchy and current location.",
      "Apply one recursive type, color, measure, spacing, and component grammar.",
      "Establish the repeating editorial cadence.",
      "Collapse every optional complexity layer.",
      "Generate interoperable representations from this canonical object.",
      "Validate readability, links, SEO, responsiveness, source direction, and conformance."
    ],
    "output": [
      "removals",
      "hierarchy",
      "rhythm",
      "disclosures",
      "interoperability",
      "proof"
    ],
    "repair": "Remove the violating object or amend the canonical clause, regenerate every representation, and rerun conformance."
  },
  "proof": {
    "conformance": "/api/articles/design-law/conformance",
    "graph": "/api/articles/design-law/voxels",
    "versions": "/api/articles/design-law/versions",
    "provenance": "/api/ledger?object=DESIGN_LAW"
  }
}