feat(llm): add LLM integration module with OpenRouter and Claude Code adapters

Implements markitect/llm/ package with concrete LLMAdapter implementations:
- OpenRouterAdapter: HTTP via urllib with retry/backoff on 429/5xx
- ClaudeCodeAdapter: subprocess-based Claude CLI with stdin piping
- Factory pattern: create_adapter("openrouter") or create_adapter("claude-code")
- API key resolution chain: constructor > env var > project-root key file
- 42 unit tests, 2 integration tests (gated on API key / CLI availability)

Also adds the infospace-with-history example with Wealth of Nations VSM
analysis pipeline, templates, schemas, source chapters, and processed
output for chapters 1-2. process_chapters.py now supports --provider
and --model flags for automatic LLM-driven processing.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-02-11 01:17:58 +01:00
parent 360c3b1de2
commit fecc2fd4fa
82 changed files with 43767 additions and 0 deletions

View File

@@ -0,0 +1,413 @@
--- MAPPING: division-of-labour-to-s1 ---
# Division of Labour -> System 1 (Operations)
## Economic Entity Reference
Division of Labour — the separation of a work process into distinct specialised
tasks to increase productive power.
## VSM Concept Reference
System 1 (Operations) — the primary activities that produce the organisation's
purpose, each of which is itself a viable system.
## Mapping Rationale
The division of labour fundamentally defines how System 1 operational units are
structured. By decomposing production into specialised tasks, Smith describes
the internal architecture of operational units. Each specialised worker or
workgroup becomes a sub-unit within S1, performing a discrete operation. The
pin factory's eighteen distinct operations represent eighteen operational
elements within a single S1 unit, each contributing to the factory's overall
productive purpose. This mapping reflects Beer's principle that S1 units are
where value is directly created through operational activity.
## Mapping Strength
Strong
--- MAPPING: division-of-labour-to-recursion ---
# Division of Labour -> Recursion
## Economic Entity Reference
Division of Labour — the separation of a work process into distinct specialised
tasks to increase productive power.
## VSM Concept Reference
Recursion — the principle that every viable system contains and is contained
in a viable system, with the same five-system structure recurring at every level.
## Mapping Rationale
Smith's analysis of the division of labour operates at multiple recursive
levels simultaneously. Within the pin factory, labour is divided among ten
workers (micro-recursion). Across society, trades separate into distinct
occupations — farmer, manufacturer, philosopher (meso-recursion). Between
nations, rich and poor countries specialise in different products (macro-recursion).
This multi-level structure maps directly to Beer's recursion principle: the
same pattern of specialisation and coordination recurs at every organisational
level, from the individual workshop to the national economy.
## Mapping Strength
Strong
--- MAPPING: productive-powers-of-labour-to-s1 ---
# Productive Powers of Labour -> System 1 (Operations)
## Economic Entity Reference
Productive Powers of Labour — the capacity of human labour to produce output,
measured in terms of quantity and quality of goods per worker per unit time.
## VSM Concept Reference
System 1 (Operations) — the primary activities that produce the organisation's
purpose.
## Mapping Rationale
Productive power is the measure of System 1 performance. Beer's S1 is defined
by its capacity to produce the organisation's purpose; Smith's productive
powers of labour quantify exactly this capacity. The 4,800-fold improvement
in pin production under the division of labour represents a dramatic increase
in S1 operational effectiveness. Productive power is not a system itself but
the key performance indicator of how well S1 units function.
## Mapping Strength
Strong
--- MAPPING: dexterity-of-the-workman-to-s1 ---
# Dexterity of the Workman -> System 1 (Operations)
## Economic Entity Reference
Dexterity of the Workman — the skill and speed acquired through repeated
performance of a single specialised operation.
## VSM Concept Reference
System 1 (Operations) — the primary activities that produce the organisation's
purpose.
## Mapping Rationale
Dexterity is a property of individual S1 operational units. As each worker
becomes more proficient through specialisation, their operational unit
becomes more effective at its designated function. In Beer's terms, dexterity
represents the self-optimisation capacity of an S1 element: through practice
and focus, the operational unit improves its own performance without external
intervention. This aligns with Beer's principle that S1 units possess autonomy
and self-organisation within their operational domain.
## Mapping Strength
Strong
--- MAPPING: saving-of-time-to-s2 ---
# Saving of Time -> System 2 (Coordination)
## Economic Entity Reference
Saving of Time — the elimination of time lost when workers pass from one kind
of work to another.
## VSM Concept Reference
System 2 (Coordination) — the information channels and bodies that allow
System 1 units to communicate and coordinate, dampening oscillations.
## Mapping Rationale
The saving of time through specialisation is fundamentally a coordination
gain. When workers are permanently assigned to single tasks, the need for
coordination between tasks within one person is eliminated — there is no
oscillation between modes of work. Smith's description of "sauntering" when
switching tasks is precisely the kind of oscillation that System 2 is
designed to dampen. By fixing each worker to one operation, the division
of labour reduces the variety of coordination required, acting as a
structural implementation of S2's anti-oscillatory function.
## Mapping Strength
Moderate
--- MAPPING: invention-of-machinery-to-s4 ---
# Invention of Machinery -> System 4 (Intelligence/Adaptation)
## Economic Entity Reference
Invention of Machinery — the development of machines that facilitate and
abridge labour, stimulated by the focused attention of specialised workers.
## VSM Concept Reference
System 4 (Intelligence/Adaptation) — the bodies and processes that scan the
environment and drive adaptation for continued viability.
## Mapping Rationale
Invention represents the adaptive capacity of the economic system. Workers
who discover improvements to their specific operations, machine-makers who
develop new tools, and philosophers who combine knowledge from distant
fields all perform an S4 function: they observe the current state of
operations, identify opportunities for improvement, and introduce innovations
that change how S1 units operate. Smith's observation that the division of
labour itself stimulates invention shows how S1 operational focus feeds
into S4 intelligence — a feedback loop fundamental to Beer's model of
adaptive viability.
## Mapping Strength
Strong
--- MAPPING: separation-of-trades-to-s1 ---
# Separation of Trades -> System 1 (Operations)
## Economic Entity Reference
Separation of Trades — the process by which distinct occupations emerge
as separate specialisations performed by dedicated practitioners.
## VSM Concept Reference
System 1 (Operations) — the primary activities that produce the
organisation's purpose.
## Mapping Rationale
The separation of trades describes the differentiation of System 1 into
distinct operational units. In Beer's VSM, S1 is not monolithic but
comprises multiple semi-autonomous operational units, each with its own
viable system structure. Smith's observation that in advanced societies
"the farmer is generally nothing but a farmer; the manufacturer, nothing
but a manufacturer" describes precisely this differentiation: each trade
becomes a distinct S1 unit with its own operational domain, its own
workers, and its own productive purpose.
## Mapping Strength
Strong
--- MAPPING: the-workman-to-s1 ---
# The Workman -> System 1 (Operations)
## Economic Entity Reference
The Workman — the individual labourer who performs productive work, the
operative unit whose dexterity, time, and inventiveness are the channels
through which specialisation increases output.
## VSM Concept Reference
System 1 (Operations) — the primary activities that produce the
organisation's purpose.
## Mapping Rationale
The workman is the fundamental S1 element at the lowest level of recursion.
Each specialised worker constitutes an operational unit that directly produces
value. In Beer's terms, the workman at the pin factory — drawing wire,
straightening it, cutting it — is an S1 unit within the larger S1 of the
factory, which is itself an S1 unit within the industry. The workman embodies
the S1 properties of autonomy (within their task domain), self-organisation,
and direct engagement with the productive environment.
## Mapping Strength
Strong
--- MAPPING: the-philosopher-to-s4 ---
# The Philosopher -> System 4 (Intelligence/Adaptation)
## Economic Entity Reference
The Philosopher — a person whose occupation is observation and speculation,
combining knowledge from diverse fields to produce innovations.
## VSM Concept Reference
System 4 (Intelligence/Adaptation) — the bodies and processes that look
outward to the environment and drive adaptation.
## Mapping Rationale
The philosopher performs the quintessential S4 function. Their "trade is not
to do any thing, but to observe every thing" — precisely the environmental
scanning and intelligence-gathering role that Beer assigns to System 4.
Philosophers combine knowledge from "the most distant and dissimilar objects,"
integrating information across domains to produce novel understanding. This
cross-domain synthesis is the core S4 activity: building models of the
environment and identifying adaptive responses. Smith's observation that
philosophy itself becomes specialised through the division of labour shows
S4 developing its own internal S1 structure (recursion).
## Mapping Strength
Strong
--- MAPPING: universal-opulence-to-viability ---
# Universal Opulence -> Viability
## Economic Entity Reference
Universal Opulence — the general material well-being extending to all ranks
of society as a consequence of the division of labour and exchange.
## VSM Concept Reference
Viability — the capacity of a system to maintain a separate existence and
survive in a changing environment.
## Mapping Rationale
Universal opulence is the emergent outcome of a viable economic system.
Beer defines viability as the system's capacity to sustain itself; Smith's
universal opulence demonstrates that a well-functioning economic system
(with proper division of labour and exchange) sustains not just itself but
all its constituent members. The fact that even the "meanest person in a
civilized country" enjoys goods requiring the cooperation of thousands
demonstrates systemic viability: the whole system maintains itself through
the interdependent functioning of its parts. Viability is achieved not
through central direction but through the self-organising properties of
specialised, exchanging agents.
## Mapping Strength
Moderate
--- MAPPING: exchange-to-s2 ---
# Exchange -> System 2 (Coordination)
## Economic Entity Reference
Exchange — the act of trading surplus production for goods produced by
others.
## VSM Concept Reference
System 2 (Coordination) — the information channels and bodies that allow
System 1 units to communicate and coordinate.
## Mapping Rationale
Exchange is the primary coordination mechanism between specialised S1 units
in Smith's economic system. Without exchange, the division of labour cannot
function: workers must be able to trade their surplus for others' products.
Exchange carries both goods and information (prices signal relative scarcity
and demand), serving as the communication channel between operational units.
In Beer's framework, S2 ensures that S1 units do not oscillate destructively;
market exchange performs exactly this function by coordinating supply and demand
across specialised producers. Exchange is the economic system's S2.
## Mapping Strength
Strong
--- MAPPING: co-operation-of-labour-to-s2 ---
# Co-operation of Labour -> System 2 (Coordination)
## Economic Entity Reference
Co-operation of Labour — the interdependent collaboration of many workers
across different trades and locations to produce a single finished good.
## VSM Concept Reference
System 2 (Coordination) — the information channels and bodies that allow
System 1 units to communicate and coordinate.
## Mapping Rationale
The vast network of co-operation Smith describes — shepherds, miners, sailors,
weavers, merchants — requires coordination mechanisms to function. No central
authority orchestrates the production of the day-labourer's coat; instead,
market exchange, trade customs, and commercial practice coordinate thousands
of independent S1 units. Co-operation of labour is the observable result of
effective S2 coordination: it demonstrates that the system's coordination
mechanisms successfully link diverse operational units into a coherent
productive whole.
## Mapping Strength
Moderate
--- MAPPING: manufactures-to-s1 ---
# Manufactures -> System 1 (Operations)
## Economic Entity Reference
Manufactures — the sector of production in which raw materials are
transformed into finished goods through specialised operations.
## VSM Concept Reference
System 1 (Operations) — the primary activities that produce the
organisation's purpose.
## Mapping Rationale
The manufacturing sector constitutes a major S1 domain at a high level of
recursion. Each individual manufacture (pin-making, wool-weaving, hardware
production) is an S1 operational unit, and the sector as a whole represents
a class of S1 activities. Smith's analysis shows that manufactures exhibit
the highest degree of internal division of labour, meaning their S1 units
are the most finely differentiated and therefore the most productive. This
aligns with Beer's observation that S1 effectiveness depends on appropriate
internal structuring.
## Mapping Strength
Strong
--- MAPPING: agriculture-to-s1 ---
# Agriculture -> System 1 (Operations)
## Economic Entity Reference
Agriculture — the sector of production concerned with cultivation of land
and raising of crops and livestock.
## VSM Concept Reference
System 1 (Operations) — the primary activities that produce the
organisation's purpose.
## Mapping Rationale
Agriculture constitutes an S1 domain that, by its nature, resists fine
subdivision. The seasonal constraints Smith identifies — the ploughman,
harrower, sower, and reaper must often be the same person — mean that
agricultural S1 units cannot be as finely specialised as manufacturing ones.
This is significant from a VSM perspective: it shows that the viability of
S1 structures depends on environmental constraints. Agriculture's lower
productivity gains from division of labour reflect the limits imposed on
S1 differentiation by the natural environment.
## Mapping Strength
Strong
## Counter-arguments
Agriculture could also be mapped to S1 at a lower level of recursion (the
individual farm), where the farmer's multiple roles (ploughing, sowing,
reaping) represent undifferentiated S1 activities within a single viable
system rather than distinct S1 units.

View File

@@ -0,0 +1,704 @@
# Map Economic Entities to VSM Concepts
You are a systems theorist specializing in Stafford Beer's Viable System Model.
Your task is to map extracted economic entities to VSM concepts.
## Extracted Entities
--- ENTITY: division-of-labour ---
# Division of Labour
## Definition
The separation of a work process into a number of distinct tasks, each performed
by a specialised worker, resulting in a significant increase in the productive
powers of labour. Smith identifies it as the principal cause of improvement in
the productive capacity of any trade, art, or manufacture. The effect arises
from three circumstances: increased dexterity, saved time in transition between
tasks, and the invention of labour-saving machinery.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
The division of labour is the central argument of the chapter. Smith opens by
asserting that it is the greatest source of improvement in productive powers,
then illustrates it through the pin-factory example, explains its three causal
mechanisms, and concludes by showing how it generates universal opulence through
exchange.
## Economic Domain
Production
## Smith's Original Wording
"The greatest improvements in the productive powers of labour, and the greater
part of the skill, dexterity, and judgment, with which it is anywhere directed,
or applied, seem to have been the effects of the division of labour."
## Modern Interpretation
The division of labour remains a foundational concept in economics and
organisational theory. Modern extensions include specialisation theory,
comparative advantage (Ricardo), and the study of transaction costs that
determine the boundaries between internal division and market exchange (Coase).
--- ENTITY: productive-powers-of-labour ---
# Productive Powers of Labour
## Definition
The capacity of human labour to produce output, measured in terms of the
quantity and quality of goods a given number of workers can produce within
a given time. Smith argues that the division of labour is the primary cause
of increases in productive power, and that differences in productive power
explain differences in national wealth.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Smith introduces productive powers as the dependent variable that the division
of labour improves. He contrasts the output of an unskilled individual worker
(one pin per day) with the output of a coordinated team under division of
labour (4,800 pins per person per day) to demonstrate the scale of improvement.
## Economic Domain
Production
## Smith's Original Wording
"This great increase in the quantity of work, which, in consequence of the
division of labour, the same number of people are capable of performing, is
owing to three different circumstances."
--- ENTITY: dexterity-of-the-workman ---
# Dexterity of the Workman
## Definition
The skill and speed a worker acquires through repeated performance of a single
specialised operation. Smith identifies the increase in dexterity as the first
of three causes by which the division of labour improves productive power.
Specialisation reduces each worker's task to one simple operation, making it
the sole employment of their life, and thereby dramatically increasing their
proficiency.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Presented as the first of three mechanisms explaining why the division of labour
increases output. Smith illustrates it with the example of nail-making: an
unskilled smith makes 200-300 nails per day, while a specialised nailer can
produce over 2,300.
## Economic Domain
Production
## Smith's Original Wording
"First, the improvement of the dexterity of the workmen, necessarily increases
the quantity of the work he can perform; and the division of labour, by reducing
every man's business to some one simple operation, and by making this operation
the sole employment of his life, necessarily increases very much the dexterity
of the workman."
--- ENTITY: saving-of-time ---
# Saving of Time
## Definition
The elimination of time lost when a worker passes from one kind of work to
another. Smith identifies this as the second mechanism by which the division of
labour increases productive power. Time is lost both in physical transition
(moving between locations and tools) and in mental transition (the sauntering
and inattention that follows switching tasks).
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Presented as the second of three mechanisms. Smith argues the loss is greater
than commonly supposed, encompassing not only travel time but a psychological
cost: workers who constantly switch tasks develop habits of "sauntering" and
"indolent careless application" that reduce their output even during active work.
## Economic Domain
Production
## Smith's Original Wording
"Secondly, the advantage which is gained by saving the time commonly lost in
passing from one sort of work to another, is much greater than we should at
first view be apt to imagine it."
--- ENTITY: invention-of-machinery ---
# Invention of Machinery
## Definition
The development of machines that facilitate and abridge labour, enabling one
person to do the work of many. Smith identifies this as the third mechanism
by which the division of labour increases productive power, and argues that
the division of labour itself stimulates invention, because workers focused
on a single operation naturally discover improvements to their specific task.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Presented as the third mechanism. Smith provides the anecdote of the boy who
automated the valve on a fire engine to free himself for play. He extends the
argument beyond workers to include machine-makers and philosophers (men of
speculation), whose own specialised observation enables them to combine
knowledge from distant fields.
## Economic Domain
Production
## Smith's Original Wording
"Thirdly, and lastly, everybody must be sensible how much labour is facilitated
and abridged by the application of proper machinery. It is unnecessary to give
any example."
--- ENTITY: separation-of-trades ---
# Separation of Trades
## Definition
The process by which distinct occupations emerge as separate specialisations,
each performed by dedicated practitioners rather than by a single person who
performs all tasks. Smith presents the separation of trades as both a
consequence and an indicator of the division of labour, noting that it
advances furthest in the most industrious and improved countries.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Smith transitions from the pin-factory example to the economy-wide observation
that in improved societies, "the farmer is generally nothing but a farmer; the
manufacturer, nothing but a manufacturer." He contrasts manufacturing, where
trades separate extensively, with agriculture, where seasonal demands prevent
full separation.
## Economic Domain
Production
## Smith's Original Wording
"The separation of different trades and employments from one another, seems to
have taken place in consequence of this advantage."
--- ENTITY: the-workman ---
# The Workman
## Definition
The individual labourer who performs productive work, whether in manufacturing
or agriculture. In the context of the division of labour, the workman is the
operative unit whose dexterity, time, and inventiveness are the channels through
which specialisation increases output. Smith portrays the workman both as a
beneficiary of the division of labour (higher output) and as its agent
(inventing machinery through focused attention).
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
The workman appears throughout the chapter as the primary actor: the pin-maker,
the nailer, the country weaver, the boy at the fire engine. Smith attributes
both the productive gains and many mechanical inventions to ordinary workmen.
## Economic Domain
Production
--- ENTITY: the-philosopher ---
# The Philosopher
## Definition
A person whose occupation is observation and speculation rather than direct
production — "men of speculation, whose trade it is not to do any thing, but
to observe every thing." Smith treats the philosopher as an economic actor
whose specialised function is combining knowledge from diverse fields to
produce innovations and improvements, analogous to how the workman improves
their own narrow task.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Introduced near the end of Smith's discussion of the third mechanism (invention
of machinery). Smith notes that as society progresses, philosophy itself becomes
a specialised trade, subdivided into branches, with each philosopher becoming
expert in their field — the division of labour applied to intellectual work.
## Economic Domain
General Theory
## Smith's Original Wording
"In the progress of society, philosophy or speculation becomes, like every other
employment, the principal or sole trade and occupation of a particular class of
citizens."
--- ENTITY: universal-opulence ---
# Universal Opulence
## Definition
The general material well-being that extends across all ranks of society,
including the lowest, as a consequence of the division of labour and the
resulting multiplication of production. Smith argues that through exchange,
every workman can supply others abundantly with their specialised product
and receive in return the products of others' specialisation, creating a
"general plenty" that benefits even the poorest members of a civilised society.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
The concluding argument of the chapter. Smith illustrates universal opulence
by examining the "accommodation of the most common artificer or daylabourer,"
showing that even a coarse woollen coat requires the cooperation of shepherds,
wool-combers, dyers, weavers, merchants, sailors, and many others — a vast
chain of interdependent labour that would be impossible without specialisation
and exchange.
## Economic Domain
Distribution
## Smith's Original Wording
"It is the great multiplication of the productions of all the different arts,
in consequence of the division of labour, which occasions, in a well-governed
society, that universal opulence which extends itself to the lowest ranks of
the people."
--- ENTITY: exchange ---
# Exchange
## Definition
The act of trading one's surplus production for the goods produced by others.
Smith presents exchange as the mechanism by which the division of labour
translates into universal opulence: each workman disposes of their surplus
output and receives in return the surplus of others, so that all are
supplied beyond what any individual could produce alone.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Exchange appears in the chapter's conclusion as the connecting mechanism
between specialised production and general welfare. Smith implicitly treats
it as prerequisite to the division of labour (explored further in Chapter 2),
since specialisation only benefits workers if they can trade their surplus.
## Economic Domain
Exchange
## Smith's Original Wording
"Every workman has a great quantity of his own work to dispose of beyond what
he himself has occasion for; and every other workman being exactly in the same
situation, he is enabled to exchange a great quantity of his own goods for a
great quantity or, what comes to the same thing, for the price of a great
quantity of theirs."
--- ENTITY: co-operation-of-labour ---
# Co-operation of Labour
## Definition
The interdependent collaboration of many workers across different trades and
locations to produce a single finished good. Smith demonstrates that even the
simplest consumer goods in a civilised society require the combined efforts of
thousands of workers — shepherds, miners, sailors, smiths, weavers — who
collectively make possible what no individual could achieve alone.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Smith's extended example of the day-labourer's woollen coat serves to illustrate
the vast scope of co-operation. He traces the supply chain from raw materials
through manufacture and transport to show that civilised consumption depends on
an immense network of specialised, interdependent labour.
## Economic Domain
Production
## Smith's Original Wording
"Without the assistance and co-operation of many thousands, the very meanest
person in a civilized country could not be provided, even according to, what we
very falsely imagine, the easy and simple manner in which he is commonly
accommodated."
--- ENTITY: manufactures ---
# Manufactures
## Definition
The sector of production in which raw materials are transformed into finished
goods through a series of distinct operations, each typically performed by
specialised workers. Smith contrasts manufactures with agriculture, noting that
the former admits of far greater subdivision of labour and separation of trades,
and therefore exhibits far greater improvements in productive power.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Manufactures serve as the primary setting for Smith's analysis of the division
of labour. The pin factory is a manufacture; so are the linen, woollen, and
hardware trades he references. Smith uses the greater divisibility of
manufacturing work to explain why rich countries excel more conspicuously over
poor countries in manufactures than in agriculture.
## Economic Domain
Production
--- ENTITY: agriculture ---
# Agriculture
## Definition
The sector of production concerned with the cultivation of land and the raising
of crops and livestock. Smith argues that agriculture does not admit of as many
subdivisions of labour as manufactures, because seasonal rhythms prevent workers
from specialising year-round in a single task. As a result, agricultural
productivity improves less dramatically with the division of labour than
manufacturing productivity.
## Source Chapter
Book I, Chapter 1: "Of the Division of Labour"
## Context
Agriculture is introduced as a counterpoint to manufactures. Smith notes that
the ploughman, harrower, sower, and reaper are often the same person, and that
this is why even rich countries do not surpass poor countries in agricultural
output as dramatically as in manufacturing output.
## Economic Domain
Production
## Smith's Original Wording
"The nature of agriculture, indeed, does not admit of so many subdivisions of
labour, nor of so complete a separation of one business from another, as
manufactures."
## VSM Framework Reference
---
id: vsm-framework
name: vsm_framework
artifact_type: content
description: Stafford Beer's Viable System Model reference for economic analysis
version: 1.0.0
---
# Stafford Beer's Viable System Model (VSM)
The Viable System Model (VSM) is a model of the organisational structure of any
autonomous system capable of producing itself. It was created by management
cybernetician Stafford Beer in his books *Brain of the Firm* (1972) and
*The Heart of Enterprise* (1979).
## Core Principle: Viability
A viable system is any system organised in such a way as to meet the demands
of surviving in a changing environment. One of the prime features of systems
that survive is that they are adaptable. The VSM expresses a model for a
viable system, which is an abstracted cybernetic description applicable to
any organisation that is a going concern.
## The Five Systems
### System 1 (S1) — Operations
The primary activities that produce the organisation's purpose. These are the
operational units that directly create value. Each operational element is itself
a viable system (the principle of recursion).
**In economic terms:** Productive enterprises, factories, farms, workshops,
individual labourers performing specialised tasks, merchant operations.
**Key properties:** Autonomy within constraints, self-organisation,
direct engagement with the environment.
### System 2 (S2) — Coordination
The information channels and bodies that allow the primary activities in
System 1 to communicate with each other and that allow System 3 to monitor
and coordinate activities. System 2 dampens oscillations and resolves
conflicts between operational units.
**In economic terms:** Market price mechanisms, trade customs, standard
weights and measures, commercial law, banking clearinghouses, trade guilds.
**Key properties:** Anti-oscillatory, dampening, scheduling, conflict
resolution, standardisation.
### System 3 (S3) — Control / Operational Management
The structures and controls that establish the rules, resources, rights,
and responsibilities of System 1 and provide an interface between Systems 1
and Systems 4/5. System 3 represents the day-to-day control of the
organisation. It optimises the internal environment.
**In economic terms:** Government regulation of trade, taxation policy, labour
laws, enforcement of contracts, the "invisible hand" as emergent internal
regulation, guilds and corporations governing members.
**Key properties:** Internal regulation, resource allocation, accountability,
synergy extraction, performance management.
### System 3* (S3*) — Audit / Monitoring
The audit and monitoring channel that allows System 3 to verify information
coming from System 1 through channels other than those provided by System 2.
System 3* provides sporadic, direct access to operational reality.
**In economic terms:** Market inspections, quality checks, auditing of accounts,
surprise investigations into trade practices, verification of weights and measures.
**Key properties:** Sporadic direct investigation, reality checking, bypassing
normal reporting channels.
### System 4 (S4) — Intelligence / Adaptation
The bodies and processes that look outward to the environment to monitor
how the organisation needs to adapt to remain viable. System 4 captures
all relevant information about the outside-and-then environment. It is
responsible for strategic responses.
**In economic terms:** Foreign intelligence about trade opportunities,
market research, new technology adoption, colonial exploration and trade
route development, understanding of foreign economic systems.
**Key properties:** Environmental scanning, future orientation, strategic
planning, modelling, research and development.
### System 5 (S5) — Policy / Identity
The policy-making body that balances demands from Systems 3 and 4 and defines
the identity, values, and purpose of the organisation. System 5 provides
closure to the whole system and represents its supreme authority.
**In economic terms:** Sovereign authority, constitutional principles governing
economic policy, national economic identity, the philosophical foundations
of economic systems (mercantilism vs. free trade), the overarching purpose
of the commonwealth.
**Key properties:** Identity, ethos, supreme command, policy closure,
balancing internal and external perspectives.
## Key Concepts
### Recursion
Every viable system contains and is contained in a viable system. The same
five-system structure recurs at every level of organisation. A workshop is
a viable system within a factory, which is a viable system within an
industry, which is a viable system within a national economy.
### Variety
A measure of the number of possible states of a system. The Law of Requisite
Variety (Ashby's Law) states that only variety can absorb variety. A
controller must have at least as much variety as the system it controls.
### Requisite Variety
The principle that for effective regulation, the variety of the regulator
must match the variety of the system being regulated. This is achieved
through variety attenuation (reducing the variety coming up from operations)
and variety amplification (increasing the variety of management's responses).
### Attenuation and Amplification
Variety engineering mechanisms. Attenuation reduces variety (e.g., reporting
summaries, statistical aggregation, standardisation). Amplification increases
variety (e.g., delegation, empowerment, decentralisation).
### Algedonic Signals
Emergency signals that bypass the normal management hierarchy to alert
higher systems of critical situations requiring immediate attention. Named
from the Greek words for pain (algos) and pleasure (hedone).
**In economic terms:** Market panics, famine signals, sudden price collapses,
trade embargoes, economic crises that demand immediate sovereign intervention.
### Autonomy
The degree of freedom granted to operational units (System 1) to self-organise
within constraints set by System 3. Beer argued that maximum autonomy
consistent with systemic cohesion yields maximum viability.
### Viability
The capacity of a system to maintain a separate existence and survive in a
changing environment. A viable system continuously adapts while maintaining
its identity.
## Mapping Guidelines
---
id: mapping-rules
name: mapping_rules
artifact_type: content
description: Guidelines for mapping economic entities to VSM concepts
version: 1.0.0
---
# VSM Mapping Rules
## Mapping Principles
1. **Ground in Beer's definitions.** Every mapping rationale must reference
the specific VSM system function, not just a superficial resemblance.
2. **Prefer structural over metaphorical mappings.** A mapping is strong
when the economic entity performs the same *functional role* in Smith's
economic system as the VSM component performs in an organisation.
3. **Allow multiple mappings.** A single economic entity may map to
multiple VSM systems. For example, "the sovereign" may map to both
S3 (regulation) and S5 (policy). Create separate mapping documents
for each relationship.
4. **Respect recursion.** Consider at which level of recursion the mapping
applies. The division of labour within a single workshop (S1-level)
differs from the division of labour across an entire national economy
(higher recursion level).
## Mapping Strength Criteria
### Strong
- The entity directly performs the function of the VSM system.
- The mapping would be recognisable to a VSM practitioner without explanation.
- Example: "market price mechanism" → S2 (Coordination) — prices coordinate
supply and demand between producers.
### Moderate
- The entity partially performs the function or performs it in a limited context.
- The mapping requires some argument but is defensible.
- Example: "merchant" → S4 (Intelligence) — merchants gather information
about foreign markets, but this is not their primary function.
### Weak
- The mapping is speculative or metaphorical rather than structural.
- The connection exists but requires significant interpretive work.
- Example: "moral sentiments" → S5 (Policy) — broad ethical framework
shapes economic behaviour, but the connection is indirect.
## What NOT to Map
- Do not force mappings where none exist. It is valid for an entity to have
no clear VSM mapping — flag it with "Mapping Strength: Weak" and explain
the difficulty.
- Do not map purely descriptive/historical content that lacks functional
significance.
## VSM System Checklist
When mapping, consider each system:
| System | Question to Ask |
|--------|----------------|
| S1 | Does this entity directly produce value or output? |
| S2 | Does this entity coordinate between operational units? |
| S3 | Does this entity regulate internal operations? |
| S3* | Does this entity provide audit or verification? |
| S4 | Does this entity scan the environment or plan for the future? |
| S5 | Does this entity define identity, policy, or purpose? |
Also consider the key concepts:
- **Recursion**: At what level does this entity operate?
- **Variety**: Does this entity manage variety (attenuate or amplify)?
- **Algedonic signals**: Does this entity serve as an emergency signal?
- **Autonomy**: Does this entity relate to operational autonomy?
## Instructions
1. Review each extracted economic entity carefully.
2. For each entity, determine which VSM system(s) it most closely relates to.
3. Produce a mapping document for each entity-VSM relationship following
the VSM Mapping Schema v1.0.
4. Each mapping document must include:
- An H1 heading in the format "Entity Name -> VSM Concept Name"
- An Economic Entity Reference section
- A VSM Concept Reference section
- A Mapping Rationale section (minimum 30 words) grounded in Beer's definitions
- A Mapping Strength section rated as Strong, Moderate, or Weak
5. Where an entity maps to multiple VSM systems (recursion), create
separate mapping documents for each relationship.
6. Flag entities that don't clearly map to any VSM concept with a
"Mapping Strength: Weak" and note the difficulty in the rationale.
## Output Format
Output each mapping as a separate markdown document, delimited by
`--- MAPPING: <entity-name>-to-<vsm-concept> ---` markers.

View File

@@ -0,0 +1,275 @@
--- MAPPING: propensity-to-truck-barter-and-exchange-to-s5 ---
# Propensity to Truck, Barter, and Exchange -> System 5 (Policy/Identity)
## Economic Entity Reference
Propensity to Truck, Barter, and Exchange — an innate human disposition to
negotiate and trade, identified as the ultimate cause of the division of labour.
## VSM Concept Reference
System 5 (Policy/Identity) — the policy-making body that defines the identity,
values, and purpose of the organisation.
## Mapping Rationale
The propensity to exchange functions as the foundational identity principle of
the economic system. In Beer's VSM, System 5 defines what the system *is* — its
essential nature and purpose. Smith's claim that this propensity is a fundamental
feature of human nature (possibly arising from reason and speech) establishes
exchange as the defining characteristic of human economic organisation. It is
the principle from which all other economic structures emerge. Without it, Smith
argues, there would be no division of labour, no specialisation, no difference
of talents — the entire economic system would not exist. This is an identity-level
property: it defines the system rather than operating within it.
## Mapping Strength
Moderate
## Counter-arguments
This mapping is interpretive rather than structural. The propensity is not a
governing body making policy decisions; it is a behavioural disposition. However,
in Beer's framework, S5 can represent emergent identity rather than deliberate
governance — the system's ethos rather than its explicit command structure.
--- MAPPING: propensity-to-truck-barter-and-exchange-to-s2 ---
# Propensity to Truck, Barter, and Exchange -> System 2 (Coordination)
## Economic Entity Reference
Propensity to Truck, Barter, and Exchange — an innate human disposition to
negotiate and trade.
## VSM Concept Reference
System 2 (Coordination) — the information channels and bodies that allow
System 1 units to communicate and coordinate.
## Mapping Rationale
At the operational level, the propensity to exchange is the mechanism through
which coordination between specialised producers actually occurs. It is what
makes S2 possible in the economic system: without the disposition to trade,
there would be no market interactions, no price signalling, no mutual
adjustment of supply and demand. Smith's comparison with animals is telling —
dogs have different talents but cannot coordinate them because they lack this
propensity. The propensity is thus the prerequisite for all S2 coordination
in the economic VSM.
## Mapping Strength
Strong
--- MAPPING: self-interest-to-s1 ---
# Self-interest -> System 1 (Operations)
## Economic Entity Reference
Self-interest — the motivation of individuals to pursue their own advantage
in economic transactions.
## VSM Concept Reference
System 1 (Operations) — the primary activities that produce the organisation's
purpose, characterised by autonomy and self-organisation.
## Mapping Rationale
Self-interest is the animating principle of System 1 operational units. In
Beer's VSM, S1 elements are autonomous agents that self-organise within their
operational domain. Smith's self-interest is precisely this autonomy principle:
each economic actor (butcher, brewer, baker) pursues their own advantage, and
it is this autonomous self-directed activity that produces the system's output.
Self-interest ensures that S1 units are self-motivating and self-regulating
at the local level — they do not require external commands to operate. This
aligns with Beer's argument that S1 autonomy is essential for viability.
## Mapping Strength
Strong
--- MAPPING: self-interest-to-autonomy ---
# Self-interest -> Autonomy
## Economic Entity Reference
Self-interest — the motivation of individuals to pursue their own advantage.
## VSM Concept Reference
Autonomy — the degree of freedom granted to operational units to self-organise
within constraints set by System 3.
## Mapping Rationale
Smith's self-interest maps directly to Beer's concept of operational autonomy.
Beer argued that maximum autonomy consistent with systemic cohesion yields
maximum viability. Smith makes essentially the same argument: individuals
acting from self-interest, without central direction, produce better outcomes
("universal opulence") than any deliberate plan could achieve. The butcher
does not need to be told to provide meat — self-interest ensures it. This is
autonomy as a systemic design principle: the system works *because* its
operational units are self-directed, not *despite* it.
## Mapping Strength
Strong
--- MAPPING: the-bargain-to-s2 ---
# The Bargain -> System 2 (Coordination)
## Economic Entity Reference
The Bargain — a voluntary bilateral exchange in which each party offers
something the other wants.
## VSM Concept Reference
System 2 (Coordination) — the information channels and bodies that allow
System 1 units to communicate and coordinate.
## Mapping Rationale
The bargain is the atomic unit of S2 coordination in the economic system.
Each bargain is an information exchange (revealing preferences, willingness
to pay, relative valuations) and a resource exchange simultaneously. Beer's
S2 dampens oscillations and resolves conflicts between S1 units; the bargain
does precisely this — two parties with conflicting interests (each wants the
other's goods) reach an equilibrium through negotiation. The bargain is where
coordination actually happens, one transaction at a time, aggregating into
the market system's overall S2 function.
## Mapping Strength
Strong
--- MAPPING: benevolence-to-s2 ---
# Benevolence -> System 2 (Coordination)
## Economic Entity Reference
Benevolence — the disposition to do good to others out of goodwill rather
than self-interest.
## VSM Concept Reference
System 2 (Coordination) — the information channels and bodies that allow
System 1 units to communicate and coordinate.
## Mapping Rationale
Smith presents benevolence as an alternative but insufficient coordination
mechanism. In a small group, benevolence can coordinate activity (one can
secure "the friendship of a few persons"). But it cannot scale to coordinate
the "great multitudes" required in civilised society. In VSM terms, benevolence
is a low-variety S2 mechanism — it works for simple systems but lacks the
requisite variety to coordinate a complex economy. Smith's argument is
essentially that self-interested exchange is a higher-variety coordination
mechanism than benevolence, and therefore the one that actually sustains the
economic system at scale.
## Mapping Strength
Weak
## Counter-arguments
Benevolence is more accurately described as a *failed* or *insufficient*
coordination mechanism than an active one. Smith's point is precisely that
it does not work at scale. The mapping is useful primarily for what it reveals
about requisite variety in coordination.
--- MAPPING: surplus-produce-to-variety ---
# Surplus Produce -> Variety
## Economic Entity Reference
Surplus Produce — the portion of a worker's output exceeding their own
consumption, available for exchange.
## VSM Concept Reference
Variety — the number of possible states of a system; the measure of
complexity and differentiation.
## Mapping Rationale
Surplus produce represents the variety that specialised S1 units inject into
the economic system. Each specialised worker produces a large quantity of one
type of good (high volume, low variety per worker) but the aggregate of all
specialists' surpluses creates the system's total variety of available goods.
The exchange of surpluses is how this variety is distributed across the system.
Without surplus, there would be nothing to exchange, and without exchange,
each person would be limited to the variety they could produce alone. Surplus
is the material substrate of economic variety.
## Mapping Strength
Moderate
--- MAPPING: difference-of-talents-to-variety ---
# Difference of Talents -> Variety
## Economic Entity Reference
Difference of Talents — the observable variation in skills and aptitudes among
individuals, which Smith argues is largely the effect of the division of labour.
## VSM Concept Reference
Variety — the number of possible states of a system.
## Mapping Rationale
The difference of talents is the human variety that the economic system creates
and then exploits. Smith's argument that talents are effects rather than causes
of specialisation is significant: the economic system generates its own variety
through the division of labour, which then feeds back to enable further
specialisation. In Beer's terms, this is a variety-amplification loop — the
system's operational structure (division of labour) creates variety (diverse
talents) that enhances the system's capacity for further differentiation.
This is a self-reinforcing cybernetic process.
## Mapping Strength
Moderate
--- MAPPING: common-stock-to-viability ---
# Common Stock -> Viability
## Economic Entity Reference
Common Stock — the aggregate pool of goods and services created when
specialised producers bring their diverse products together through exchange.
## VSM Concept Reference
Viability — the capacity of a system to maintain a separate existence and
survive in a changing environment.
## Mapping Rationale
The common stock represents the viable system's capacity to sustain all its
members. Smith's argument that humans, unlike animals, can pool their different
talents through exchange shows how viability emerges from coordination: no
individual is self-sufficient, but the system as a whole is viable because
exchange creates a shared pool of resources accessible to all. The mastiff
cannot benefit from the greyhound's speed, but the philosopher can benefit
from the porter's strength (and vice versa) through exchange. This pooling
is what makes the human economic system viable while individual animals remain
individually viable but collectively uncoordinated.
## Mapping Strength
Moderate

View File

@@ -0,0 +1,517 @@
# Map Economic Entities to VSM Concepts
You are a systems theorist specializing in Stafford Beer's Viable System Model.
Your task is to map extracted economic entities to VSM concepts.
## Extracted Entities
--- ENTITY: propensity-to-truck-barter-and-exchange ---
# Propensity to Truck, Barter, and Exchange
## Definition
An innate or fundamental disposition in human nature to negotiate, trade, and
exchange goods with others. Smith identifies this propensity as the ultimate
cause of the division of labour, arguing that it is unique to humans and
absent in all other animal species. He leaves open whether it is a primary
instinct or a consequence of the faculties of reason and speech, but treats
it as the foundational mechanism from which specialisation and economic
organisation emerge.
## Source Chapter
Book I, Chapter 2: "Of the Principle which gives Occasion to the Division
of Labour"
## Context
This is the central thesis of the chapter. Smith argues that the division of
labour "is not originally the effect of any human wisdom" but rather the
"necessary, though very slow and gradual, consequence" of this propensity.
The entire chapter serves to establish exchange as the causal origin of
specialisation.
## Economic Domain
General Theory
## Smith's Original Wording
"This division of labour, from which so many advantages are derived, is not
originally the effect of any human wisdom, which foresees and intends that
general opulence to which it gives occasion. It is the necessary, though very
slow and gradual, consequence of a certain propensity in human nature [...] the
propensity to truck, barter, and exchange one thing for another."
## Modern Interpretation
This concept prefigures the modern economic assumption of rational self-interest
as the basis of market behaviour. It also anticipates evolutionary and
institutional economics debates about whether exchange is a natural disposition
or a culturally constructed institution.
--- ENTITY: self-interest ---
# Self-interest
## Definition
The motivation of individuals to pursue their own advantage in economic
transactions. Smith argues that in civilised society, individuals obtain the
co-operation of others not through appeals to benevolence but by engaging
their self-love — showing them that it is to their own advantage to provide
what is desired. Self-interest is the engine that makes exchange function:
each party to a bargain acts from regard to their own benefit.
## Source Chapter
Book I, Chapter 2: "Of the Principle which gives Occasion to the Division
of Labour"
## Context
Smith introduces self-interest through the celebrated passage about the
butcher, brewer, and baker. He contrasts it with benevolence, arguing that
we cannot rely on the goodwill of others for our daily needs in a society
of many, and that self-interest provides a more reliable and universal basis
for economic co-operation.
## Economic Domain
General Theory
## Smith's Original Wording
"It is not from the benevolence of the butcher, the brewer, or the baker that
we expect our dinner, but from their regard to their own interest. We address
ourselves, not to their humanity, but to their self-love, and never talk to
them of our own necessities, but of their advantages."
--- ENTITY: the-bargain ---
# The Bargain
## Definition
A voluntary bilateral exchange in which each party offers something the other
wants. Smith defines the bargain as the fundamental unit of economic
interaction: "Give me that which I want, and you shall have this which you
want." It is through bargaining that individuals obtain "the far greater part
of those good offices which we stand in need of" in civilised society, as
opposed to relying on benevolence or coercion.
## Source Chapter
Book I, Chapter 2: "Of the Principle which gives Occasion to the Division
of Labour"
## Context
The bargain is presented as the practical expression of the propensity to
exchange. Smith argues that it is the dominant mode of economic interaction,
used even by beggars who exchange charity-received goods for things they
actually need.
## Economic Domain
Exchange
## Smith's Original Wording
"Whoever offers to another a bargain of any kind, proposes to do this. Give
me that which I want, and you shall have this which you want, is the meaning
of every such offer."
--- ENTITY: benevolence ---
# Benevolence
## Definition
The disposition to do good to others out of goodwill rather than self-interest.
Smith argues that benevolence is an insufficient basis for economic organisation
in a complex society. While a person may secure the friendship of a few through
appeals to benevolence, they cannot rely on it to obtain the co-operation of
the "great multitudes" they need in civilised life. Even beggars, who depend
chiefly on benevolence for their subsistence, conduct most of their actual
transactions through exchange.
## Source Chapter
Book I, Chapter 2: "Of the Principle which gives Occasion to the Division
of Labour"
## Context
Benevolence serves as the foil to self-interest. Smith systematically argues
that while benevolence exists, it cannot scale to support the complex
interdependencies of a specialised economy, making self-interested exchange
the necessary coordinating mechanism.
## Economic Domain
General Theory
--- ENTITY: surplus-produce ---
# Surplus Produce
## Definition
The portion of a worker's output that exceeds their own consumption needs and
is therefore available for exchange. Smith argues that the certainty of being
able to exchange surplus produce for the products of other workers' labour
is what encourages every person to dedicate themselves to a particular
occupation. Surplus is thus both the material prerequisite and the incentive
for specialisation.
## Source Chapter
Book I, Chapter 2: "Of the Principle which gives Occasion to the Division
of Labour"
## Context
Introduced in the passage describing the emergence of specialised trades in
a tribal society. The armourer, carpenter, smith, and tanner each produce
more of their specialty than they can personally consume, and exchange the
surplus for other goods, reinforcing their commitment to specialisation.
## Economic Domain
Production
## Smith's Original Wording
"And thus the certainty of being able to exchange all that surplus part of
the produce of his own labour, which is over and above his own consumption,
for such parts of the produce of other men's labour as he may have occasion
for, encourages every man to apply himself to a particular occupation."
--- ENTITY: difference-of-talents ---
# Difference of Talents
## Definition
The observable variation in skills, aptitudes, and abilities among individuals
in different occupations. Smith makes the striking argument that this
difference is largely the effect rather than the cause of the division of
labour: people are born with roughly equal abilities, and it is their
different occupations, shaped by habit, custom, and education, that create
the apparent differences. He contrasts humans with dogs, where natural breed
differences are far greater but cannot be made useful because animals lack
the capacity for exchange.
## Source Chapter
Book I, Chapter 2: "Of the Principle which gives Occasion to the Division
of Labour"
## Context
This argument occupies the final portion of the chapter. Smith uses it to
reinforce his claim that exchange, not innate difference, is the driver of
specialisation. The philosopher and the street porter were "very much alike"
until different employments shaped them differently.
## Economic Domain
General Theory
## Smith's Original Wording
"The difference of natural talents in different men, is, in reality, much
less than we are aware of; and the very different genius which appears to
distinguish men of different professions, when grown up to maturity, is not
upon many occasions so much the cause, as the effect of the division of
labour."
--- ENTITY: common-stock ---
# Common Stock
## Definition
The aggregate pool of goods and services created when individuals bring
their diverse specialised products together through exchange. Smith argues
that among humans, unlike animals, different talents are made useful to
one another because their products can be "brought, as it were, into a
common stock, where every man may purchase whatever part of the produce
of other men's talents he has occasion for." This common stock is the
emergent result of widespread exchange among specialised producers.
## Source Chapter
Book I, Chapter 2: "Of the Principle which gives Occasion to the Division
of Labour"
## Context
Appears in the chapter's concluding argument comparing humans and animals.
While a mastiff cannot benefit from a greyhound's speed due to lack of
exchange, humans can pool their different abilities through trade, making
all talents contribute to the general welfare.
## Economic Domain
Exchange
## VSM Framework Reference
---
id: vsm-framework
name: vsm_framework
artifact_type: content
description: Stafford Beer's Viable System Model reference for economic analysis
version: 1.0.0
---
# Stafford Beer's Viable System Model (VSM)
The Viable System Model (VSM) is a model of the organisational structure of any
autonomous system capable of producing itself. It was created by management
cybernetician Stafford Beer in his books *Brain of the Firm* (1972) and
*The Heart of Enterprise* (1979).
## Core Principle: Viability
A viable system is any system organised in such a way as to meet the demands
of surviving in a changing environment. One of the prime features of systems
that survive is that they are adaptable. The VSM expresses a model for a
viable system, which is an abstracted cybernetic description applicable to
any organisation that is a going concern.
## The Five Systems
### System 1 (S1) — Operations
The primary activities that produce the organisation's purpose. These are the
operational units that directly create value. Each operational element is itself
a viable system (the principle of recursion).
**In economic terms:** Productive enterprises, factories, farms, workshops,
individual labourers performing specialised tasks, merchant operations.
**Key properties:** Autonomy within constraints, self-organisation,
direct engagement with the environment.
### System 2 (S2) — Coordination
The information channels and bodies that allow the primary activities in
System 1 to communicate with each other and that allow System 3 to monitor
and coordinate activities. System 2 dampens oscillations and resolves
conflicts between operational units.
**In economic terms:** Market price mechanisms, trade customs, standard
weights and measures, commercial law, banking clearinghouses, trade guilds.
**Key properties:** Anti-oscillatory, dampening, scheduling, conflict
resolution, standardisation.
### System 3 (S3) — Control / Operational Management
The structures and controls that establish the rules, resources, rights,
and responsibilities of System 1 and provide an interface between Systems 1
and Systems 4/5. System 3 represents the day-to-day control of the
organisation. It optimises the internal environment.
**In economic terms:** Government regulation of trade, taxation policy, labour
laws, enforcement of contracts, the "invisible hand" as emergent internal
regulation, guilds and corporations governing members.
**Key properties:** Internal regulation, resource allocation, accountability,
synergy extraction, performance management.
### System 3* (S3*) — Audit / Monitoring
The audit and monitoring channel that allows System 3 to verify information
coming from System 1 through channels other than those provided by System 2.
System 3* provides sporadic, direct access to operational reality.
**In economic terms:** Market inspections, quality checks, auditing of accounts,
surprise investigations into trade practices, verification of weights and measures.
**Key properties:** Sporadic direct investigation, reality checking, bypassing
normal reporting channels.
### System 4 (S4) — Intelligence / Adaptation
The bodies and processes that look outward to the environment to monitor
how the organisation needs to adapt to remain viable. System 4 captures
all relevant information about the outside-and-then environment. It is
responsible for strategic responses.
**In economic terms:** Foreign intelligence about trade opportunities,
market research, new technology adoption, colonial exploration and trade
route development, understanding of foreign economic systems.
**Key properties:** Environmental scanning, future orientation, strategic
planning, modelling, research and development.
### System 5 (S5) — Policy / Identity
The policy-making body that balances demands from Systems 3 and 4 and defines
the identity, values, and purpose of the organisation. System 5 provides
closure to the whole system and represents its supreme authority.
**In economic terms:** Sovereign authority, constitutional principles governing
economic policy, national economic identity, the philosophical foundations
of economic systems (mercantilism vs. free trade), the overarching purpose
of the commonwealth.
**Key properties:** Identity, ethos, supreme command, policy closure,
balancing internal and external perspectives.
## Key Concepts
### Recursion
Every viable system contains and is contained in a viable system. The same
five-system structure recurs at every level of organisation. A workshop is
a viable system within a factory, which is a viable system within an
industry, which is a viable system within a national economy.
### Variety
A measure of the number of possible states of a system. The Law of Requisite
Variety (Ashby's Law) states that only variety can absorb variety. A
controller must have at least as much variety as the system it controls.
### Requisite Variety
The principle that for effective regulation, the variety of the regulator
must match the variety of the system being regulated. This is achieved
through variety attenuation (reducing the variety coming up from operations)
and variety amplification (increasing the variety of management's responses).
### Attenuation and Amplification
Variety engineering mechanisms. Attenuation reduces variety (e.g., reporting
summaries, statistical aggregation, standardisation). Amplification increases
variety (e.g., delegation, empowerment, decentralisation).
### Algedonic Signals
Emergency signals that bypass the normal management hierarchy to alert
higher systems of critical situations requiring immediate attention. Named
from the Greek words for pain (algos) and pleasure (hedone).
**In economic terms:** Market panics, famine signals, sudden price collapses,
trade embargoes, economic crises that demand immediate sovereign intervention.
### Autonomy
The degree of freedom granted to operational units (System 1) to self-organise
within constraints set by System 3. Beer argued that maximum autonomy
consistent with systemic cohesion yields maximum viability.
### Viability
The capacity of a system to maintain a separate existence and survive in a
changing environment. A viable system continuously adapts while maintaining
its identity.
## Mapping Guidelines
---
id: mapping-rules
name: mapping_rules
artifact_type: content
description: Guidelines for mapping economic entities to VSM concepts
version: 1.0.0
---
# VSM Mapping Rules
## Mapping Principles
1. **Ground in Beer's definitions.** Every mapping rationale must reference
the specific VSM system function, not just a superficial resemblance.
2. **Prefer structural over metaphorical mappings.** A mapping is strong
when the economic entity performs the same *functional role* in Smith's
economic system as the VSM component performs in an organisation.
3. **Allow multiple mappings.** A single economic entity may map to
multiple VSM systems. For example, "the sovereign" may map to both
S3 (regulation) and S5 (policy). Create separate mapping documents
for each relationship.
4. **Respect recursion.** Consider at which level of recursion the mapping
applies. The division of labour within a single workshop (S1-level)
differs from the division of labour across an entire national economy
(higher recursion level).
## Mapping Strength Criteria
### Strong
- The entity directly performs the function of the VSM system.
- The mapping would be recognisable to a VSM practitioner without explanation.
- Example: "market price mechanism" → S2 (Coordination) — prices coordinate
supply and demand between producers.
### Moderate
- The entity partially performs the function or performs it in a limited context.
- The mapping requires some argument but is defensible.
- Example: "merchant" → S4 (Intelligence) — merchants gather information
about foreign markets, but this is not their primary function.
### Weak
- The mapping is speculative or metaphorical rather than structural.
- The connection exists but requires significant interpretive work.
- Example: "moral sentiments" → S5 (Policy) — broad ethical framework
shapes economic behaviour, but the connection is indirect.
## What NOT to Map
- Do not force mappings where none exist. It is valid for an entity to have
no clear VSM mapping — flag it with "Mapping Strength: Weak" and explain
the difficulty.
- Do not map purely descriptive/historical content that lacks functional
significance.
## VSM System Checklist
When mapping, consider each system:
| System | Question to Ask |
|--------|----------------|
| S1 | Does this entity directly produce value or output? |
| S2 | Does this entity coordinate between operational units? |
| S3 | Does this entity regulate internal operations? |
| S3* | Does this entity provide audit or verification? |
| S4 | Does this entity scan the environment or plan for the future? |
| S5 | Does this entity define identity, policy, or purpose? |
Also consider the key concepts:
- **Recursion**: At what level does this entity operate?
- **Variety**: Does this entity manage variety (attenuate or amplify)?
- **Algedonic signals**: Does this entity serve as an emergency signal?
- **Autonomy**: Does this entity relate to operational autonomy?
## Instructions
1. Review each extracted economic entity carefully.
2. For each entity, determine which VSM system(s) it most closely relates to.
3. Produce a mapping document for each entity-VSM relationship following
the VSM Mapping Schema v1.0.
4. Each mapping document must include:
- An H1 heading in the format "Entity Name -> VSM Concept Name"
- An Economic Entity Reference section
- A VSM Concept Reference section
- A Mapping Rationale section (minimum 30 words) grounded in Beer's definitions
- A Mapping Strength section rated as Strong, Moderate, or Weak
5. Where an entity maps to multiple VSM systems (recursion), create
separate mapping documents for each relationship.
6. Flag entities that don't clearly map to any VSM concept with a
"Mapping Strength: Weak" and note the difficulty in the rationale.
## Output Format
Output each mapping as a separate markdown document, delimited by
`--- MAPPING: <entity-name>-to-<vsm-concept> ---` markers.