Files
markitect-main/examples/supply-chain-vsm/artifacts/guidelines/mapping-rules.md
tegwick 574bb11db6 feat(example): add supply-chain-vsm composition demo (S3.5)
Demonstrates infospace composition: the Wealth of Nations infospace is
used as a discipline, applying Smith's economic framework as a lens to
analyse modern supply chain management concepts.

New example: examples/supply-chain-vsm/
- infospace.yaml binding WoN as discipline (../infospace-with-history)
- 3 source documents: coordination mechanisms, capital & inventory,
  market structure (~400 words each, original content)
- supply-chain-entity-schema-v1.0.md with WoN Concept required section
- won-mapping-schema-v1.0.md with Conceptual Continuity rating
- artifacts/won-reference/core-entities.md — 12 curated WoN entities
  for injection as discipline context
- 8 hand-crafted entity files demonstrating LLM output format
- 3 mapping files with full rationale and VSM inheritance chains
- Viable: YES (5/5 thresholds)

Key mappings demonstrated:
  Demand Signal          → Effectual Demand        (Strong, S2)
  Vendor-Managed Inventory → Division of Labour    (Strong, S1/S2)
  Just-in-Time Inventory → Circulating Capital     (Strong, S1/S3)
  Bullwhip Effect        → Natural Price           (Moderate, S2)
  Platform Intermediary  → Merchant Capital        (Strong, S2/S4)
  Monopsony Power        → Combination of Masters  (Strong, S3*)

Platform fix: entity_parser.py now recognises ## Supply Chain Domain
as a domain alias for ## Economic Domain, enabling composed infospaces
to use their own domain section name.

Tutorial §13 rewritten with real commands, real output, and the full
mapping table from the demo.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-23 00:08:51 +01:00

61 lines
2.7 KiB
Markdown

# WoN Mapping Rules — Supply Chain Infospace
## Purpose of Mapping
The mapping stage asks: which Wealth of Nations concept does this supply
chain entity most directly correspond to? The goal is not to find a
superficial name match but to identify structural correspondence — same
mechanism, same trade-off, same systemic role — even when the surface form
is entirely different.
Smith had no concept of just-in-time inventory or logistics platforms. But
he had detailed accounts of circulating capital, merchant intermediaries,
and market price oscillation. The mapping discipline asks whether modern
concepts are genuinely new structures or modern instantiations of mechanisms
Smith already described.
## Mapping Strength Calibration
**Strong**: The modern concept and the WoN concept are the same mechanism
in different historical settings. The supply chain entity could be used
as an example in a modern edition of Smith's chapter, with only contextual
updating needed.
Example: Vendor-Managed Inventory is a Strong map to Division of Labour —
the function of inventory management is delegated to the party with the
greatest competence and information, which is precisely Smith's argument
for specialisation.
**Moderate**: The concepts share structural logic but differ in important
ways — the modern concept has features Smith's lacks, or operates under
conditions Smith did not analyse. The WoN concept illuminates the modern
concept but does not fully characterise it.
Example: Bullwhip Effect is a Moderate map to Natural Price as Central Price —
both describe oscillation of a market signal around a theoretical equilibrium,
but the bullwhip's amplification mechanism is an information distortion Smith
did not analyse in this form.
**Weak**: The mapping is analogical — useful for analysis but the
correspondence is partial or strained. The WoN concept provides a useful
frame but should not be treated as explanatory of the modern concept.
## One-to-Many Mappings
A supply chain entity may map to more than one WoN concept. Where this
occurs, create a separate mapping entry for each WoN concept, explaining
the different facets each illuminates.
## Unmappable Entities
If no plausible WoN mapping exists (the concept is genuinely novel),
document this explicitly with a brief explanation of what Smith's framework
lacks that would be needed to capture the concept.
## VSM Inheritance
Every WoN entity in the reference set has a VSM system assignment. When
a supply chain entity maps to a WoN entity, it inherits that VSM position.
If the supply chain entity maps to multiple WoN entities with different VSM
assignments, note the primary inheritance and explain any secondary VSM roles.