Skip to content

Agent skill for creative 3D visualization: turn an idea into a Three.js/Blender scene worth exploring. Claude Code + Codex plugin, 223 recipes, 440 knowledge records, 22 proved kits, 37 runnable studies.

17.0 KB
Raw Blame
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Reusable knowledge contract",
  "description": "Style, theme, lighting, composition, motion and presentation profiles are authored creative proposals, not historical definitions, fixed templates or required rendering libraries. No rendered artifact, runtime improvement or perceptual validation is implied by a record; appearance choices do not certify factual geometry, material measurements or simulated behavior. Inspect the selected view and an alternate view at the intended output size; adapt any proposal to the explicit user brief while preserving factual and interaction contracts.",
  "type": "object",
  "properties": {
    "schema_version": {
      "$ref": "recipe.schema.json#/properties/schema_version"
    },
    "revision": {
      "$ref": "recipe.schema.json#/properties/revision"
    },
    "status": {
      "$ref": "recipe.schema.json#/properties/status"
    },
    "record_kind": {
      "$ref": "recipe.schema.json#/properties/record_kind"
    },
    "title": {
      "$ref": "recipe.schema.json#/properties/title"
    },
    "aliases": {
      "$ref": "recipe.schema.json#/properties/aliases"
    },
    "direction_ids": {
      "$ref": "recipe.schema.json#/properties/direction_ids"
    },
    "summary": {
      "$ref": "recipe.schema.json#/properties/summary"
    },
    "objective": {
      "$ref": "recipe.schema.json#/properties/objective"
    },
    "claims": {
      "$ref": "recipe.schema.json#/properties/claims"
    },
    "defaults": {
      "$ref": "recipe.schema.json#/properties/defaults"
    },
    "tags": {
      "$ref": "recipe.schema.json#/properties/tags"
    },
    "subject_terms": {
      "$ref": "recipe.schema.json#/properties/subject_terms"
    },
    "intent_signals": {
      "$ref": "recipe.schema.json#/properties/intent_signals"
    },
    "example_prompts": {
      "$ref": "recipe.schema.json#/properties/example_prompts"
    },
    "negative_signals": {
      "$ref": "recipe.schema.json#/properties/negative_signals"
    },
    "not_for": {
      "$ref": "recipe.schema.json#/properties/not_for"
    },
    "creative_affordances": {
      "$ref": "recipe.schema.json#/properties/creative_affordances"
    },
    "known_limits": {
      "$ref": "recipe.schema.json#/properties/known_limits"
    },
    "id": {
      "type": "string",
      "pattern": "^knowledge\\.[a-z0-9]+(?:-[a-z0-9]+)*$"
    },
    "knowledge_kind": {
      "enum": [
        "object-archetype",
        "material-profile",
        "physical-behavior",
        "tool-adapter",
        "inspection-pattern",
        "validation-profile",
        "style-profile",
        "theme-profile",
        "presentation-profile",
        "composition-profile",
        "motion-profile",
        "interaction-profile",
        "reasoning-rule",
        "domain-validation",
        "geometry-profile",
        "lighting-profile",
        "output-profile",
        "blueprint"
      ]
    },
    "asset": {
      "type": "object",
      "properties": {
        "kind": {
          "enum": [
            "procedural-js",
            "gltf-asset"
          ]
        },
        "path": {
          "type": "string",
          "pattern": "^templates/kits/[a-z0-9/._-]+$"
        },
        "factory": {
          "type": "string",
          "pattern": "^[a-zA-Z_$][a-zA-Z0-9_$]*$"
        }
      },
      "required": [
        "kind",
        "path"
      ]
    },
    "params": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1
          },
          "type": {
            "enum": [
              "number",
              "integer",
              "boolean",
              "string",
              "color",
              "enum"
            ]
          },
          "range": {
            "description": "Advisory authored band for choosing a starting value; runtime code is not required to clamp to it.",
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "number"
            }
          },
          "default": {},
          "unit": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "type",
          "default"
        ],
        "allOf": [
          {
            "if": {
              "properties": {
                "type": {
                  "const": "number"
                }
              },
              "required": [
                "type"
              ]
            },
            "then": {
              "properties": {
                "default": {
                  "type": "number"
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "const": "integer"
                }
              },
              "required": [
                "type"
              ]
            },
            "then": {
              "properties": {
                "default": {
                  "type": "integer"
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "const": "boolean"
                }
              },
              "required": [
                "type"
              ]
            },
            "then": {
              "properties": {
                "default": {
                  "type": "boolean"
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "enum": [
                    "string",
                    "enum"
                  ]
                }
              },
              "required": [
                "type"
              ]
            },
            "then": {
              "properties": {
                "default": {
                  "type": "string"
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "type": {
                  "const": "color"
                }
              },
              "required": [
                "type"
              ]
            },
            "then": {
              "properties": {
                "default": {
                  "type": "string",
                  "pattern": "^#[0-9a-fA-F]{6}$"
                }
              }
            }
          },
          {
            "if": {
              "required": [
                "range"
              ]
            },
            "then": {
              "properties": {
                "type": {
                  "enum": [
                    "number",
                    "integer"
                  ]
                }
              }
            }
          }
        ]
      }
    },
    "sockets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1
          },
          "position_m": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "type": "number"
            }
          },
          "normal": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "type": "number"
            }
          }
        },
        "required": [
          "name",
          "position_m",
          "normal"
        ]
      }
    },
    "detail_ladder": {
      "type": "object",
      "properties": {
        "silhouette": {
          "type": "array",
          "minItems": 2,
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "medium": {
          "type": "array",
          "minItems": 2,
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "fine": {
          "type": "array",
          "minItems": 2,
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "required": [
        "silhouette",
        "medium",
        "fine"
      ]
    },
    "footprint_m": {
      "type": "array",
      "minItems": 2,
      "maxItems": 3,
      "items": {
        "type": "number",
        "exclusiveMinimum": 0
      }
    },
    "poly_budget": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "fits_looks": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "string",
        "pattern": "^knowledge\\.[a-z0-9]+(?:-[a-z0-9]+)*$"
      }
    },
    "proof": {
      "type": "object",
      "properties": {
        "harness": {
          "type": "string",
          "minLength": 1
        },
        "captures": {
          "type": "array",
          "minItems": 3,
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "log": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "harness",
        "captures",
        "log"
      ]
    },
    "tiers": {
      "description": "Quality tiers this blueprint can be built at: T0 blockout proxy, T2 the same module with runtime-generated surface and occlusion, T3 a baked glTF hero, T4 an external asset. T1 is the record's own asset and proof and is never written here. Documentation only: validate.py runs the hand-written contract in scripts/blueprint_validation.py.",
      "type": "object",
      "propertyNames": {
        "enum": [
          "T0",
          "T2",
          "T3",
          "T4"
        ]
      },
      "additionalProperties": {
        "type": "object",
        "properties": {
          "mode": {
            "enum": [
              "proxy",
              "runtime",
              "gltf",
              "external"
            ]
          },
          "status": {
            "enum": [
              "generated",
              "declared",
              "proved",
              "not-proved",
              "missing"
            ]
          },
          "note": {
            "type": "string",
            "minLength": 1
          },
          "poly_budget": {
            "$ref": "#/properties/poly_budget"
          },
          "size_m": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "type": "number",
              "exclusiveMinimum": 0
            }
          },
          "families": {
            "type": "object",
            "minProperties": 1,
            "propertyNames": {
              "pattern": "^#[0-9a-fA-F]{6}$"
            },
            "additionalProperties": {
              "enum": [
                "wood",
                "plaster",
                "stone",
                "roof-tile",
                "metal",
                "fabric",
                "fur"
              ]
            }
          },
          "texture_budget": {
            "type": "object",
            "properties": {
              "maps": {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              "resolution": {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              "families": {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              "format": {
                "type": "string",
                "enum": [
                  "jpeg",
                  "png",
                  "webp"
                ]
              }
            }
          },
          "ao": {
            "type": "object",
            "properties": {
              "samples": {
                "type": "integer",
                "exclusiveMinimum": 0
              },
              "radius_m": {
                "type": "number",
                "exclusiveMinimum": 0
              },
              "ground_dirt_m": {
                "type": "number",
                "exclusiveMinimum": 0
              }
            }
          },
          "asset": {
            "$ref": "#/properties/asset"
          },
          "proof": {
            "$ref": "#/properties/proof"
          },
          "built_by": {
            "type": "string",
            "description": "T3: the script that baked the asset, skill-relative (templates/kits/blender/...)."
          },
          "blender": {
            "type": "string",
            "description": "T3: Blender version the shipped asset was baked with."
          },
          "params_hash": {
            "type": "string",
            "pattern": "^[0-9a-f]{12}$",
            "description": "T3: first 12 hex of sha256(module bytes + canonical params + bake settings)."
          }
        },
        "required": [
          "mode",
          "status"
        ],
        "additionalProperties": false,
        "allOf": [
          {
            "if": {
              "required": [
                "mode"
              ],
              "properties": {
                "mode": {
                  "const": "proxy"
                }
              }
            },
            "then": {
              "required": [
                "size_m"
              ],
              "not": {
                "anyOf": [
                  {
                    "required": [
                      "asset"
                    ]
                  },
                  {
                    "required": [
                      "proof"
                    ]
                  }
                ]
              }
            }
          },
          {
            "if": {
              "required": [
                "mode"
              ],
              "properties": {
                "mode": {
                  "const": "runtime"
                }
              }
            },
            "then": {
              "required": [
                "families",
                "poly_budget"
              ],
              "not": {
                "required": [
                  "asset"
                ]
              }
            }
          },
          {
            "if": {
              "required": [
                "mode"
              ],
              "properties": {
                "mode": {
                  "const": "external"
                }
              }
            },
            "then": {
              "properties": {
                "status": {
                  "enum": [
                    "missing",
                    "declared"
                  ]
                }
              },
              "not": {
                "required": [
                  "asset"
                ]
              }
            }
          }
        ]
      }
    },
    "content": {
      "type": "object",
      "properties": {
        "principles": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "implementation": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "observable_checks": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "required": [
        "principles",
        "implementation",
        "observable_checks"
      ]
    },
    "related_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^(recipe|knowledge)\\.[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$"
      }
    },
    "applies_when": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "constraint_level": {
      "enum": [
        "advisory",
        "correctness"
      ]
    },
    "check_method": {
      "enum": [
        "analytic",
        "state",
        "geometry",
        "source",
        "interaction",
        "visual"
      ]
    }
  },
  "required": [
    "schema_version",
    "id",
    "revision",
    "status",
    "record_kind",
    "title",
    "aliases",
    "direction_ids",
    "summary",
    "objective",
    "knowledge_kind",
    "content"
  ],
  "allOf": [
    {
      "$ref": "recipe.schema.json#/allOf/0"
    },
    {
      "if": {
        "properties": {
          "knowledge_kind": {
            "const": "reasoning-rule"
          }
        }
      },
      "then": {
        "required": [
          "applies_when",
          "constraint_level"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "knowledge_kind": {
            "const": "domain-validation"
          }
        }
      },
      "then": {
        "required": [
          "applies_when",
          "check_method"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "knowledge_kind": {
            "const": "blueprint"
          }
        }
      },
      "then": {
        "required": [
          "asset",
          "params",
          "sockets",
          "detail_ladder",
          "footprint_m",
          "poly_budget",
          "fits_looks",
          "proof"
        ]
      }
    }
  ]
}