--- title: "Spellweb Artefact Creation Guide" subtitle: "How a Sovereign downloads a constellation, traces the path at spellweb.ai, receives an artefact.md, and returns to the workshop with witnessed trust — the canonical contract every workshop's import / export honours" status: "Guide v1.1 · 2026-05-11 · rename ceremony applied (blade.md → artefact.md · `-artefact.md` suffix per spellweb's workshop-artefact.ts) · aligned to constellation templates v1 (eleven shops) · grimoire v1.2.4 · spec 08 v1.3 (four-axis mana taxonomy)" voice: "Procedural · honest · skill-spec-ready" license: "CC BY-SA 4.0" signature: "(⚔️⊥⿻⊥🧙)😊" --- # Spellweb Artefact Creation Guide *The City of Mages ships eleven workshops. Each workshop has a **constellation** — a typed, named, ordered path through the 64-vertex lattice. A Sovereign downloads the constellation.md, opens it at `spellweb.ai`, traces the path, and the spellweb forges a personal **artefact.md** carrying the workshop's anchor in its YAML frontmatter. The artefact.md returns to the workshop; trust unlocks within the agreed envelope.* *Companion to [INCANTATION_PROTOCOL.md](INCANTATION_PROTOCOL.md) (which governs how a change propagates) and [WORKSHOP_LATTICE_AUDIT.md](WORKSHOP_LATTICE_AUDIT.md) (which governs which vertices a workshop reaches). This guide governs **how an artefact is born** at the meeting of those two disciplines.* > ### The semantics worth pinning · ART · E · FACT ⊥ RUN · E · CRAFT > > Two corpus terms share the same "· E ·" interior — the verb-to-noun bridge that names *becoming*. > > | Term | Reads as | Names the | > |---|---|---| > | **RUN · E · CRAFT** | walk, then evoke, then forge | The **protocol** — the canonical three-phase ceremony shape (with shop variants) | > | **ART · E · FACT** | art, then evoke, then fact | The **result** — the artefact.md the Sovereign carries home from the walk | > > The protocol produces the artefact; the artefact witnesses the protocol. The "· E ·" is the **Evocation phase** in both — the lap of the constellation that casts the marks, that turns the path into something that *is*. > > The earlier name `blade.md` collapsed every workshop's output into Vulcana's metaphor (Vulcana ⚒️ forges *blades*). The corpus's canonical pattern is **cape-style artefact creation** ([spec 07 §3](tomes/specs/07-lattice-mapping-governance.md)) — every shop is a cloakwright in its own register. The artefact.md naming restores that plurality; the conceptual *blade primitive* (cousin-blade · Plonkish blade · Aletheia blade · the null-blade origin at V0) remains canonical wherever it is genuinely the blade. --- ## §0 · The flow in one diagram ``` agentprivacy.ai/ → download --v.md │ ▼ spellweb.ai/import → spellweb merges template + Sovereign's identities │ · constellation.md (the workshop's path) │ · Mage identity (Sovereign's own Mage agent) │ · Swordsman identity (Sovereign's own boundary-keeper) ▼ spellweb forge → Sovereign traces the constellation; orbs lap │ RUN · E · CRAFT (canonical) or shop variant ▼ spellweb export → artefact.md downloaded │ carries: traversal record, hexagram stance, moon phase, │ signature, both identities, resident-Mage attribution, │ constellation version, four-axis mana spend ▼ agentprivacy.ai/ → Sovereign imports artefact.md as witness resident Mage delegates within agreed envelope ``` This guide documents every box. The full contract is reproducible from this file alone. --- ## §1 · The five elements of a spellweb item Every artefact.md a Sovereign carries home is composed of five orthogonal registers: | Element | What it is | Source | Recorded in artefact.md | |---|---|---|---| | **Constellation** | The ordered path through the lattice (waypoints + connections + marks) | The shop's `--v.md` template | `constellation_id` + `constellation_version` + traversal record | | **Identities** | Two — the Sovereign's Mage agent + Swordsman boundary-keeper | spellweb's import flow merges Sovereign's stored identities into the template | `{MAGE_DID} · {MAGE_SIGIL}` + `{SWORDSMAN_DID} · {SWORDSMAN_SIGIL}` | | **Ceremony shape** | The phase structure (RUN · E · CRAFT or a variant) | The template's `ceremony_shape` frontmatter | Phase-by-phase trace | | **Lattice anchor** | The vertex the work seats at + the founding act | The template's `mage_vertex` + `anchor_act` | `mage_vertex` + `anchor_act` carried through | | **Mana spend** | What the working *cost* across the four axes | The Sovereign's chain + entropy + (future) coordination/relationship choices at trace time | `mana_spent` triple/quadruple (Landing · Entropy · Coordination · Relationship) | The artefact.md is **proof that all five were aligned at the moment of the walk**. The architecture's commitment from the README's editorial principles applies: *the cast-constellation count is not a trust score* — what makes the blade *meaningful* is the alignment, not the count. --- ## §2 · The `constellation.md` template — canonical structure The shop ships an `.md` file at `agentprivacy-master/public/tomes/workshops/--v.md` (also mirrored at `docs/tomes/workshops/--v.md` for canonical readers). The download CTA is rendered by [`ConstellationDownload.tsx`](https://github.com/mitchuski/agentprivacy-master/blob/main/src/components/runecraft/ConstellationDownload.tsx) on each workshop page. ### §2.1 · The seven sections Every constellation.md carries seven sections in this order: ``` 1. Frontmatter (YAML) 2. Title + tagline 3. Mage Identity (with import placeholders) 4. Constellation Path (the waypoints) 5. Connections (the edges between waypoints) 6. Ceremony Shape (the phase structure) 7. Marks (proverbs to read at each waypoint) 8. What the exported artefact.md will contain (the witness contract) ``` ### §2.2 · Frontmatter contract Every field is required unless flagged optional. Field names match the spellweb importer's parser. ```yaml --- constellation_id: --v # e.g. tailor-cloak-weave-v1 constellation_name: # e.g. The Cloak Weave constellation_version: # integer workshop: shop- # e.g. shop-tailor workshop_route: / # e.g. /tailor workshop_gem: # e.g. Amethyst workshop_gem_color: "#xxxxxx" # hex (e.g. "#a78bfa") resident_mage: cast- # e.g. cast-pallia · MAY be "gathering" for /circle, /hall mage_sigil: # e.g. 🪡 mage_vertex: V # e.g. V28 mage_tier: # summoned · companion · priest · cousin · archetype · gathering anchor_act: act-tome-v- | act-tome-iv- | act-society-spellbook | act-bgin-coalition ceremony_shape: run-e-craft # OR gather-and-witness · bilateral-consecration · # four-cardinal-witness · bilateral-witness artefact_name: # e.g. Cloak (the bearer-name of the produced artefact) artefact_root_name: # e.g. Woven Cloak (the canonical root form) artefact_class: # clothing · weapon · tool · trinket · tome (per workshop taxonomy) artefact_archetype: # mage · swordsman · cross artefact_wielder: cast- # e.g. cast-soulbae (default wielder if none given) domain: # mage · swordsman · cross (which side of the dual carries it) status: # e.g. v1 — first release · v2 — successor refines date: YYYY-MM-DD license: CC BY-SA 4.0 signature: "(⚔️⊥⿻⊥🧙)😊" --- ``` ### §2.3 · Mage Identity slots (filled at import) Five placeholders the spellweb fills with the Sovereign's stored identities: ```markdown ## Mage Identity (filled by spellweb at import) - **Sovereign:** `{SOVEREIGN}` - **Your Swordsman:** `{SWORDSMAN_DID}` · `{SWORDSMAN_SIGIL}` - **Your Mage:** `{MAGE_DID}` · `{MAGE_SIGIL}` - **Resident Mage:** · `cast-` at V · ``` Bilateral shops (`/covenant`, `/hall`) add `{COUNTERPARTY_DID}` + `{COUNTERPARTY_SIGIL}`. ### §2.4 · Constellation Path — node taxonomy The path mixes **ten kinds of nodes** from the canonical spellweb graph (resolved by exact label against `spellweb/src/data/nodes.ts`): | Node kind | Emoji marker | Example | What it anchors | |---|---|---|---| | **Persona** | persona's sigil | Soulbis ⚔️ · Cipher 🗡️🔐 · Architect ☯️🤖 | Archetype the walk crosses | | **First Person Spellbook act** | 📜 | Act 9: Zcash Shield · Act 17: Bonfire in Dark Forest · Act 27: Forging Zero Knowledge Blades | The deep narrative ground | | **Tome V act** | 🪡 / ⚒️ / etc. (resident Mage's sigil) | Tome V Act 1: The First Cloak | The workshop's founding myth | | **Cast member** | persona's sigil | Pallia 🪡 · Vulcana ⚒️ · Luca 📐 | Resident Mage of the path | | **Vertex** | · (middle dot) | V28 — Mage Canonical | Geometric position on the 64-vertex lattice | | **Concept** | ◆ | Three-Axis Separation · Promise Theory · The Amnesia Protocol | Conceptual frame | | **Spell** | ✨ | Genesis Ceremony · Moon Ceremony · Celestial Key | Compressed principle cast during the walk | | **Skill** | 🛠️ | Hemispheric Attention · Spell Encoding | Capability activated | | **Gateway** | 🚪 | Covenant of Humanistic Technologies | Sister-city / kindred-substrate anchor | | **The Drake** | 🐉 | the Drake 🐉 | Ambient archetype (gathering ceremonies) | The importer matches **by exact label**, not by ID. Edit labels precisely; case and emoji matter. ### §2.5 · Connections — the edge chain A connection is one line per edge, formatted `