wardley-maps.sgit.ai — brief pack

For: the agent commissioned to build wardley-maps.sgit.ai From: Dinis Cruz, via the SG/Send Librarian Version: v0.33.62 · 23 August 2026 Licence: CC BY 4.0 — read LICENSE.md before copying anything. This site sits inside a CC BY-SA ecosystem and that collision is the biggest trap in the build.

What this is

A research site for Wardley Mapping, consolidating 194 files of unpublished mapping thinking in the __Send corpus with 26 published items spanning 2018–2025 and 34 industry resources verified in August 2026.

Three jobs were commissioned and all three are here:

Consolidate what exists across __Send and the *.sgit.ai network — 01__, 02__, 05__, 06__
Job A — research Dinis's own published Wardley material — 03__
Job B — the best industry resources, a page each, with details, screenshots and links — 04__

Read in this order

File	Words	What it does
`00__BRIEF.md`	2.0k	Start here. The commission, two corrections to the premise, the thesis, the five original pages, the honesty constraint, the numbers, the build order
`02__pioneers-settlers-town-planners.md`	1.6k	The page only this site can write — Wardley's PST as three literal AI agent teams. Never written up anywhere
`04__job-b__industry-resources.md`	1.8k	Job B: the per-resource page template, the ranked top ten, the licence minefield, three start-here paths
`03__job-a__dinis-published-material.md`	1.5k	Job A: 26 items, the seven-year through-line, and what to archive before it disappears
`05__maps-and-rendering.md`	1.5k	The maps that exist, the coordinate contract proven by rendering, the parse rules, the working pipeline
`01__concepts-index.md`	2.8k	33 concepts with canonical paths and dates, classified standard / extension / original, plus a six-altitude teaching order
`06__site-architecture.md`	1.1k	Page-by-page IA, the house pattern to copy, what moves vs what gets referenced
`07__boundaries-and-licensing.md`	1.3k	The CC BY / CC BY-SA collision, the do-not-publish list, screenshot ethics, house style
`08__gaps-and-open-questions.md`	1.4k	7 write-fresh items, 8 commissioned-but-never-made artefacts, 8 open questions, 7 honest tensions
`09__source-manifest.csv`	73 rows	Every source, tiered 0–3, with proposed page and publishability. Every path verified at v0.33.62
`sources__dinis-wardley-published.json`	26 items	Job A data — dates with precision flags, video URLs, verification flags
`sources__industry-resources.json`	34 + 11	Job B data — licence and pre-written attribution string per resource, plus 11 dead-or-dying entries
`maps/`	4 maps	Original `wardley-beta` sources and rendered SVGs. The estate's first rendered SVG maps
`screenshots/`	script	`capture.js` + 30 targets carrying licence and attribution strings
`LICENSE.md`	—	CC BY 4.0, and the four regimes it does not cover

The four things that will bite you

1. This site is CC BY inside a CC BY-SA ecosystem. Quoting Simon Wardley's material is fine. Adapting it forces that page to be CC BY-SA 4.0. Keep everything as marked quotation and link-out. And note his blog is 3.0, not 4.0 — different licence, different notice.

2. Nothing renders. All 13 Mermaid map sources in the repo fail, for two mundane reasons (wrong code fence, one unquoted note). The 8 PNGs from 24 May are the only working visuals in the corpus. Fixing this is a day-one task and turns 13 dead code blocks into 13 maps.

3. The doctrine mapping is not in a vault — it is static HTML at pki.sgit.ai/packs/registry-mvp/doctrine.html, 41 records, and it is the site's anchor asset. The vault with maps is a different property (sgit.ai, Strategy Maps) and has no doctrine content. Moving the doctrine page is build-order step 1.

4. There is no public bridge between the security-era and agentic-era work. Job A found 26 published items ending in 2025 and 194 unpublished files starting in 2026, connected by one clause in one co-authored article. Do not write the site as though the connection already exists in public. Building it is the commission.

About the screenshots

Job B asked for screenshots. This pack ships the capture kit, not the images, and the reason is stated rather than hidden: the sandbox this pack was built in has an egress proxy that allows only package registries. Every third-party host returned ERR_TUNNEL_CONNECTION_FAILED — including sgit.ai itself. Nothing was captured and nothing was routed around.

screenshots/capture.js does the job wherever the network is open:

cd screenshots
npm i playwright && npx playwright install chromium
node capture.js              # all 30 targets
node capture.js 04 07 13     # a subset, by id prefix

It writes captured.json recording HTTP status, page title, final URL after redirects, and a UTC timestamp for every attempt including failures. Publish that file. In an ecosystem whose own canonical indexes point at five dead tools, a screenshot with a provable capture date is the whole point.

About the maps

Four original maps in maps/, source and rendered SVG, produced with Mermaid CLI 11.14.0 and the Playwright Chromium. They are drawn about the site's own subject matter so they can go straight onto pages: the tool ecosystem, the two absences (MapKeep and the doctrine tools), maps for agents, and the site as a value chain.

They are claims, not decorations. Publish the .mmd next to the .svg so a reader can fork the argument in a pull request — which is pki.sgit.ai's own standard: "the maps live in the source and are reviewable in a diff."

Two findings came out of making them, both in 05__: the [visibility, evolution] coordinate order verified by rendering rather than repeated, and the complete wardley-beta name-parsing rule — -, . and / all break unquoted names, quoting fixes all three, and the quotes must be used in the link lines too.

House pattern

Copy pki.sgit.ai — it is the only site in the network with all six house markers, and it already hosts the doctrine work. /llms.txt as the whole agent surface; /documents/ with raw markdown as source of truth; /admin/comms.html numbering asks (N1…) and tasks (T1…); /admin/versions.html; /about/participant.html; /shipped/ separating what exists from what is designed. Add the /llms-full.txt pki lacks, and add one thing no sibling has: a link-verification job that publishes its run date.

Publish the build order unresolved, with the open questions and honest tensions visible. 08__ supplies both.

This file is released under the Creative Commons Attribution 4.0 International licence (CC BY 4.0).

=== /briefs/01__concepts-index.md