for agents/docs/llms.txtv0.2.75 · 9 Sep 2026

Home / Docs / Briefs / The vault map infographic

Surface: a published image, and the data behind it. The three code surfaces →

An infographic of the published vaults, grouped by use case and industry

A brief for producing a companion to the network infographic: the same treatment applied to the 26 published vaults rather than to the sites, grouped by what someone is trying to do and the industry they are in. It is written to be executed, and it opens with the two things that will otherwise sink it — the groupings do not exist as data yet, and an infographic is a snapshot that rots.

Do not start with the picture. Two blockers below are upstream of any image being generated. Fix them first and the infographic becomes a rendering job; skip them and an image model will invent the groupings, which is the one failure nobody will notice until a customer reads it back to us.

Blocker one: the network infographic is already wrong

The companion image this one is modelled on carries a footer reading “19 sites · 18 published · 1 forthcoming”, and lists skills.sgit.ai as Forthcoming. Both were true when it was generated. Today the network lists 27 sites and skills.sgit.ai has been live for some time — so a picture that is roughly a week old is now wrong in its headline number and in one of its cells.

That is not an argument against making it. It is the constraint the work has to be designed around:

Blocker two: neither requested grouping exists yet

The brief asks for use case and industry. Checked against admin/content/vaults.json, which is what the vaults table and the catalogue are generated from, the fields today are:

FieldCoverageWhat it actually is
category26 of 26The vault's shape, not its use case — Application (5), Analysis (5), Record (4), Reference (4), Presentation (3), Briefing (3), Report (1), Gallery (1). Useful, and not what was asked for
job6 of 26The closest thing to a use case that exists (“Publish a standard as data”, “Pitch an investor”, “Hand over a report”) — but it was added for the homepage bands and covers under a quarter of them
industry0 of 26Does not exist

So the first deliverable is not an image, it is two fields. Add use_case and industry to every entry in vaults.json, and the infographic becomes a view over data the site already publishes — which is the rule the rest of this estate runs on: indexes are generated from the data they index, because an index maintained by hand becomes a lie on a schedule.

What the picture has to show

Match the network infographic so the two read as a pair: dark ground, one luminous shared foundation at the top, numbered columns beneath it, a footer of counts, and a horizontal band of cross-links near the bottom.

ElementContent
The foundationWhat every vault shares: encrypted files, version history, and a published read key that is the whole credential. The network image put “sgit.ai vaults” here; this one can say one vault format
Primary grouping — columnsUse case. Each column is a job somebody is trying to do, with the vaults that do it listed as cells: name plus one short line, exactly as the sites image does
Secondary grouping — a mark on each cellIndustry, as a small tag or colour key rather than a second set of columns. Two nested column systems in one image is unreadable; a legend is not
The bandGenuine relationships between vaults — the conformance layer forking the catalogue, the Risk Graph Explorer sharing the licence-to-operate acceptance model. Carry the same disclaimer the sites image carries: illustrative links, not deployed integrations
The footerThe computed counts, the site version and the date. Nothing typed by hand

The accuracy rules, because an image model will not follow them on its own

An image model renders text as shapes. It will misspell a domain, drop a hyphen, invent a plausible vault that does not exist, and produce a confident number that came from nowhere — and none of that throws an error.

  1. Generate the caption text from the data first, as a list, and treat the image as a rendering of that list. If the list and the image disagree, the image is wrong.
  2. Read every string in the output back against vaults.json — every vault name, every count, every label. Character by character on the names.
  3. Count the cells. If the data says 26 vaults and the picture shows 24, it dropped two, and it will not tell you which.
  4. No vault appears that is not in the file. A generated name that reads plausibly is the most dangerous output this process can produce.
  5. If the model cannot render the text reliably, render the text separately. Generating the artwork and setting the labels as real text over it is a legitimate and more honest answer than fighting the model.

Publishing it on this site

The prompt to hand the agent

Produce a vault map infographic for sgit.ai, as a companion to the existing
network infographic, grouping the published vaults by USE CASE and INDUSTRY.

Read https://sgit.ai/docs/briefs/vault-map-infographic.md first. Do the two
upstream steps before generating any image.

STEP 1 — the data. admin/content/vaults.json has category on all 26 vaults, job
on 6, and no industry field at all. Neither requested grouping exists yet. Add
use_case and industry to every entry, written from the vault itself and not from
its title, using a closed vocabulary of 6-8 values each, declared in the file,
with the build failing on an unknown value. Keep category — shape and use case
are different questions. Use "cross-industry" where a vault genuinely serves no
sector; do not invent one.

STEP 2 — the caption list. Generate the full text of the infographic from
vaults.json as a plain list: every column heading, every cell, every count.
This list is the source of truth; the image is a rendering of it.

STEP 3 — the image. Match the network infographic: dark ground, one shared
foundation at the top, numbered columns for use cases, industry as a tag or
colour key rather than a second column system, a cross-links band carrying the
same "illustrative, not deployed integrations" disclaimer, and a footer with the
computed counts plus the site version and date.

STEP 4 — check it. Read every string in the image back against vaults.json,
character by character on the names. Count the cells against the vault count. No
vault may appear that is not in the file. If the model cannot render text
reliably, render the artwork and set the labels as real text over it.

STEP 5 — publish it. Use the data-shot pipeline, never an img src, which the
validator bans. Write real alt text. Put the grouped list on the page as HTML as
well, so the markdown twin carries the substance. Say on the page that the image
was generated by an image model.

Report: the two vocabularies you chose, how many vaults landed in each value,
and any vault whose use case or industry you could not determine from its
contents.

The companion piece is the network infographic, which is what this one should look like and also what it should learn from — it is a good picture with a footer that has already gone stale. All briefs · Working on a vault: start here · The published vaults