Markdown Editor

Wardley Map Template

Strategic question, users and needs, value chain, evolution assessment, quadrant map and map source, movement, inertia, options and gameplay, doctrine, decision, signposts

आर्किटेक्चरपूर्णWardley Maps (Simon Wardley, concept names only)wardleymap
एडिटर में खोलें.md डाउनलोड करें

उपयोग कैसे करें: Use it when a sourcing, investment or timing decision needs shared context rather than opinions. Fill the strategic question, the users and needs, and the value chain first, then argue evolution positions with evidence before discussing options. The main pitfall is placing components by how new they feel inside the organisation instead of how evolved they are in the market.

प्रीव्यू

Wardley Map: [Strategic question] for [Organisation]

Strategy document built around one Wardley map: the user and the need that anchor it, the value chain of components that meets the need, an evolution assessment for each component, the expected movement and the forces behind it, inertia, the options and gameplay considered, a doctrine check, and the decision with signposts for review. Wardley mapping was created by Simon Wardley, who published his book Wardley Maps under the Creative Commons Attribution-ShareAlike 4.0 licence; this template uses the method's concept names only and is written in original words. Replace every [bracketed] value and every row marked Example.

Document control

FieldValue
Document ID[WM-001]
Strategic question[Should we build, buy or outsource route optimisation in the next 24 months?]
Organisation or scope[Organisation, business unit or product line]
Map owner (decision owner)[@decision-owner]
Facilitator[@architect-or-strategist]
Version[0.1]
Status[Draft / In review / Approved / Superseded]
Approvers/reviewers[@cto], [@coo], [@head-of-product]
Last updatedYYYY-MM-DD
Next scheduled reviewYYYY-MM-DD
Classification[Internal / Confidential]
Mapping session datesYYYY-MM-DD, YYYY-MM-DD
Participants[Names and roles of the people who mapped]
Map file[Path to the map source, for example maps/route-optimisation.owm]

Approvals

RoleNameDecisionDate
Decision owner[@name][Approve / Approve with conditions / Reject]YYYY-MM-DD
Chief architect[@name][Decision]YYYY-MM-DD
Finance partner[@name][Decision]YYYY-MM-DD
Owner of the most affected component[@name][Decision]YYYY-MM-DD

Revision history

VersionDateAuthorChange summary
0.1YYYY-MM-DD[@name]First map from the discovery session
0.2YYYY-MM-DD[@name]Example: Evolution positions challenged by operations and fleet teams
1.0YYYY-MM-DD[@name]Example: Option O2 approved with signposts for review

Contents

1. Strategic question and scope

1.1 Question

[One sentence. It should name a choice, a scope and a time horizon.]

Example: Kestrelmoor Freight runs 420 trucks across three regions and sells next-day pallet delivery to business shippers. Its route planning is a ten-year-old in-house tool that two engineers maintain. The board asks whether to rebuild route optimisation, buy a product, or hand planning to a fourth-party logistics (4PL) platform within 24 months.

1.2 Scope and horizon

ItemValue
In scope[Products, services, capabilities or markets on the map]
Out of scope[What the map deliberately leaves out, and why]
Time horizon[12 to 36 months is typical for an operational strategy question]
Decision deadlineYYYY-MM-DD
Inputs[Strategy papers, capability map, tech radar, cost data, customer research]

1.3 Why a map

A Wardley map places the components that serve a user need on two dimensions: how visible each component is to the user (the vertical position, following the chain of needs from top to bottom) and how evolved it is (the horizontal position, from novel to commodity). The map shows context that a list or a slide cannot: which components are moving, which ones are dragging, where a choice about one component constrains another, and where the organisation is investing in the wrong kind of work. Use it when the question involves sourcing, timing, investment or competitive position. Do not use it as a system architecture diagram; the C4 model or a reference architecture serve that purpose better (architecture/c4-architecture, architecture/reference-architecture).

2. Users and needs

The anchor is the user at the top of the map. Choose the user whose need the strategic question serves. Some maps need two anchors, for example the shipper and the regulator; keep it to two at most.

Need IDUserNeed (in the user's words)TypeEvidence
NEED-001 (Example)Business shipper"Book a pallet collection in under two minutes"Table stakesCustomer interviews, booking funnel data
NEED-002 (Example)Business shipper"Know when the delivery will arrive, and trust it"DifferentiatorLost-deal reasons, net promoter comments
NEED-003 (Example)Business shipper"Pay a predictable price per pallet"Table stakesSales feedback
NEED-004 (Example)Receiving warehouse"Get deliveries inside the booked dock slot"DifferentiatorComplaints log
NEED-[NNN][User][Need][Table stakes / Differentiator][Source]

Keep needs as outcomes. "A route optimisation engine" is a component, not a need; "deliveries arrive in the promised window" is a need.

3. Value chain

3.1 Components

A component can be an activity, a practice, data or knowledge. Give each one a stable ID so movement and decisions can refer to it.

IDComponentKindDepends onServes needProvided by todayVisibility (0 to 1)
CMP-01 (Example)Online bookingActivityCMP-03, CMP-09NEED-001, NEED-003In-house web team0.85
CMP-02 (Example)Delivery time promise (ETA)ActivityCMP-04, CMP-05, CMP-07NEED-002, NEED-004Planners by hand0.78
CMP-03 (Example)PricingActivityCMP-09NEED-003Commercial team, spreadsheet rules0.72
CMP-04 (Example)Route optimisationActivityCMP-06, CMP-08NEED-002, NEED-004Legacy in-house tool0.58
CMP-05 (Example)ETA prediction modelKnowledge and activityCMP-07, CMP-09NEED-002Not yet built0.55
CMP-06 (Example)Maps and geocodingDataCMP-10Via CMP-04Licensed map data0.35
CMP-07 (Example)Vehicle telematicsData and activityCMP-10Via CMP-02, CMP-05Telematics vendor0.32
CMP-08 (Example)Driver mobile appActivityCMP-10Via CMP-04In-house mobile team0.45
CMP-09 (Example)Shipment data platformData and practiceCMP-10Via CMP-01, CMP-03, CMP-05In-house data team0.25
CMP-10 (Example)Compute and storageActivityNone on this mapAllLeased data centre racks0.10
CMP-[NN][Component][Kind][IDs][Need IDs][Provider][0 to 1]

3.2 Value chain diagram

The diagram shows dependency direction only (a component points to what it needs). The map in section 5 adds the evolution dimension.

4. Evolution assessment

4.1 Stages used in this template

The evolution axis runs from left (novel) to right (commodity). The four stage names below are the ones commonly used in Wardley mapping for activities. The numeric bands are a drawing convention used by this template and by common mapping tools, not a rule; agree the bands with the team and keep them stable between versions.

StageBand on the axisWhat you typically observe (original summary)
Genesis0.00 to 0.17Few examples exist, outcomes are uncertain, work is exploratory and failure is expected
Custom built0.17 to 0.40Several organisations have built their own; knowledge is growing but each build differs
Product (including rental)0.40 to 0.70Competing products exist with feature differences; buyers compare offerings
Commodity (including utility)0.70 to 1.00Widespread, well understood and standardised; bought on price, often metered

For data and knowledge, many practitioners rename the stages (for example from unmodelled to modelled data, or from concept to accepted knowledge). Use renamed stages only if everyone in the session agrees on them.

4.2 Assessment per component

IDComponentEvolution (0 to 1)StageEvidence for the position
CMP-01 (Example)Online booking0.62ProductSeveral freight booking products exist; competitors use them
CMP-02 (Example)Delivery time promise0.30Custom builtFew regional carriers publish reliable windows; each does it differently
CMP-03 (Example)Pricing0.48ProductRating engines are sold as products; rules are well understood
CMP-04 (Example)Route optimisation0.60ProductMany vendors sell vehicle routing with comparable features and published benchmarks
CMP-05 (Example)ETA prediction model0.28Custom builtMethods are known, but accuracy depends on own telematics history; no product fits regional pallet networks
CMP-06 (Example)Maps and geocoding0.80CommodityMetered APIs from many providers, price competition
CMP-07 (Example)Vehicle telematics0.68Product, moving to commodityHardware standardised, data feeds via standard APIs
CMP-08 (Example)Driver mobile app0.50ProductDriver app products exist; own app adds little
CMP-09 (Example)Shipment data platform0.58ProductCloud data platforms are products; the practice is established
CMP-10 (Example)Compute and storage0.92CommodityUtility cloud services, metered

4.3 Disagreements recorded

IDPositions proposedWhoResolution
CMP-04 (Example)0.35 (operations) versus 0.60 (architecture)Head of planning, chief architectOperations saw the legacy tool as unique; market scan of eight vendors placed it at 0.60. Accepted 0.60, recorded as assumption A-02
[ID][Positions][Names][Outcome and evidence]

5. The map

5.1 Plotted positions

The chart plots each component at (evolution, visibility). Mermaid does not draw dependency lines or movement on a quadrant chart; read it with the value chain in section 3.2 and the movement in section 6.

5.2 Map source

Keep the map in a text format under version control. The block below uses the syntax of the open-source OnlineWardleyMaps tool, where each component is written as [visibility, evolution], -> is a dependency and evolve shows intended movement. Check the tool's documentation for the current syntax.

title Kestrelmoor Freight route planning map
anchor Business shipper [0.95, 0.63]
component Online booking [0.85, 0.62]
component Delivery time promise [0.78, 0.30]
component Pricing [0.72, 0.48]
component Route optimisation [0.58, 0.60]
component ETA prediction model [0.55, 0.28]
component Driver mobile app [0.45, 0.50]
component Maps and geocoding [0.35, 0.80]
component Vehicle telematics [0.32, 0.68]
component Shipment data platform [0.25, 0.58]
component Compute and storage [0.10, 0.92]
Business shipper->Online booking
Business shipper->Delivery time promise
Business shipper->Pricing
Online booking->Pricing
Online booking->Shipment data platform
Pricing->Shipment data platform
Delivery time promise->Route optimisation
Delivery time promise->ETA prediction model
Delivery time promise->Vehicle telematics
Route optimisation->Maps and geocoding
Route optimisation->Driver mobile app
ETA prediction model->Vehicle telematics
ETA prediction model->Shipment data platform
Maps and geocoding->Compute and storage
Vehicle telematics->Compute and storage
Driver mobile app->Compute and storage
Shipment data platform->Compute and storage
evolve Delivery time promise 0.45
evolve Vehicle telematics 0.78
inertia Route optimisation

5.3 First reading

Write three to five observations that the map makes visible. Each one should point at a component ID.

  • Example: The differentiating need (NEED-002) depends on two custom-built components (CMP-02, CMP-05) and on CMP-04 and CMP-07, which are at the product stage. The company spends most engineering effort on CMP-04, the product, and none on CMP-05, the custom-built component that would make the promise reliable.
  • Example: Compute (CMP-10) is a commodity run on leased racks. That ties two operations staff to undifferentiated work.
  • Example: Telematics (CMP-07) is moving towards commodity; feeds are standard, which lowers the cost of the data that CMP-05 needs.

6. Movement and forces

Components evolve from left to right as supply and demand competition spread them. Wardley calls the recurring forces that act on every map "climatic patterns"; the published catalogue is long, and this template names only the handful a team most often needs. Read the source for the full set and describe the forces in your own words.

IDComponentExpected movement over the horizonForce behind it (own words)EvidenceConfidence
MOV-01 (Example)CMP-07 Vehicle telematics0.68 to 0.78Competition among vendors and standard data APIs push it towards utility pricingThree vendors moved to per-vehicle monthly fees this yearHigh
MOV-02 (Example)CMP-02 Delivery time promise0.30 to 0.45Shippers now expect tracked windows from parcel networks and carry that expectation to pallet freightTender requirements from four large shippersMedium
MOV-03 (Example)CMP-04 Route optimisation0.60 to 0.65Mature products add features; differences narrowMarket scan, analyst notesMedium
MOV-04 (Example)CMP-05 ETA prediction modelStays custom builtAccuracy depends on proprietary telematics historyPilot results from one regionMedium
MOV-[NN][ID and name][From to][Force][Evidence][High / Medium / Low]

Points to consider for each component:

  • Commoditisation: as a component becomes a commodity, new higher order components become possible on top of it.
  • Co-evolution of practice: when an activity becomes a utility, the way people work with it changes too (for example, operations practice changed when compute became a utility).
  • Efficiency enabling new demand: a cheaper component often raises total consumption rather than lowering total spend.
  • Competitor moves: a competitor or supplier can accelerate the evolution of a component, for example by releasing it as open source.

7. Inertia and constraints

IDComponentSource of inertia or constraintEffectOwnerMitigation idea
INR-01 (Example)CMP-04 Route optimisationTen years of custom rules for depot cut-off times in the legacy toolPlanners distrust a product that does not reproduce every ruleHead of planningRun a shadow comparison for four weeks before switching
INR-02 (Example)CMP-10 Compute and storageRacks leased until YYYY-MM-DDPaying twice if moved earlyInfrastructure leadMove new workloads first; let the lease expire
INR-03 (Example)CMP-08 Driver mobile appUnion agreement on driver device changesChange needs consultationHR business partnerStart consultation early, keep the app look unchanged in phase 1
INR-[NN][ID][Source][Effect][@owner][Idea]

Constraints that are not inertia (legal, safety, budget) belong here too. Name the source and its date; for regulated subjects, check the current official text and a qualified professional.

8. Options and gameplay

8.1 Options

The method also catalogues deliberate moves, called gameplays (for example using open approaches to speed up commoditisation, or building on a utility to free effort for novel work). Describe each option in your own words and name any gameplay it relies on.

OptionDescriptionMap effectGameplay used (own words)
O1 (Example)Rebuild route optimisation in-house and keep the legacy rulesInvests in a product-stage component as if it were custom builtNone; continues the current path
O2 (Example)Buy a route optimisation product, move compute to a cloud utility, and build the ETA prediction model in-houseTreats CMP-04 and CMP-10 by their stage and puts own effort into CMP-05, which drives the differentiating needUse commodity and product components to free effort for the custom-built differentiator
O3 (Example)Outsource planning to a 4PL platformMoves CMP-02, CMP-04 and CMP-05 outside the companyExit the activity; rely on a partner's scale
O[N][Description][Effect][Gameplay]

8.2 Cost over the horizon

OptionCost basis (Example)Three-year cost (EUR million)
O1 (Example)Seven-person routing team at EUR 0.70 million a year for three years2.10
O2 (Example)Product licence EUR 0.18 million a year for three years (0.54), integration 0.21, three-person ETA model team at EUR 0.30 million a year for three years (0.90)1.65
O3 (Example)Platform fee EUR 0.42 million a year for three years (1.26), migration 0.341.60

8.3 Comparison

Scores run from 1 (poor) to 5 (strong). The weighted score is the sum of weight times score, divided by 100. Agree weights before scoring.

CriterionWeightO1O2O3
Strengthens the differentiating need (NEED-002)30241
Time to value20145
Three-year cost (section 8.2)25233
Risk and inertia (section 7)15242
Learning and option value10341
Weighted score (Example)1001.903.752.45

The score supports the discussion; it does not replace it. If the result depends on one weight, show the sensitivity and record it.

9. Doctrine check

Wardley describes doctrine as universal principles that help any organisation regardless of its map, grouped in phases. Read the published list at the source and assess yourself against it. The table below uses short, original paraphrases of common themes; extend it with the principles that matter for your question.

IDTheme (own words)Current stateGap for the chosen optionAction
DOC-01 (Example)Know who the users are and what they needStrong for shippers, weak for receiving warehousesNEED-004 rests on complaints onlyInterview ten receiving warehouses
DOC-02 (Example)Use methods suited to the stage (explore novel work, standardise commodity work)Same waterfall process for all workETA model needs short experimentsRun CMP-05 as a separate team with weekly releases
DOC-03 (Example)Remove duplication and biasTwo address cleansing routines in booking and planningCost and errorsUse one geocoding service (CMP-06)
DOC-04 (Example)Think small: small teams with clear purposePlatform team owns everything from racks to appsOverloadSplit into product team and platform team (architecture/team-api)
DOC-05 (Example)Use a common language for strategyMaps used only by architectsDecisions argued from slidesPresent this map at the steering board
DOC-[NN][Theme][State][Gap][Action]

10. Decision and plan

10.1 Decision

FieldValue
Decision[Option chosen]
Decided by[@decision-owner]
DateYYYY-MM-DD
Reason in map terms[Which components move, which need it strengthens]
Related decision record[ADR or decision log ID, see architecture/architecture-decision-log]

Example: O2 approved. Route optimisation and compute are sourced by their stage (product and utility); engineering effort moves to the ETA prediction model, the custom-built component behind the differentiating need. Recorded as ADR-031.

10.2 Sourcing per component

IDComponentStageSourcing after decisionTeam method
CMP-04 (Example)Route optimisationProductBuy, configureVendor management, configuration
CMP-05 (Example)ETA prediction modelCustom builtBuild in-houseSmall product team, experiments
CMP-10 (Example)Compute and storageCommodityRent as a utilityPlatform team, cost management
CMP-08 (Example)Driver mobile appProductBuy at contract renewalVendor management
[ID][Component][Stage][Build / Buy / Rent / Outsource][Method]

10.3 First moves

IDMoveOwnerDueLinked to
ACT-01 (Example)Select route optimisation product through a scored evaluation[@head-of-planning]YYYY-MM-DDCMP-04, architecture/technology-selection
ACT-02 (Example)Staff the ETA prediction team (three people)[@cto]YYYY-MM-DDCMP-05
ACT-03 (Example)Plan cloud move of new workloads before lease end[@infrastructure-lead]YYYY-MM-DDCMP-10, INR-02
ACT-[NN][Move][@owner]YYYY-MM-DD[IDs]

11. Assumptions, risks and signposts

IDAssumption or riskLinked toSignpost that would trigger reviewCheck frequency
A-01 (Example)Shippers will pay for reliable delivery windowsNEED-002, MOV-02Win rate on tenders citing windows falls below the baseline for two quartersQuarterly
A-02 (Example)Route optimisation is a product (0.60), not custom builtCMP-04, section 4.3The shadow comparison shows the product misses more than an agreed share of depot rulesOnce, after pilot
R-01 (Example)A competitor releases an open ETA service, commoditising CMP-05CMP-05Public release or partner announcementMonthly scan
[ID][Statement][IDs][Signpost][Frequency]

11.1 Traceability

NeedComponentsMovementOption elementActionSignpost
NEED-002 (Example)CMP-02, CMP-04, CMP-05, CMP-07MOV-01, MOV-02, MOV-04O2: build CMP-05, buy CMP-04ACT-01, ACT-02A-01, A-02, R-01
NEED-001 (Example)CMP-01, CMP-03, CMP-09NoneNo changeNoneNone
[Need][IDs][IDs][Element][IDs][IDs]

12. Glossary and references

12.1 Glossary

TermMeaning in this document
AnchorThe user whose need sits at the top of the map
Value chainThe chain of components needed to meet the anchor's need, ordered by visibility
VisibilityHow directly the user sees or touches a component (vertical position)
EvolutionHow far a component has moved from novel to commodity in its market (horizontal position)
GenesisStage of novel, uncertain components with few examples
Custom builtStage where organisations build their own versions
ProductStage of competing products, including rental
CommodityStage of standard, widespread components, often sold as a utility
InertiaResistance to change caused by past investment, contracts, skills or beliefs
Climatic patternA force that affects every map regardless of the organisation's choices
GameplayA deliberate move to change the map in the organisation's favour
DoctrineUniversal principles of good practice that apply regardless of the map
SignpostAn observable event that triggers a review of the decision

12.2 References

ReferenceVersion or date checkedUse
Simon Wardley, Wardley Maps (book, CC BY-SA 4.0), free editions listed at learnwardleymapping.com/book/Checked 2026-10-30Concept names: map, anchor, value chain, evolution stages, climatic patterns, gameplay, doctrine (no text used)
OnlineWardleyMaps, open-source mapping tool, onlinewardleymaps.comChecked YYYY-MM-DDText syntax of the map source in section 5.2
Related templates: architecture/build-vs-buy-analysis, architecture/solution-options-analysis, architecture/technology-selection, architecture/tech-radar, architecture/business-capability-map, architecture/context-map, business/swot, mba/mba-technology-strategy-guideCurrent versionsDetailed option analysis, capability IDs and strategy context
[Internal strategy or market research][Version][Use]

Standard and licence note

Structure aligned with the Wardley mapping method created by Simon Wardley and described in his book Wardley Maps, which he published under the Creative Commons Attribution-ShareAlike 4.0 International licence (CC BY-SA 4.0). This template uses only the method's concept names (map, anchor, value chain, visibility, evolution and its four stage names, inertia, climatic patterns, gameplay and doctrine). It does not reproduce the book's text, figures, the evolution cheat sheet, the list of climatic patterns, the gameplay catalogue or the doctrine table; every explanation, table and example here is original, so the ShareAlike condition does not attach to this template. If you adapt text or figures from the book into your own copy, attribute Simon Wardley and release those adapted parts under CC BY-SA 4.0. The numeric evolution bands are a drawing convention of this template, not part of the method. Kestrelmoor Freight is fictional. Check the current edition of the book at learnwardleymapping.com before use. Template licence: MIT.

संबंधित टेम्पलेट