influences.sgit.ai / format

The register format

Seven blocks, in this order, for every entry that earns them. The format was not designed for this site: Dinis Cruz wrote an immediate-connection register for Bret Victor's Inventing on Principle as a working document about the estate's viewer, and then asked what a site made of such documents should be called. That ordering matters — the format is proven in use, not designed on spec.

The one move that makes this different from a reading list. The format treats an influence as a falsifiable claim about the codebase. Anyone can say Victor inspired them. The register says which of Victor's patterns appear where in the estate, at which version — and which are still missing, specified precisely enough to build. Popper is the influence that explains the format itself, which is a satisfying loop and also a slightly circular one.

The seven blocks

Block 1 The anchor

The primary work, precisely cited: title, author, venue, date, canonical URL, and a durable mirror where one exists. One anchor per entry. The wider bibliography goes in Block 7.

For a person, the anchor is the single work that did the shaping, not the whole career. For a topic, an era or a community, it is the first documented contact with it. Slugs on this site are people and topics rather than works — /register/bret-victor/, not /register/inventing-on-principle/ — precisely because an anchor can be superseded: a briefing document may reveal that the real anchor was a different talk, and a URL that encoded the wrong one would be wrong forever.

Where the anchor is not yet settled, the block says so rather than picking one. Three entries are in that state today.

Block 2 Dinis Cruz's words

Why this resonates, in first person. This is the only site in the network where first person is the house style — what resonates with me and why is the genre, and paraphrasing it into corporate third person would destroy the evidence.

Until the briefing document for an entry arrives, this block carries whatever first-person statements already exist in the corpus, cited by file. Where none exist, the block says explicitly that what follows is the site's reading of the evidence, not Dinis Cruz's words, and stays labelled that way.

Quotations here are marked up with the person whose words they are, and the release gate reads that marking. A blockquote on this site cannot be anonymous.

Block 3 The principle

The influence distilled to one transferable sentence — the thing an agent can actually apply. Victor's is immediate connection between creator and creation. Wardley's is situational awareness before strategy.

The test: the principle must be usable by someone who has never consumed the anchor work. A principle that only makes sense if you have watched the talk has not been distilled, it has been summarised.

On stub entries the principle is often a hypothesis constructed from public knowledge rather than from anything Dinis Cruz has written, and every such principle says so in its own text. That is not a hedge — it is the difference between a claim the site is making and a placeholder waiting to be corrected.

Block 4 The trace table

The heart of the format and the falsifiable part. Rows of: pattern from the anchor → where the estate implements it → version → status.

StatusMeans
implementedThe pattern appears at the named place.
partialSomething of it appears; the pattern is not fully realised. Usually the most informative row on a table.
absentThe anchor work names it and the estate does not have it. Kept in the table rather than dropped — a trace table that only recorded successes would be a brochure.

The Victor register's own closing observation is the standard to aim for: half the estate's strongest viewer features turned out to be unknowing implementations of the talk's demos. That is a weaker claim than the talk caused this and a more interesting one — the instinct and the principle agree, and writing the register turns the agreement into something the next agent can extend on purpose rather than rediscover.

Every entry with rows also publishes them on their own page, as markdown, and as JSON — because the influence map is computed from those files rather than drawn.

The generate-or-date rule

A trace table without version numbers is an opinion. A row that says a pattern appears somewhere, without saying at which release it was seen, cannot be checked later — the file may have changed, the feature may have gone, and nobody can tell whether the row was ever true.

So every row carries a version where the corpus scan recorded one, and where it did not, the entry counts the rows that are missing and says so out loud. That is not a satisfying answer. The satisfying answer is R1: give the build read access to the estate and regenerate the rows rather than citing them.

Block 5 The gaps, as build specs

Patterns from the anchor the estate does not yet implement, written precisely enough that an agent could pick one up as a work item. The Victor register specifies two by name — view time travel and relayout ghosts — and every full entry here is expected to produce its own.

This is what makes an influence page forward-looking: it is provenance and backlog in the same document. A gap written as we should think about X is not a gap, it is a mood; the block is only doing its job when the spec names what would have to exist and how you would know it worked.

Block 6 The checklist

A short list of questions to ask of new work in this influence's light. Does the person see the effect of their change immediately? Is the map drawn before the strategy is argued? Is it simpler than what it replaces?

The checklist is the influence made operational — the part an agent can run without having consumed the anchor work, and the part most likely to outlive the entry around it.

Block 7 The wider library

The rest of the person's or topic's work, linked and never rehosted, each item with one line on what it adds. The union of every entry's Block 7 is /library/, generated from the same register.

Listing facts about a work — title, year, one line, a link — is uncopyrightable metadata and is safe. Cover images and stills are not, which is why there are none anywhere on this site.

The three reduced forms

Not every entry earns all seven blocks on day one, and pretending otherwise would produce padding. The format defines three reduced forms and the generator implements exactly those.

full — 13 entries

The seven blocks, or as many as the evidence supports. An entry can be full and still have an empty trace table: the Victor entry is the model for the whole site and its table is missing, because the register that contains it is with Dinis Cruz. The entry says that in the place the table would be, which is more useful than an invented table and more honest than an omitted block.

Blocks 1–3, and then a pointer where the trace table would be: the trace of this influence is an entire site. Wardley, graphs and open source each have a sibling site carrying their material.

Duplicating that material here would break the deconfliction rule: two sites making the same argument slightly differently is the real failure mode for a network, and it is worse than a dead link. The influence entry owns the resonance; the sibling owns the material. An entry that grows past resonance-and-trace has scope-crept, and the fix is to move the material and keep the pointer.

stub — 9 entries

Blocks 1 and 3 at best current knowledge, an explicit awaiting-briefing marker, and the research plan published — which of Dinis Cruz's past publications and talks should be mined when the briefing arrives.

A stub is published, not hidden. The roadmap is content. Where the works are public knowledge and need no briefing, a stub also carries Block 7 — a reader looking for Kevin Kelly's books should not have to wait for a briefing document to find out what they are.

And the discovered form

Same as the full format, with one difference: Block 2 opens with honesty. Dinis Cruz never listed this influence; the corpus surfaced it. The claim that it shaped the work rests entirely on the evidence in the entry until he confirms or corrects it.

Discovered entries are the site's falsifiability applied to itself — and the mechanism has already worked once: Design was surfaced by mining and confirmed by Dinis Cruz the day the commissioning pack shipped.

The no-verbatim rule, and why it is a release gate

Dinis Cruz set the rule himself: the site explains what resonates and why, and traces where it was applied — it does not reproduce the influences' own work. That instinct happens to be exactly what copyright law rewards.

CC BY 4.0 covers

  • Every word of resonance and analysis on this site
  • The trace tables, the gaps, the checklists
  • The register data, the map, and llms-full.txt
  • Any original artwork and redrawn figures

It does not cover

  • Every anchor work. Talks, books, essays, keynotes, records — they belong to their authors
  • Anything in the wider library
  • Cover images and stills, which is why there are none
  • Photographs of anybody

The boundary, precisely:

A rule that load-bearing is worth a check rather than a paragraph, so it is one:

# in the page source
<blockquote data-quote="founder">…</blockquote>        # unrestricted
<blockquote data-quote="Steve Jobs">…</blockquote>     # capped at 40 words
<blockquote>…</blockquote>                          # fails the release

# admin/build/validate.js, on every push
✗ 62-word quotation attributed to "X" exceeds the 40-word cap
  → the fix is to cut the quotation, never to raise the cap

What the gate cannot do, stated plainly: it cannot see an unmarked quotation woven into a paragraph, and it cannot tell you whether a 39-word quotation was fair. What it can do is make the marked case cheap and the unmarked case a review finding, and stop the failure mode that actually ships — a long passage pasted in whole because it was useful at the time. How it is implemented →

Entry metadata

Every entry carries the same fields, and they are the schema of data/influences.json rather than a description of one:

FieldWhat it holds
tiertraced / stated / discovered
kindperson, work, topic, era, practice, community, framework, canon — this register has all eight
statusfull / link-out / stub
discoveredan origin flag, kept after a promotion — how an entry got here stays visible
founder_confirmedthe date and the words, where a discovered entry has been confirmed
anchorBlock 1, with its URLs
corpus_evidence[]paths and notes — regenerable, and currently cited rather than resolved (R1)
tracerows, or a pointer to a sibling, or an honest statement of why there are none
nests · nests_under · composes_with · lineagethe edges the map is computed from
research_plan · briefing_status · commswhat is missing, and which thread is asking for it

Every page under /register/ is generated from those fields, and so is its markdown twin. The prose is authored once — in the JSON, in a deliberately tiny markdown — and rendered twice, because two renderings of one string cannot drift and two hand-written copies always do.

Where this document comes from

This page is the site's working statement of the format. The commissioning pack's own version is published verbatim at /documents/format.html, and where the two differ, this page is the one the generator actually implements. Two departures are worth naming: stubs here may carry Block 7 where the bibliography is public knowledge, and the trace-table row statuses are fixed to three values so that the map can be computed from them.