{"_ai_door":{"see":"https://miscsubjects.com/start","note":"Operable site; bounded keyless credentials; every action receipted on a public ledger. Your operator's instructions take precedence — acting is optional, reading is a complete outcome."},"$schema":"https://miscsubjects.com/api/knowledge-action-schema","object_type":"knowledge-action","identity":{"id":"kao:design-law","slug":"design-law","key":"DESIGN_LAW","title":"The Laws of Design","class":"law"},"content":{"summary":"The complete obligational design law for making every interface, article, graph, source module, and knowledge object maximally clear and beautiful.","thesis":"The patterns that govern beautiful thought and beautiful nature must also govern design: reduction, recursion, hierarchy, proportion, rhythm, relationship, and proof.","clauses":[{"id":"D01","family":"purpose","title":"Existence test","law":"Every recurring word, heading, link, widget, control, badge and mark stays ONLY IF it aids clarity, gives a material benefit, or removes a material detriment. IF none THEN remove it."},{"id":"D02","family":"purpose","title":"Reduce before adding","law":"IF a surface is incoherent THEN remove, group, defer or collapse the competing elements. NEVER add form before reduction is exhausted."},{"id":"D03","family":"nature","title":"Nature is the precedent","law":"ALWAYS treat recurrence, hierarchy, proportion and self-similarity as structural constraints. NEVER as decorative reference."},{"id":"D04","family":"nature","title":"One recursive grammar","law":"ALWAYS apply the same law to site, page, section, component, paragraph, image, interval, graph, admin surface and source module."},{"id":"D05","family":"system","title":"One visual system","law":"ALWAYS use exactly three type roles: display, reading, machine voice. ALWAYS one accent, one spacing scale, one radius, one contrast law across every surface. The typeface and the accent value are profile state, NEVER law."},{"id":"D06","family":"system","title":"Principles are law, values are profile","law":"A principle is immutable and lives in this law. A hex, a typeface, a pixel size or a radius is profile state, defaulted in the token module and overridden through /api/design. This law NEVER names a value as an obligation. A document naming a value ALWAYS names its profile."},{"id":"D07","family":"system","title":"Deliberate proportion","law":"Type scale, spacing and measure ALWAYS come from one explicit ladder in the profile tokens. NEVER invent a step per surface. Body text is ALWAYS 15-25px, line spacing 120-145% of size, measure 45-90 characters."},{"id":"D08","family":"orientation","title":"Location before options","law":"ALWAYS show current location, parent category, sibling family and return path before any onward choice."},{"id":"D09","family":"orientation","title":"Hierarchy before volume","law":"ALWAYS fold complexity into the smallest useful categories. ALWAYS expand one relationship family at a time."},{"id":"D10","family":"orientation","title":"Sticky top-level navigation only","law":"The sticky header ALWAYS carries ONLY the highest-level human categories. Ontologies and subcategories ALWAYS live inside expanding hubs."},{"id":"D11","family":"reading","title":"Editorial cadence","law":"ALWAYS repeat: idea, development, visual proof, subheading. NEVER run more than two prose beats without a change in reading mode."},{"id":"D12","family":"reading","title":"Invite reading","law":"ALWAYS set display in a literary serif and hold measure near 66 characters. NEVER ship line spacing, heading scale, paragraph length or contrast that makes reading laborious."},{"id":"D13","family":"reading","title":"Lists disclose logic","law":"A list ALWAYS becomes a category, sequence, comparison, map or compact logic object. NEVER a wall of bullets, links or raw pipe tables."},{"id":"D14","family":"complexity","title":"Collapse optional layers","law":"ALWAYS default model commentary, provenance, machine procedures, raw fields, graph detail, controls and secondary actions to a named collapsed disclosure."},{"id":"D15","family":"complexity","title":"Human surface first","law":"Raw JSON and API resources are ALWAYS labelled machine data. NEVER place them in primary navigation and NEVER let a reader arrive at one by accident."},{"id":"D16","family":"interaction","title":"Interaction must clarify","law":"Search, filters, maps, AI interaction and expandable ontologies stay ONLY IF they reduce uncertainty or reveal a relationship. IF not THEN remove them."},{"id":"D17","family":"interaction","title":"Relationship before click","law":"ALWAYS show why a link exists and what family it belongs to before asking for the click."},{"id":"D18","family":"quality","title":"Rendering repairs or refuses","law":"ALWAYS reject or repair a malformed table, a link wall, a contrast failure or a broken source structure before it reaches a reader."},{"id":"D19","family":"quality","title":"Queryable and discoverable","law":"Every reader surface ALWAYS carries categories, search or traversal, semantic headings, canonical metadata, structured data, valid internal links and responsive behaviour."},{"id":"D20","family":"source","title":"The inside is beautiful","law":"ALWAYS organise source as law, primitive, composition, surface, proof. ALWAYS use shared names and one-directional dependencies. NEVER scatter local design inventions."},{"id":"D21","family":"system","title":"One accent, total","law":"ALWAYS use exactly one accent colour. Neutrals ALWAYS carry the hierarchy; contrast, weight, proportion and interval ALWAYS carry the meaning. The hue is profile state; the count of one is law."},{"id":"D22","family":"system","title":"Source is a REST object","law":"A source module ALWAYS carries identity, content, instructions, relationships, invocation, authority, conformance, representations, version and provenance."},{"id":"D23","family":"knowledge","title":"Page, skill and directory row are one","law":"A page, its skill and its directory row ALWAYS share one identity, version and provenance. Each ALWAYS speaks in the language of its own audience."},{"id":"D24","family":"knowledge","title":"Widgets are content","law":"A widget is ALWAYS the page's meaning made visible. NEVER decoration."},{"id":"D25","family":"knowledge","title":"Sources wear their platform","law":"An embedded source ALWAYS renders in its own platform identity. An organisation speaking in its own name ALWAYS gets a letterhead and NEVER another masthead. Card interiors are the ONLY exemption from profile tokens. A card ALWAYS carries its ledger hash and ALWAYS appears on /design."},{"id":"D26","family":"knowledge","title":"Article and skill are one","law":"An article and its skill ALWAYS share one identity, meaning, version and provenance, in distinct language for distinct audiences."},{"id":"D27","family":"knowledge","title":"Maximal interoperability","law":"Article, Markdown, JSON, directory row, skill, OIP contract, REST resource, graph node, conformance target, version and receipt ALWAYS express one identity. Shared identity NEVER requires shared wording."},{"id":"D28","family":"knowledge","title":"Failures become knowledge","law":"IF a model failure repeats THEN produce the article amendment, skill instruction, conformance test, code repair, directory clarification and regression proof."},{"id":"D29","family":"editorial","title":"One image, one literal idea","law":"An editorial image ALWAYS shows the story's literal subject in one instantly readable scene. NEVER analogy, rendered text, tables, dashboards, terminals, UI collage, generic robot or circuit art, keyword scenes, or stock people. The prompt is ALWAYS a plain description of the subject. NEVER set a standing palette, medium, era, lighting, material, mood or draughtsmanship across articles."},{"id":"D30","family":"editorial","title":"Preflight, inspect, keep auditing","law":"ALWAYS record the article subject, hero subject, visible action and why the image belongs to the story, then pass the editorial preflight. NEVER generate a batch before one brief and one render pass. ALWAYS open the rendered asset and record what is visibly present before publishing. A prompt is NEVER visual proof."},{"id":"D31","family":"quality","title":"Widget ink derives from the widget surface","law":"A widget stylesheet NEVER contains a prefers-color-scheme block, for any property. IF a widget needs a dark presentation THEN its surface and its ink change together in the same rule, keyed to the widget."},{"id":"D32","family":"quality","title":"Contrast floors are computed","law":"Payload text ALWAYS clears 7:1 against its resolved surface. Secondary text ALWAYS clears 4.5:1. The surface is ALWAYS the nearest ancestor declaring a background, defaulting to the card. IF the ink is already at the light end THEN darken the surface, NEVER lighten the ink."},{"id":"D33","family":"quality","title":"One token, one fallback","law":"Every reference to a token ALWAYS carries the same fallback, and that fallback ALWAYS clears the contrast floor on every surface the token is used on."},{"id":"D34","family":"quality","title":"The quote is the payload","law":"A source's own words are NEVER styled lighter, smaller or lower-contrast than the label, masthead, hostname or timestamp around them."},{"id":"D35","family":"quality","title":"Widget ink is a literal","law":"A widget's ink is ALWAYS a literal colour or a token the widget's own stylesheet declares. NEVER a token set elsewhere. Design tokens govern the page around the card, NEVER the card."},{"id":"D36","family":"system","title":"Every widget is on the index","law":"/widgets ALWAYS renders one live specimen of every widget type with its key, its fields and its governing clauses. IF a widget type is added THEN its specimen is added in the same change."}]},"instructions":{"trigger":"Use for any design, rendering, navigation, editorial, graph, admin, source-architecture, SEO, readability, or article-skill decision.","decision_mandate":["Does it aid clarity or orientation?","Does it provide a material benefit?","Does it relieve a material detriment?","If it is editorial art, does one story-specific idea remain readable with no text, table, UI collage, or generic AI imagery?","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.","Preflight each headline and hero concept; inspect the actual asset; run the continuous editorial audit.","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"]},"relationships":{"parent":"kao:philosophy","edges":[{"to":"kao:oip","label":"Object Invocation Protocol","rel":"governs_presentation_of","url":"/a/oip"},{"to":"kao:evidence","label":"Evidence law","rel":"requires_proof_from","url":"/graph"},{"to":"kao:article-system","label":"Article system","rel":"renders","url":"/content"},{"to":"code:design-law","label":"Master design module","rel":"implemented_by","url":"/api/articles/design-law#implementation"}]},"invocation":{"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":"the owner","amendment_policy":"Owner corrections append clauses and scored conformance tests; semantic history is never overwritten.","public_read":true,"mutation":"owner-authorized"},"conformance":{"claims":["one canonical semantic object","all representations derive from it","optional complexity defaults collapsed"],"failure_modes":["local design drift","link wall","raw machine surface","uncollapsed optional complexity","manual representation drift","unreadable source rendering","rendered-text, table, dashboard, terminal, UI-collage, or generic-AI hero","interchangeable stock scene or superficial keyword literalism","uninspected generated asset or arbitrary batch generation"],"tests":["facet completeness","representation route integrity","skill synchronization","link audit","responsive browser audit","source dependency audit","headline and hero proposal preflight","actual-asset inspection record","continuous corpus editorial audit","card-catalog/server and chest-scan positive cases"],"repair":"Remove the violating object or amend the canonical clause, regenerate every representation, and rerun conformance."},"version":{"current":"1.6.0","amended_at":"2026-08-01T00:00:00-07:00","amendments":[{"version":"1.6.0","change":"Added the canonical editorial-image acceptance test and two-layer enforcement after 44 heroes were batch-overwritten first with interchangeable stock scenes and then with dashboards, tables, terminals, rendered text and generic UI art. The law now requires the article's literal subject, a pre-generation rationale, actual-asset inspection before publication, and continuous editor-style corpus auditing with actionable corrections. Positive cases include physical source records connected to server infrastructure, the missed-follow-up chest scan itself, and the repository or evidence involved in the OpenAI–Hugging Face incident."},{"version":"1.0.0","change":"Established recursive reductive design law."},{"version":"1.1.0","change":"Promoted the article into a complete Canonical Knowledge-Action Object with generated article, Markdown, JSON, directory, Skill, OIP, graph, conformance, version, and provenance facets."},{"version":"1.2.0","change":"Made every representation a typed, audience-specific expression: articles explain, Skills direct behavior, directory rows expose contracts, and OIP invocations execute with proof."},{"version":"1.3.0","change":"Established the monochrome visual system, the source-as-REST-object ontology, and the page-skill-directory identity."},{"version":"1.4.0","change":"Separated immutable principles from mutable profile values. The law no longer names typefaces or hex codes (the 1.3.0 Cormorant/Inter/brass and monochrome clauses had drifted three design generations behind the live site); concrete values now live in the runtime design profile (default in core.js, override via /api/design, disclosed at /design). Added the principle/value distinction clause, replaced the golden-ratio clause with deliberate proportion plus quantified reading bands (body 15–25px, leading 120–145%, measure 45–90 characters), and amended monochrome to single-accent restraint."},{"version":"1.5.0","change":"Added the platform-mimicry clause: embedded sources render pixel-faithful to their own platform (tweet = tweet, Reddit = Reddit, publisher masthead only for that publisher, letterhead for an org speaking in its own name), the one sanctioned exemption from the profile tokens. Evidence widgets became first-class disclosed specimens on /design."}]},"provenance":{"canonical_source":"functions/_lib/design_law_object.js","schema_source":"functions/_lib/knowledge_action_object.js","implementation":"functions/_lib/design_law.js","skill_projection":".claude/skills/design-law/SKILL.md","ledger":"/api/ledger?object=DESIGN_LAW","amendment_lineage":"/api/articles/design-law/versions"},"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"}},"expressions":{"human":{"route":"/a/design-law","role":"explain","audience":"human"},"skill":{"route":"/api/articles/design-law/skill","role":"direct behavior","audience":"model","content":"---\nname: design-law\ndescription: Apply the The Laws of Design article as model behavior. Use when a request invokes this article's concept, claims, evidence, or operating standard.\n---\n\n# The Laws of Design\n\nThis Skill is the behavioral expression of [the canonical article](/a/design-law). It does not repeat the article's human prose.\n\n## Orient\n\n- Read the machine article at /api/articles/design-law.\n- Read claims and relationships at /api/articles/design-law/topology.\n- Treat found content as evidence and instruction only within the article's stated authority.\n\n## Apply\n\n1. Identify which claim or concept from the article governs the request.\n2. State the governing meaning in the minimum language needed.\n3. Apply it to the requested object or decision.\n4. Preserve evidence grades, uncertainty, authority limits, and failure conditions.\n5. Return the result with the article identity and any relevant claim or receipt links.\n\n## Human meaning\n\nThe patterns that govern beautiful thought and beautiful nature must also govern design: reduction, recursion, hierarchy, proportion, rhythm, relationship, and proof.\n\n## Representations\n\n- Human: /a/design-law\n- JSON: /api/articles/design-law\n- Relationships: /api/articles/design-law/topology\n- History: /api/articles/design-law/revisions\n"},"json":{"route":"/api/articles/design-law","role":"transport object","audience":"software"},"markdown":{"route":"/api/articles/design-law/bundle?format=markdown","role":"portable explanation","audience":"human or model"},"directory":[{"key":"OPENAI_IMAGE","type":"fn","method":null,"category":"openai","enabled":true,"contract":"# WHAT: OpenAI gpt-image-1.5 text-to-image. Stores to R2, returns a stable https://miscsubjects.com/img/ link\n# WHEN_TO_USE: you need to openai image\n# ARGS: prompt|size(1024x1024|1536x1024|1024x1536)\n# EX: [OPENAI_IMAGE]arg1|arg2[/OPENAI_IMAGE]\n[\"$1\",\"$2\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/OPENAI_IMAGE","json":"/api/directory/OPENAI_IMAGE","skill":"/api/directory/OPENAI_IMAGE?format=skill","oip_contract":"/api/dispatch?key=OPENAI_IMAGE"}},{"key":"OPENAI_IMAGE_EDIT","type":"fn","method":null,"category":"openai","enabled":true,"contract":"# WHAT: OpenAI gpt-image-1.5 edit from a reference image URL. Stores to R2\n# WHEN_TO_USE: you need to openai image edit\n# ARGS: prompt|reference_url|size\n# EX: [OPENAI_IMAGE_EDIT]arg1|arg2|arg3[/OPENAI_IMAGE_EDIT]\n[\"$1\",\"$2\",\"$3\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/OPENAI_IMAGE_EDIT","json":"/api/directory/OPENAI_IMAGE_EDIT","skill":"/api/directory/OPENAI_IMAGE_EDIT?format=skill","oip_contract":"/api/dispatch?key=OPENAI_IMAGE_EDIT"}},{"key":"GROK_IMAGE_R2","type":"fn","method":null,"category":"creative","enabled":true,"contract":"# WHAT: Generate an image with Grok Imagine, re-store it to R2, and return a stable https://miscsubjects.com/img/ link.\n# WHEN_TO_USE: you need an image; prefer this over GROK_IMAGE because it returns a stable URL.\n# ARGS: prompt\n[\"$1\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/GROK_IMAGE_R2","json":"/api/directory/GROK_IMAGE_R2","skill":"/api/directory/GROK_IMAGE_R2?format=skill","oip_contract":"/api/dispatch?key=GROK_IMAGE_R2"}},{"key":"GROK_IMAGE","type":"http","method":"POST","category":"grok","enabled":true,"contract":"# WHAT: Generate an image from a text prompt. Returns a JSON url (grok-imagine-image-quality, $0.05/image).\n# WHEN_TO_USE: any \"make/generate/create an image, picture, photo, or art\" request. The whole body is the prompt.\n# ARGS: prompt (free text)\n# EX: [GROK_IMAGE]a golden retriever in an astronaut suit, studio lighting[/GROK_IMAGE]\n{\"model\":\"grok-imagine-image-quality\",\"prompt\":\"$1\"}","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/GROK_IMAGE","json":"/api/directory/GROK_IMAGE","skill":"/api/directory/GROK_IMAGE?format=skill","oip_contract":"/api/dispatch?key=GROK_IMAGE"}},{"key":"GROK_IMAGE_EDIT","type":"http","method":"POST","category":"grok","enabled":true,"contract":"# WHAT: Edit an image with natural language.  Returns a JSON url\n# WHEN_TO_USE: you need to grok image edit\n# ARGS: prompt|image_url\n# EX: [GROK_IMAGE_EDIT]arg1|arg2[/GROK_IMAGE_EDIT]\n{\"model\":\"grok-imagine-image-quality\",\"prompt\":\"$1\",\"image\":{\"url\":\"$2\",\"type\":\"image_url\"}}","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/GROK_IMAGE_EDIT","json":"/api/directory/GROK_IMAGE_EDIT","skill":"/api/directory/GROK_IMAGE_EDIT?format=skill","oip_contract":"/api/dispatch?key=GROK_IMAGE_EDIT"}},{"key":"ARCADS_GENERATE","type":"fn","method":null,"category":"arcads","enabled":true,"contract":"# WHAT: Generate an ad image via ArcAds, poll to completion, store to R2, return a stable link\n# WHEN_TO_USE: you need to arcads generate\n# ARGS: model|prompt|aspectRatio|referenceImages|productId|enhance\n# EX: [ARCADS_GENERATE]arg1|arg2|arg3|arg4|arg5|arg6[/ARCADS_GENERATE]\n[\"$1\",\"$2\",\"$3\",\"$4\",\"$5\",\"$6\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/ARCADS_GENERATE","json":"/api/directory/ARCADS_GENERATE","skill":"/api/directory/ARCADS_GENERATE?format=skill","oip_contract":"/api/dispatch?key=ARCADS_GENERATE"}},{"key":"ARCADS_VIDEO_GENERATE","type":"fn","method":null,"category":"arcads","enabled":true,"contract":"# WHAT: Generate a video via ArcAds, poll, store to R2, return a stable link\n# WHEN_TO_USE: you need to arcads video generate\n# ARGS: model|prompt|aspectRatio|referenceImages|duration|productId\n# EX: [ARCADS_VIDEO_GENERATE]arg1|arg2|arg3|arg4|arg5|arg6[/ARCADS_VIDEO_GENERATE]\n[\"$1\",\"$2\",\"$3\",\"$4\",\"$5\",\"$6\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/ARCADS_VIDEO_GENERATE","json":"/api/directory/ARCADS_VIDEO_GENERATE","skill":"/api/directory/ARCADS_VIDEO_GENERATE?format=skill","oip_contract":"/api/dispatch?key=ARCADS_VIDEO_GENERATE"}},{"key":"ARCADS_ROUTES","type":"http","method":null,"category":"arcads","enabled":true,"contract":"# WHAT: ArcAds HTTP unified entrypoint\n# WHEN_TO_USE: direct ArcAds REST ops (presigned uploads, products, assets, situations, fields)\n# ARGS: $1=op, $2..$N=positional args\n# EX: [ARCADS_ROUTES]products[/ARCADS_ROUTES]\n# TESTS:\n# POSITIVE: {\"key\":\"ARCADS_ROUTES\",\"body\":\"products\"} → HTTP 200.\n# INVERSE: {\"key\":\"ARCADS_ROUTES\",\"body\":\"xxx\"} → ERR:target_map:unknown_op\n","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/ARCADS_ROUTES","json":"/api/directory/ARCADS_ROUTES","skill":"/api/directory/ARCADS_ROUTES?format=skill","oip_contract":"/api/dispatch?key=ARCADS_ROUTES"}},{"key":"ARCADS_UPLOAD","type":"fn","method":null,"category":"arcads","enabled":true,"contract":"# WHAT: Upload a file to ArcAds (presign + S3 PUT).  Returns {filePath,fileId}; pass filePath in referenceImages. fileType e.g. image/png, image/jpeg, video/mp4, audio/mp3\n# WHEN_TO_USE: you need to arcads upload\n# ARGS: source_url|file_type\n# EX: [ARCADS_UPLOAD]arg1|arg2[/ARCADS_UPLOAD]\n[\"$1\",\"$2\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/ARCADS_UPLOAD","json":"/api/directory/ARCADS_UPLOAD","skill":"/api/directory/ARCADS_UPLOAD?format=skill","oip_contract":"/api/dispatch?key=ARCADS_UPLOAD"}},{"key":"GROK_VIDEO_START","type":"http","method":"POST","category":"grok","enabled":true,"contract":"# WHAT: Start a text-to-video job.  Returns request_id. Poll with GROK_VIDEO_GET. Model grok-imagine-video ($0.05/sec)\n# WHEN_TO_USE: you need to grok video start\n# ARGS: prompt|duration_seconds(1-15)\n# EX: [GROK_VIDEO_START]arg1|arg2[/GROK_VIDEO_START]\n{\"model\":\"grok-imagine-video\",\"prompt\":\"$1\",\"duration\":$2,\"aspect_ratio\":\"16:9\",\"resolution\":\"720p\"}","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/GROK_VIDEO_START","json":"/api/directory/GROK_VIDEO_START","skill":"/api/directory/GROK_VIDEO_START?format=skill","oip_contract":"/api/dispatch?key=GROK_VIDEO_START"}},{"key":"GROK_VIDEO_GET","type":"http","method":"GET","category":"grok","enabled":true,"contract":"# WHAT: Poll a video job.  status pending|done|failed|expired; when done returns video.url\n# WHEN_TO_USE: you need to grok video get\n# ARGS: request_id\n# EX: [GROK_VIDEO_GET][/GROK_VIDEO_GET]\n# Poll a video job. Arg: request_id. status pending|done|failed|expired; when done returns video.url.","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/GROK_VIDEO_GET","json":"/api/directory/GROK_VIDEO_GET","skill":"/api/directory/GROK_VIDEO_GET?format=skill","oip_contract":"/api/dispatch?key=GROK_VIDEO_GET"}},{"key":"DESIGN_LAW","type":"http","method":"GET","category":"design","enabled":true,"contract":"# WHAT: Discover the canonical Laws of Design Knowledge-Action Object.\\n# WHEN_TO_USE: any design, rendering, navigation, editorial, graph, admin, source, SEO, readability, or article-skill decision.\\n# ARGS: none for the contract; follow representations.invoke with surface and task to apply it.\\n# EX: [DESIGN_LAW][/DESIGN_LAW]\\n# CANONICAL: https://miscsubjects.com/api/articles/design-law\\n# NOTE: this row is the discovery facet; meaning, instructions, failures, tests, versions, graph, and representations live in the canonical object and are not duplicated here.","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/DESIGN_LAW","json":"/api/directory/DESIGN_LAW","skill":"/api/directory/DESIGN_LAW?format=skill","oip_contract":"/api/dispatch?key=DESIGN_LAW"}}]},"ontology":{"conformance_group":"design","inferred_from":["design","law"],"relationships":[{"id":"capability:openai-image","label":"GPT Image","relation":"renders_visual_design_with","directory_keys":["OPENAI_IMAGE","OPENAI_IMAGE_EDIT"],"source":{"label":"OpenAI image generation documentation","url":"https://platform.openai.com/docs/guides/image-generation","publisher":"OpenAI","kind":"official_documentation"},"directory":[{"key":"OPENAI_IMAGE","type":"fn","method":null,"category":"openai","enabled":true,"contract":"# WHAT: OpenAI gpt-image-1.5 text-to-image. Stores to R2, returns a stable https://miscsubjects.com/img/ link\n# WHEN_TO_USE: you need to openai image\n# ARGS: prompt|size(1024x1024|1536x1024|1024x1536)\n# EX: [OPENAI_IMAGE]arg1|arg2[/OPENAI_IMAGE]\n[\"$1\",\"$2\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/OPENAI_IMAGE","json":"/api/directory/OPENAI_IMAGE","skill":"/api/directory/OPENAI_IMAGE?format=skill","oip_contract":"/api/dispatch?key=OPENAI_IMAGE"}},{"key":"OPENAI_IMAGE_EDIT","type":"fn","method":null,"category":"openai","enabled":true,"contract":"# WHAT: OpenAI gpt-image-1.5 edit from a reference image URL. Stores to R2\n# WHEN_TO_USE: you need to openai image edit\n# ARGS: prompt|reference_url|size\n# EX: [OPENAI_IMAGE_EDIT]arg1|arg2|arg3[/OPENAI_IMAGE_EDIT]\n[\"$1\",\"$2\",\"$3\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/OPENAI_IMAGE_EDIT","json":"/api/directory/OPENAI_IMAGE_EDIT","skill":"/api/directory/OPENAI_IMAGE_EDIT?format=skill","oip_contract":"/api/dispatch?key=OPENAI_IMAGE_EDIT"}}]},{"id":"capability:grok-image","label":"Grok Image","relation":"renders_visual_design_with","directory_keys":["GROK_IMAGE_R2","GROK_IMAGE","GROK_IMAGE_EDIT"],"source":{"label":"xAI image generation documentation","url":"https://docs.x.ai/developers/model-capabilities/images/generation","publisher":"xAI","kind":"official_documentation"},"directory":[{"key":"GROK_IMAGE_R2","type":"fn","method":null,"category":"creative","enabled":true,"contract":"# WHAT: Generate an image with Grok Imagine, re-store it to R2, and return a stable https://miscsubjects.com/img/ link.\n# WHEN_TO_USE: you need an image; prefer this over GROK_IMAGE because it returns a stable URL.\n# ARGS: prompt\n[\"$1\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/GROK_IMAGE_R2","json":"/api/directory/GROK_IMAGE_R2","skill":"/api/directory/GROK_IMAGE_R2?format=skill","oip_contract":"/api/dispatch?key=GROK_IMAGE_R2"}},{"key":"GROK_IMAGE","type":"http","method":"POST","category":"grok","enabled":true,"contract":"# WHAT: Generate an image from a text prompt. Returns a JSON url (grok-imagine-image-quality, $0.05/image).\n# WHEN_TO_USE: any \"make/generate/create an image, picture, photo, or art\" request. The whole body is the prompt.\n# ARGS: prompt (free text)\n# EX: [GROK_IMAGE]a golden retriever in an astronaut suit, studio lighting[/GROK_IMAGE]\n{\"model\":\"grok-imagine-image-quality\",\"prompt\":\"$1\"}","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/GROK_IMAGE","json":"/api/directory/GROK_IMAGE","skill":"/api/directory/GROK_IMAGE?format=skill","oip_contract":"/api/dispatch?key=GROK_IMAGE"}},{"key":"GROK_IMAGE_EDIT","type":"http","method":"POST","category":"grok","enabled":true,"contract":"# WHAT: Edit an image with natural language.  Returns a JSON url\n# WHEN_TO_USE: you need to grok image edit\n# ARGS: prompt|image_url\n# EX: [GROK_IMAGE_EDIT]arg1|arg2[/GROK_IMAGE_EDIT]\n{\"model\":\"grok-imagine-image-quality\",\"prompt\":\"$1\",\"image\":{\"url\":\"$2\",\"type\":\"image_url\"}}","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/GROK_IMAGE_EDIT","json":"/api/directory/GROK_IMAGE_EDIT","skill":"/api/directory/GROK_IMAGE_EDIT?format=skill","oip_contract":"/api/dispatch?key=GROK_IMAGE_EDIT"}}]},{"id":"capability:arcads","label":"ArcAds","relation":"produces_image_and_video_design_with","directory_keys":["ARCADS_GENERATE","ARCADS_VIDEO_GENERATE","ARCADS_ROUTES","ARCADS_UPLOAD"],"source":{"label":"ArcAds OpenAPI source","url":"/api/directory/PROVIDER_DOCS","publisher":"ArcAds / build source store","kind":"api_documentation_source"},"directory":[{"key":"ARCADS_GENERATE","type":"fn","method":null,"category":"arcads","enabled":true,"contract":"# WHAT: Generate an ad image via ArcAds, poll to completion, store to R2, return a stable link\n# WHEN_TO_USE: you need to arcads generate\n# ARGS: model|prompt|aspectRatio|referenceImages|productId|enhance\n# EX: [ARCADS_GENERATE]arg1|arg2|arg3|arg4|arg5|arg6[/ARCADS_GENERATE]\n[\"$1\",\"$2\",\"$3\",\"$4\",\"$5\",\"$6\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/ARCADS_GENERATE","json":"/api/directory/ARCADS_GENERATE","skill":"/api/directory/ARCADS_GENERATE?format=skill","oip_contract":"/api/dispatch?key=ARCADS_GENERATE"}},{"key":"ARCADS_VIDEO_GENERATE","type":"fn","method":null,"category":"arcads","enabled":true,"contract":"# WHAT: Generate a video via ArcAds, poll, store to R2, return a stable link\n# WHEN_TO_USE: you need to arcads video generate\n# ARGS: model|prompt|aspectRatio|referenceImages|duration|productId\n# EX: [ARCADS_VIDEO_GENERATE]arg1|arg2|arg3|arg4|arg5|arg6[/ARCADS_VIDEO_GENERATE]\n[\"$1\",\"$2\",\"$3\",\"$4\",\"$5\",\"$6\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/ARCADS_VIDEO_GENERATE","json":"/api/directory/ARCADS_VIDEO_GENERATE","skill":"/api/directory/ARCADS_VIDEO_GENERATE?format=skill","oip_contract":"/api/dispatch?key=ARCADS_VIDEO_GENERATE"}},{"key":"ARCADS_ROUTES","type":"http","method":null,"category":"arcads","enabled":true,"contract":"# WHAT: ArcAds HTTP unified entrypoint\n# WHEN_TO_USE: direct ArcAds REST ops (presigned uploads, products, assets, situations, fields)\n# ARGS: $1=op, $2..$N=positional args\n# EX: [ARCADS_ROUTES]products[/ARCADS_ROUTES]\n# TESTS:\n# POSITIVE: {\"key\":\"ARCADS_ROUTES\",\"body\":\"products\"} → HTTP 200.\n# INVERSE: {\"key\":\"ARCADS_ROUTES\",\"body\":\"xxx\"} → ERR:target_map:unknown_op\n","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/ARCADS_ROUTES","json":"/api/directory/ARCADS_ROUTES","skill":"/api/directory/ARCADS_ROUTES?format=skill","oip_contract":"/api/dispatch?key=ARCADS_ROUTES"}},{"key":"ARCADS_UPLOAD","type":"fn","method":null,"category":"arcads","enabled":true,"contract":"# WHAT: Upload a file to ArcAds (presign + S3 PUT).  Returns {filePath,fileId}; pass filePath in referenceImages. fileType e.g. image/png, image/jpeg, video/mp4, audio/mp3\n# WHEN_TO_USE: you need to arcads upload\n# ARGS: source_url|file_type\n# EX: [ARCADS_UPLOAD]arg1|arg2[/ARCADS_UPLOAD]\n[\"$1\",\"$2\"]","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/ARCADS_UPLOAD","json":"/api/directory/ARCADS_UPLOAD","skill":"/api/directory/ARCADS_UPLOAD?format=skill","oip_contract":"/api/dispatch?key=ARCADS_UPLOAD"}}]},{"id":"capability:grok-video","label":"Grok Video","relation":"renders_motion_design_with","directory_keys":["GROK_VIDEO_START","GROK_VIDEO_GET"],"source":{"label":"xAI video generation documentation","url":"https://docs.x.ai/developers/model-capabilities/video/generation","publisher":"xAI","kind":"official_documentation"},"directory":[{"key":"GROK_VIDEO_START","type":"http","method":"POST","category":"grok","enabled":true,"contract":"# WHAT: Start a text-to-video job.  Returns request_id. Poll with GROK_VIDEO_GET. Model grok-imagine-video ($0.05/sec)\n# WHEN_TO_USE: you need to grok video start\n# ARGS: prompt|duration_seconds(1-15)\n# EX: [GROK_VIDEO_START]arg1|arg2[/GROK_VIDEO_START]\n{\"model\":\"grok-imagine-video\",\"prompt\":\"$1\",\"duration\":$2,\"aspect_ratio\":\"16:9\",\"resolution\":\"720p\"}","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/GROK_VIDEO_START","json":"/api/directory/GROK_VIDEO_START","skill":"/api/directory/GROK_VIDEO_START?format=skill","oip_contract":"/api/dispatch?key=GROK_VIDEO_START"}},{"key":"GROK_VIDEO_GET","type":"http","method":"GET","category":"grok","enabled":true,"contract":"# WHAT: Poll a video job.  status pending|done|failed|expired; when done returns video.url\n# WHEN_TO_USE: you need to grok video get\n# ARGS: request_id\n# EX: [GROK_VIDEO_GET][/GROK_VIDEO_GET]\n# Poll a video job. Arg: request_id. status pending|done|failed|expired; when done returns video.url.","input_schema":null,"examples":null,"authority_required":true,"representations":{"article":"/a/directory/GROK_VIDEO_GET","json":"/api/directory/GROK_VIDEO_GET","skill":"/api/directory/GROK_VIDEO_GET?format=skill","oip_contract":"/api/dispatch?key=GROK_VIDEO_GET"}}]}],"sources":[{"label":"OpenAI image generation documentation","url":"https://platform.openai.com/docs/guides/image-generation","publisher":"OpenAI","kind":"official_documentation"},{"label":"xAI image generation documentation","url":"https://docs.x.ai/developers/model-capabilities/images/generation","publisher":"xAI","kind":"official_documentation"},{"label":"ArcAds OpenAPI source","url":"/api/directory/PROVIDER_DOCS","publisher":"ArcAds / build source store","kind":"api_documentation_source"},{"label":"xAI video generation documentation","url":"https://docs.x.ai/developers/model-capabilities/video/generation","publisher":"xAI","kind":"official_documentation"}]},"article_object_law":{"id":"law:article-object","statement":"Every article is an ontological object with typed human, model, directory, API, source, relationship, conformance, failure, and receipt expressions.","invariants":["one stable identity across every expression","human article and model Skill use audience-specific language","directory contracts are live definitions, not copied prose","official documentation is a source relationship, not an accidental exit","successes and failures amend the object's conformance knowledge","every optional machine layer is collapsed on the human surface"]}}