Artifact Design
Artifact design keeps top-level kinds semantic while letting each kind carry the data it needs.
How Readers Use This
- Choose artifact kinds by meaning, not file format alone.
- Use blobs for file-backed payloads and rendered outputs.
- Use links for relationships instead of burying them in kind-specific fields.
Working Model
Every artifact has common identity and metadata. Kind-specific data explains what the artifact means, blobs hold file-backed content, links connect it to other artifacts, and events show how it changed.
Media To Add
- Diagram: semantic artifact kind, kind data, blob slots, links, and events. It helps developers model new artifact workflows. Source: artifact detail model.