{
 "schema": "wardley-maps-sgit-ai/concepts/v1",
 "source": "https://wardley-maps.sgit.ai/briefs/01__concepts-index.md",
 "compiled": "2026-08-23",
 "licence": "CC BY 4.0",
 "note": "Thirty-five rows — 31 primary concepts plus 4 lettered sub-entries — drawn from a private corpus of 194 files. The `class` field is the important one: S means it is standard Wardley doctrine and belongs to Simon Wardley — quote it and link it, do not treat this file as a source for it. E and O are this corpus's own extensions and original contributions. The `source` paths are inside a private repository and are recorded for provenance, not for retrieval.",
 "classes": {
  "S": {
   "label": "Standard doctrine",
   "note": "Wardley's, and his book says it first and better. Linked, not restated."
  },
  "E": {
   "label": "Extension",
   "note": "Standard doctrine pushed somewhere it is not usually taken."
  },
  "O": {
   "label": "Original contribution",
   "note": "Not found in the doctrine or in the ecosystem's literature. The reason this site exists."
  }
 },
 "counts": {
  "total": 35,
  "original": 17,
  "extension": 14,
  "standard": 4
 },
 "concepts": [
  {
   "id": "W1",
   "concept": "Explorer / Villager / Town Planner — Wardley's PST renamed and made into three literal agent teams",
   "quote": "\"Simon Wardley identifies three team archetypes mapped to the evolution axis… Explorers / Villagers / Town Planners\" and later, explicitly: *\"(Explorer, Villager, and Town Planner map to Wardley's Pioneers, Settlers, and Town Planners.)\"*",
   "source": "team/humans/dinis_cruz/briefs/02/14/v0.3.2__briefs__wardley-maps-in-sgraph-project.md",
   "date": "14 Feb 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]** — the naming, and the application to AI agents, is his",
   "page": "/patterns/pst/index.html"
  },
  {
   "id": "W2",
   "concept": "The \"theft\" / handover",
   "quote": "\"The key dynamic is what Wardley calls the **'theft'** — the villagers take (pinch) what the explorers have built and turn it into a product.\"",
   "source": "same as W1",
   "date": "14 Feb 2026",
   "maturity": "mature",
   "class": "S",
   "class_label": "Standard doctrine",
   "class_note": "",
   "page": "/patterns/pst/index.html"
  },
  {
   "id": "W3",
   "concept": "The SG/Send evolution map (13 components positioned)",
   "quote": "\"The components in the top group (encryption, upload/download, S3 backend, tokens) are ready for the Villager team to productise. The components in the bottom group are still being explored.\"",
   "source": "same as W1",
   "date": "14 Feb 2026",
   "maturity": "mature",
   "class": "S",
   "class_label": "Standard doctrine",
   "class_note": "applied",
   "page": null
  },
  {
   "id": "W4",
   "concept": "Cartographer as the role that makes mapping operational",
   "quote": "\"The Cartographer is the role that makes the Wardley Maps framework operational rather than theoretical. Without the Cartographer actively maintaining and updating the evolution map, the Explorer/Villager distinction becomes opinion rather than evidence.\"",
   "source": "same as W1",
   "date": "14 Feb 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": null
  },
  {
   "id": "W5",
   "concept": "A map is a graph with positional metadata",
   "quote": "\"**a Wardley Map is not a separate artifact from the graph. It is a graph with positional metadata.**… The graph is primary; the map is a projection… Map queries are graph queries with positional filters\"",
   "source": "team/roles/cartographer/REFERENCE__from-issues-fs.md",
   "date": "7 Feb 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]** — the strongest architectural idea in the corpus",
   "page": "/method/maps-as-graphs.html"
  },
  {
   "id": "W6",
   "concept": "Configurable / alternative evolution axes (openness, automation, documentation, test coverage, graph connectivity)",
   "quote": "\"by treating the evolution axis as a configurable dimension rather than a fixed one, and by storing axis metadata in the graph alongside everything else\"",
   "source": "team/roles/cartographer/REFERENCE__from-issues-fs.md",
   "date": "7 Feb 2026",
   "maturity": "developing",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]**",
   "page": "/method/custom-axes.html"
  },
  {
   "id": "W6b",
   "concept": "Same idea restated as visibility / risk overlays",
   "quote": "\"in Wardley maps the evolution does not always need to be genesis, custom-built, product, commodity. You can have other axes: visibility from not-visible to fully-visible, or risk from not-understood to fully-accepted.\"",
   "source": "team/humans/dinis_cruz/briefs/06/19/strategy-phase-and-shipping/v0.33.28__strategy-brief__sg-send-wardley-maps-productizing-commoditizing-permissions-explorer-phase.md",
   "date": "19 Jun 2026",
   "maturity": "developing",
   "class": "E",
   "class_label": "Extension",
   "class_note": "",
   "page": "/method/custom-axes.html"
  },
  {
   "id": "W7",
   "concept": "**The custom-axis verdict, and the evolution-vs-maturity line**",
   "quote": "\"the evolution scale doesn't necessarily need to be Genesis, custom-built, product and commodity; you can go from air gap to file to API to event-driven.\"… \"The practical rule: **relabel the axis when the thing genuinely evolves; use a maturity model when the thing merely improves.**\"",
   "source": "team/humans/dinis_cruz/briefs/07/28/mvp-and-field-demo/v0.33.53__strategy-brief__sg-send-wardley-map-of-the-airgapped-register-custom-evolution-axes-broken-middle-shape.md",
   "date": "28 Jul 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]** — the sharpest methodological contribution in the corpus, with sources cited",
   "page": "/method/custom-axes.html"
  },
  {
   "id": "W8",
   "concept": "**De-commoditisation / the attrition shield**",
   "quote": "\"**a thing can be commoditised at one phase of evolution while still being meaningfully custom-built at the next phase**… I am going to call this pattern **de-commoditisation**\"; \"The Wardley Map shows the commodity. The shield is what the map does not show. Both matter.\"",
   "source": "team/humans/dinis_cruz/briefs/05/17/v0.27.55__article__de-commoditising-the-commodity (1).md",
   "date": "17 May 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]** — explicitly framed as a gap in doctrine",
   "page": "/method/de-commoditisation.html"
  },
  {
   "id": "W9",
   "concept": "Commoditise-to-enable (ILC applied)",
   "quote": "\"once you commoditise something, you enable other businesses to be built on top\"; \"when something is commoditised, a higher order of activities appears, and that is where the market opportunities are\"",
   "source": "team/humans/dinis_cruz/briefs/05/24/sg-send-thread/v0.27.60__strategy-brief__sg-send-wardley-maps-setup-and-mermaid-capability.md",
   "date": "24 May 2026",
   "maturity": "mature",
   "class": "S",
   "class_label": "Standard doctrine",
   "class_note": "",
   "page": "/method/de-commoditisation.html"
  },
  {
   "id": "W10",
   "concept": "**The commodity illusion**",
   "quote": "\"what is interesting when you map like this is that you see a lot of things that feel like a commodity or a product to the user are actually very weak and very immature behind the scenes.\"",
   "source": "team/humans/dinis_cruz/briefs/06/23/wardley-maps/v0.33.33__strategy-brief__sg-send-wardley-maps-brief-user-needs-first-before-after-agent-as-user-maturity.md",
   "date": "23 Jun 2026",
   "maturity": "mature",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]** — a named reading of maps, not standard vocabulary",
   "page": null
  },
  {
   "id": "W11",
   "concept": "**The agent as a user**",
   "quote": "\"the agent is also a user… Execution is mature; safe authorization via an LLM is custom-built and immature; the LLM is commodity, but the uninjected, on-task safe decision is not\"",
   "source": "same as W10; drawn in `…/v0.33.33__strategy-brief__sg-send-wardley-maps-first-pass-eight-maps-user-needs-before-after.md",
   "date": "23 Jun 2026",
   "maturity": "developing",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": null
  },
  {
   "id": "W12",
   "concept": "**The air gap as manual labour; the ends-evolved-middle-manual shape**",
   "quote": "\"**you cannot map a gap, because a gap has no evolution**\"; \"this will be a very interesting shape where you can have the top working quite efficiently, and then the middle bit those lines all the way to the left because they're manual… the ends are solved. the middle is people.\"",
   "source": "team/humans/dinis_cruz/briefs/07/28/mvp-and-field-demo/v0.33.53__strategy-brief__sg-send-wardley-map-of-the-airgapped-register-custom-evolution-axes-broken-middle-shape.md",
   "date": "28 Jul 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": "/method/broken-middle.html"
  },
  {
   "id": "W13",
   "concept": "Wardley-maps-as-Mermaid-code, and the `[visibility, evolution]` coordinate rule",
   "quote": "\"**Mermaid uses the OnlineWardleyMaps format `[visibility, evolution]`, which is the opposite of typical (x, y) notation.**… Getting this backwards puts every component in the wrong place, so it is the thing to check first.\"",
   "source": "team/humans/dinis_cruz/briefs/05/24/sg-send-thread/v0.27.60__strategy-brief__sg-send-wardley-maps-setup-and-mermaid-capability.md",
   "date": "24 May 2026",
   "maturity": "mature",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]** — tooling knowledge, verified by rendering",
   "page": "/agents/index.html"
  },
  {
   "id": "W13b",
   "concept": "The node-naming parse-error caveat (empirical)",
   "quote": "\"**component and anchor names that contain a hyphen, an ampersand, or a slash cause a parse error when those names are referenced in links or `evolve` statements.**… The robust fix is to keep component and anchor names to letters and spaces\"",
   "source": "same as W13",
   "date": "24 May 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]** — original empirical finding",
   "page": "/agents/index.html"
  },
  {
   "id": "W14",
   "concept": "**The lifecycle of a skill: Explorer → Product → Town Planner → absorbed**",
   "quote": "\"the lifecycle of a skill is to start as massive LLM, held together with string and gum, very expensive, lots of tokens, all the way to a product, all the way to code, and it almost becomes a commodity, eventually disappearing, because maybe it is absorbed by something else.\"",
   "source": "team/humans/dinis_cruz/briefs/06/04/v0.32.3__strategy-brief__sg-send-skill-lifecycle-explorer-to-town-planner-english-to-code.md",
   "date": "4 Jun 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": "/patterns/pst/index.html"
  },
  {
   "id": "W15",
   "concept": "**High token spend is an engineering problem**",
   "quote": "\"**Anybody who spends a lot of money on tokens has an engineering problem. They are using explorer-type code and solutions in a commodity environment.**\"",
   "source": "same as W14",
   "date": "4 Jun 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]** — the most quotable line in the corpus",
   "page": "/patterns/pst/index.html"
  },
  {
   "id": "W15b",
   "concept": "English → code as the maturity mechanism; LLM-powered test harness",
   "quote": "\"the natural progression of a skill is to start in English and end up in code. As you refine the skill, you reduce the scope, you reduce the variability.\"; \"the testing can be more in explorer mode, because the testing can have the subjectivity and power of an LLM\"",
   "source": "same as W14",
   "date": "4 Jun 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": null
  },
  {
   "id": "W16",
   "concept": "**Explorer-phase discipline: defer Town-Planner artifacts**",
   "quote": "\"there is no point doing things that are typical Villager and Town Planner company maturity when you are still dealing with Explorer ambiguity. Do not spend time creating things that are pure hypothesis you just cannot know\"",
   "source": "team/humans/dinis_cruz/briefs/06/19/strategy-phase-and-shipping/v0.33.28__strategy-brief__sg-send-wardley-maps-productizing-commoditizing-permissions-explorer-phase.md",
   "date": "19 Jun 2026",
   "maturity": "mature",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]** — PST applied to *the company itself*, not to teams",
   "page": null
  },
  {
   "id": "W17",
   "concept": "**Safe is not secure**",
   "quote": "\"there is a difference between safe and secure. Secure is just the security metrics. Safe is whether it is aligned with the risk appetite, within the threshold of risk the business or the person is willing to accept.\"",
   "source": "team/humans/dinis_cruz/briefs/06/23/wardley-maps/v0.33.33__strategy-brief__sg-send-wardley-maps-brief-user-needs-first-before-after-agent-as-user-maturity.md",
   "date": "23 Jun 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": null
  },
  {
   "id": "W18",
   "concept": "**The vibe-coded MVP is the best brief; the three-team shipping workflow**",
   "quote": "\"the vibe coded MVP **is** the specification. It is more precise, more concrete, and more usable than any document the business stakeholder could have written.\"",
   "source": "team/humans/dinis_cruz/briefs/05/11/v0.27.32__article__explorer-villager-town-planner-vibe-coding-workflow.md",
   "date": "12 May 2026 (YAML `date:`)",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]** — and note it *inverts* the seniority: \"This work is best suited to junior and mid-level engineers\" (Villager) / \"the most experienced engineers on the team\" (Town Planner)",
   "page": null
  },
  {
   "id": "W19",
   "concept": "A working tool is already a commodity; switching drags the user back to Genesis",
   "quote": "\"once a tool works, it has become a commodity for its user, and asking them to switch asks them back to Genesis, which is why change is so hard.\"",
   "source": "team/humans/dinis_cruz/briefs/06/07/v0.32.7__strategy-brief__sg-send-tool-replacement-strategy-compatible-commoditize-de-risk.md",
   "date": "7 Jun 2026",
   "maturity": "developing",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]**",
   "page": null
  },
  {
   "id": "W20",
   "concept": "Vaults embody the Wardley flow",
   "quote": "\"the vaults are so powerful because they let us experiment wildly in a very controlled way, then bring them into the main codebase as the villagers take over, and then productise, including the town-planner team that makes it super solid.\"",
   "source": "team/humans/dinis_cruz/briefs/06/19/strategy-phase-and-shipping/v0.33.28__strategy-brief__sg-send-need-to-ship-iterate-learn-ci-pipeline-wardley-flow-cost-constraint.md",
   "date": "19 Jun 2026",
   "maturity": "developing",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]**",
   "page": null
  },
  {
   "id": "W21",
   "concept": "Doctrine assessment as a standing role responsibility",
   "quote": "\"The Cartographer's doctrine responsibility is to periodically evaluate the… ecosystem against these principles and produce a score or health assessment… The doctrine assessment is fractal\"",
   "source": "team/roles/cartographer/REFERENCE__from-issues-fs.md",
   "date": "7 Feb 2026",
   "maturity": "sketch (never executed)",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]**",
   "page": null
  },
  {
   "id": "W22",
   "concept": "Gameplay identification (ILC, open, ecosystem, tower-and-moat, Red Queen, sensing engines)",
   "quote": "\"Most Wardley Mapping practitioners stop at the map. The Cartographer must go further: doctrine assessment gives strategic health checks; gameplay analysis identifies available moves. These are where maps become actionable.\"",
   "source": "team/roles/cartographer/REFERENCE__from-issues-fs.md",
   "date": "7 Feb 2026",
   "maturity": "developing",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]**",
   "page": null
  },
  {
   "id": "W23",
   "concept": "**A map is a falsifiable claim, not a picture**",
   "quote": "\"A Wardley map is a **claim**, not a picture: it asserts where each component sits on the evolution axis and is therefore arguable.\"",
   "source": "team/humans/dinis_cruz/briefs/08/14/sgit-site-and-hub/v0.33.58__strategy-brief__sgit-topic-sections-catalogue-read-keys-yes-write-keys-never-frozen-vaults.md",
   "date": "14 Aug 2026",
   "maturity": "developing",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": "/index.html"
  },
  {
   "id": "W24",
   "concept": "**Somebody has to be the villagers — NFRs as the sellable unit**",
   "quote": "\"the sweet spot is to find the economic value where it's cheaper for these companies to pay a third party to maintain what I call the non-functional requirements\"; \"**Demand for a specific skill is rising sharply while the mechanism that produces that skill is being dismantled**\"",
   "source": "team/humans/dinis_cruz/briefs/07/31/markets-and-field-demo/v0.33.54__strategy-brief__sg-send-somebody-has-to-be-the-villagers-maintaining-non-functional-requirements-scarce-asset.md",
   "date": "31 Jul 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": "/patterns/pst/index.html"
  },
  {
   "id": "W25",
   "concept": "The same skill differs by Wardley character",
   "quote": "\"a skill, the same skill for a town planner, is very different for an explorer, for a villager. It is all about context-specific, but now we can do this, and we can scale.\"",
   "source": "team/humans/dinis_cruz/briefs/06/04/v0.32.3__strategy-brief__sg-send-skills-as-graph-capturing-how-business-works.md",
   "date": "4 Jun 2026",
   "maturity": "developing",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": null
  },
  {
   "id": "W25b",
   "concept": "Wardley \"why now\" for skills",
   "quote": "\"skills are a good example of the Wardley map's evolution scale, where a number of things evolve, new orders appear, implementations appear above. Skills could only be possible with the level of LLMs we have right now\"",
   "source": "same as W25",
   "date": "4 Jun 2026",
   "maturity": "developing",
   "class": "E",
   "class_label": "Extension",
   "class_note": "",
   "page": null
  },
  {
   "id": "W26",
   "concept": "Map the control flows and the cost flows together",
   "quote": "\"cost and control flows, and cost flows. The graph is almost like the map of this, the Wardley map of this.\"",
   "source": "team/humans/dinis_cruz/briefs/05/24/sg-sentinel-batch2/v0.27.60__arch-brief__sg-sentinel-cost-attribution-accountant-agent.md",
   "date": "24 May 2026",
   "maturity": "sketch",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]**",
   "page": null
  },
  {
   "id": "W27",
   "concept": "Every division has its own map and its own maturity",
   "quote": "\"companies are made of multiple companies, multiple divisions, each with a different focus, different evolutionary scales, different Wardley maps, different maturities. We need to take that into account.\"",
   "source": "team/humans/dinis_cruz/briefs/06/18/agentic-permissions/v0.33.40__strategy-brief__graphs-of-graphs-ontology-of-ontologies-permissions-mapping-reality-not-complexity.md",
   "date": "18 Jun 2026",
   "maturity": "sketch",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]**",
   "page": null
  },
  {
   "id": "W28",
   "concept": "**Paired before/after maps as the unit of argument**",
   "quote": "\"Each map is drawn twice. The reality map shows how immature the path is today… The with-our-service map shows the same value chain once our service supplies the missing data… **The distance between the two is the case for the service.**\"",
   "source": "team/humans/dinis_cruz/briefs/06/23/wardley-maps/v0.33.33__strategy-brief__sg-send-wardley-maps-brief-user-needs-first-before-after-agent-as-user-maturity.md",
   "date": "23 Jun 2026",
   "maturity": "mature",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]**",
   "page": null
  },
  {
   "id": "W29",
   "concept": "User-needs-first doctrine (his statement of it)",
   "quote": "\"the thing about Wardley maps that is always important is to start with the user needs, so we start with what they actually want\"",
   "source": "same as W28",
   "date": "23 Jun 2026",
   "maturity": "mature",
   "class": "S",
   "class_label": "Standard doctrine",
   "class_note": "",
   "page": null
  },
  {
   "id": "W30",
   "concept": "Push the value chain down / commoditise the experience",
   "quote": "\"it takes the parts that would otherwise be custom-built and bespoke… and commoditises them into reusable primitives, so the only thing left to be custom is the top line, the experience\"",
   "source": "team/humans/dinis_cruz/briefs/06/03/v0.31.12__strategy-brief__sg-send-vault-as-platform-of-primitives.md",
   "date": "3 Jun 2026",
   "maturity": "developing",
   "class": "E",
   "class_label": "Extension",
   "class_note": "**[E]**",
   "page": null
  },
  {
   "id": "W31",
   "concept": "Honest mapping / do not overclaim",
   "quote": "\"**even in the tracked (free) mode, the data is still encrypted; we still do not have access to the full data, so the privacy properties still hold.** The maps should not overclaim.\" and \"Is there a map that shows us badly? Worth drawing, as the test of whether these are analysis or marketing\"",
   "source": "…/v0.27.60__strategy-brief__sg-send-wardley-maps-setup-and-mermaid-capability.md` and `…/v0.33.53__strategy-brief__sg-send-wardley-map-of-the-airgapped-register…md",
   "date": "24 May / 28 Jul 2026",
   "maturity": "mature",
   "class": "O",
   "class_label": "Original contribution",
   "class_note": "**[O]**",
   "page": "/shipped/index.html"
  }
 ]
}