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,132 @@
# Chapter Analysis: Book I, Chapter 1 — Of the Division of Labour
## Chapter Summary
Smith opens *The Wealth of Nations* by identifying the division of labour as
the primary cause of improvement in the productive powers of labour. Using the
celebrated pin-factory example, he demonstrates that ten workers collaborating
under a division of labour can produce 48,000 pins per day, compared to fewer
than 20 each if working independently — a productivity gain of over 240-fold.
He attributes this gain to three mechanisms: increased dexterity through
specialisation, time saved by eliminating task-switching, and the invention
of labour-saving machinery stimulated by focused attention on single operations.
Smith extends the argument from the workshop to society at large, showing that
the separation of trades advances furthest in the most developed countries,
and that the resulting multiplication of production creates a "universal
opulence" reaching even the lowest social ranks. He illustrates this with the
day-labourer's woollen coat, whose production requires the co-operation of
thousands of workers across dozens of trades and multiple countries.
## Entities Extracted
| # | Entity | Type | Economic Domain | Description |
|---|--------|------|-----------------|-------------|
| 1 | Division of labour | Concept | Production | Separation of work into specialised tasks to increase productive power |
| 2 | Productive powers of labour | Concept | Production | Capacity of labour to produce output per worker per unit time |
| 3 | Dexterity of the workman | Concept | Production | Skill and speed acquired through repeated specialised operation |
| 4 | Saving of time | Concept | Production | Elimination of time lost in switching between tasks |
| 5 | Invention of machinery | Mechanism | Production | Development of labour-saving machines stimulated by specialisation |
| 6 | Separation of trades | Mechanism | Production | Emergence of distinct occupations as separate specialisations |
| 7 | The workman | Actor | Production | Individual labourer performing productive specialised work |
| 8 | The philosopher | Actor | General Theory | Observer-specialist who combines knowledge across fields |
| 9 | Universal opulence | Concept | Distribution | Material well-being extending to all social ranks |
| 10 | Exchange | Mechanism | Exchange | Trading surplus production for goods produced by others |
| 11 | Co-operation of labour | Mechanism | Production | Interdependent collaboration across trades and locations |
| 12 | Manufactures | Concept | Production | Sector of production transforming raw materials through specialised operations |
| 13 | Agriculture | Concept | Production | Sector of production with limited division of labour due to seasonal constraints |
**Total entities: 13**
## VSM Mappings
| Entity | VSM Concept | Strength | Key Rationale |
|--------|------------|----------|---------------|
| Division of labour | S1 (Operations) | Strong | Defines internal architecture of operational units |
| Division of labour | Recursion | Strong | Operates at multiple levels: workshop, trade, nation |
| Productive powers of labour | S1 (Operations) | Strong | Key performance indicator of S1 effectiveness |
| Dexterity of the workman | S1 (Operations) | Strong | Self-optimisation capacity of individual S1 elements |
| Saving of time | S2 (Coordination) | Moderate | Eliminates oscillation between work modes |
| Invention of machinery | S4 (Intelligence) | Strong | Adaptive innovation driven by focused observation |
| Separation of trades | S1 (Operations) | Strong | Differentiation of S1 into distinct operational units |
| The workman | S1 (Operations) | Strong | Fundamental S1 element at lowest recursion level |
| The philosopher | S4 (Intelligence) | Strong | Environmental scanning and cross-domain synthesis |
| Universal opulence | Viability | Moderate | Emergent outcome of a functioning viable system |
| Exchange | S2 (Coordination) | Strong | Primary coordination mechanism between S1 units |
| Co-operation of labour | S2 (Coordination) | Moderate | Observable result of effective S2 coordination |
| Manufactures | S1 (Operations) | Strong | Major S1 domain with high internal differentiation |
| Agriculture | S1 (Operations) | Strong | S1 domain constrained by environment in differentiation |
**Total mappings: 14** (some entities map to multiple VSM concepts)
## VSM Coverage
| System | Covered | Entities Mapped | Notes |
|--------|---------|-----------------|-------|
| S1 (Operations) | Yes | Division of labour, productive powers, dexterity, separation of trades, the workman, manufactures, agriculture | Dominant system — chapter focuses on operational structure |
| S2 (Coordination) | Yes | Saving of time, exchange, co-operation of labour | Present through coordination mechanisms |
| S3 (Control) | No | — | No entities map to internal regulation or resource allocation |
| S3* (Audit) | No | — | No entities map to monitoring or verification |
| S4 (Intelligence) | Yes | Invention of machinery, the philosopher | Innovation and environmental scanning |
| S5 (Policy) | No | — | No entities map to identity, policy, or purpose |
| Recursion | Yes | Division of labour | Multi-level operation explicitly noted |
| Variety | No | — | Not explicitly addressed in this chapter |
| Requisite Variety | No | — | Not explicitly addressed |
| Attenuation/Amplification | No | — | Not explicitly addressed |
| Algedonic Signals | No | — | Not explicitly addressed |
| Autonomy | No | — | Implicit but not directly discussed |
| Viability | Yes | Universal opulence | System-level outcome |
**Systems covered: S1, S2, S4 (3 of 5 primary systems)**
**Systems not covered: S3, S3*, S5**
**Key concepts covered: Recursion, Viability (2 of 7)**
## Gaps & Observations
### Uncovered Systems
- **S3 (Control)**: The chapter does not discuss regulation, resource allocation,
or governance of operational units. Smith's "invisible hand" and regulatory
structures appear in later chapters.
- **S3* (Audit)**: No monitoring or verification mechanisms are discussed.
- **S5 (Policy)**: The chapter does not address sovereign authority, economic
policy, or the purpose of the commonwealth. Smith's brief reference to
"a well-governed society" hints at S5 but does not develop it.
### Difficult Mappings
- **Saving of time** maps only moderately to S2 because it describes the
elimination of a coordination problem rather than a coordination mechanism
itself.
- **Universal opulence** maps to Viability rather than a specific system,
making it a systemic property rather than a structural element.
### Emerging Themes
1. **S1 dominance**: This chapter is overwhelmingly about operational structure.
As the opening chapter of the book, it establishes the productive foundation
before introducing regulatory and policy layers in subsequent chapters.
2. **Recursion as implicit structure**: Smith's analysis naturally operates at
multiple recursive levels (worker → workshop → trade → nation) even though
he does not use systems-theoretic language.
3. **Innovation feedback loop**: The connection between S1 (specialised workers)
and S4 (invention/philosophy) represents a key feedback loop in the viable
system: operational focus generates adaptive innovation.
### Suggestions for Enriching Coverage
- **S3 coverage** is likely to emerge in chapters on wages, profits, and market
regulation (Book I, Chapters 7-10).
- **S5 coverage** should appear in Book IV (political economy) and Book V
(sovereign revenue).
- **Variety and requisite variety** may emerge when Smith discusses market size
(Chapter 3) and the limitations of regulation.
- Later chapters on money (Chapter 4) and prices (Chapters 5-7) should
strengthen S2 coverage through the price mechanism.
### Cross-chapter Anticipations
Several entities from this chapter will likely recur and deepen in subsequent
chapters:
- **Division of labour** → Chapter 2 (its cause) and Chapter 3 (its limits)
- **Exchange** → Chapter 4 (money as medium of exchange)
- **Productive powers** → Chapters 5-7 (price theory as measure of output)

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,137 @@
# Chapter Analysis: Book I, Chapter 2 — Of the Principle which gives Occasion to the Division of Labour
## Chapter Summary
Smith identifies the cause of the division of labour: a fundamental human
propensity to "truck, barter, and exchange." This propensity is not the product
of deliberate design or wisdom but an innate (or at least deeply rooted)
feature of human nature, possibly derived from the faculties of reason and
speech. Smith argues that in civilised society, individuals cannot secure the
co-operation of the multitudes they need through benevolence alone; instead,
they must appeal to others' self-interest through bargaining. The celebrated
passage on the butcher, brewer, and baker establishes self-interest mediated
by exchange as the reliable foundation of economic co-operation. Smith then
traces how exchange gives rise to specialisation in primitive societies —
the armourer, carpenter, smith, and tanner emerge because each finds it
advantageous to dedicate themselves to what they do best and trade the surplus.
He concludes with the striking claim that the difference of talents between
a philosopher and a street porter is largely the effect rather than the cause
of the division of labour, and contrasts humans with animals whose diverse
natural talents cannot be pooled because they lack the capacity for exchange.
## Entities Extracted
| # | Entity | Type | Economic Domain | Description |
|---|--------|------|-----------------|-------------|
| 1 | Propensity to truck, barter, and exchange | Concept | General Theory | Fundamental human disposition to trade, the cause of the division of labour |
| 2 | Self-interest | Concept | General Theory | Motivation to pursue own advantage as the basis of economic co-operation |
| 3 | The bargain | Mechanism | Exchange | Voluntary bilateral exchange — the atomic unit of economic interaction |
| 4 | Benevolence | Concept | General Theory | Goodwill-based co-operation, insufficient for complex economies |
| 5 | Surplus produce | Concept | Production | Output exceeding own consumption, available for exchange |
| 6 | Difference of talents | Concept | General Theory | Skill variation as effect (not cause) of the division of labour |
| 7 | Common stock | Concept | Exchange | Aggregate pool of goods created by specialised exchange |
**Total entities: 7**
## VSM Mappings
| Entity | VSM Concept | Strength | Key Rationale |
|--------|------------|----------|---------------|
| Propensity to exchange | S5 (Policy/Identity) | Moderate | Foundational identity principle of the economic system |
| Propensity to exchange | S2 (Coordination) | Strong | Prerequisite for all market coordination |
| Self-interest | S1 (Operations) | Strong | Animating principle of autonomous operational units |
| Self-interest | Autonomy | Strong | Operational self-direction as design principle |
| The bargain | S2 (Coordination) | Strong | Atomic unit of inter-S1 coordination |
| Benevolence | S2 (Coordination) | Weak | Insufficient low-variety coordination mechanism |
| Surplus produce | Variety | Moderate | Material substrate of economic variety |
| Difference of talents | Variety | Moderate | System-generated variety through specialisation |
| Common stock | Viability | Moderate | Emergent system capacity to sustain all members |
**Total mappings: 9** (some entities map to multiple VSM concepts)
## VSM Coverage
| System | Covered | Entities Mapped | Notes |
|--------|---------|-----------------|-------|
| S1 (Operations) | Yes | Self-interest | As autonomy principle of operational units |
| S2 (Coordination) | Yes | Propensity to exchange, the bargain, benevolence | Central theme — exchange as coordination |
| S3 (Control) | No | — | No regulatory or management entities |
| S3* (Audit) | No | — | No monitoring entities |
| S4 (Intelligence) | No | — | No environmental scanning entities |
| S5 (Policy) | Yes | Propensity to exchange | As system identity (moderate mapping) |
| Recursion | No | — | Not addressed in this chapter |
| Variety | Yes | Surplus produce, difference of talents | System-generated variety |
| Requisite Variety | Partial | Benevolence (implicitly) | Benevolence lacks requisite variety for complex economies |
| Attenuation/Amplification | No | — | Not directly addressed |
| Algedonic Signals | No | — | Not addressed |
| Autonomy | Yes | Self-interest | Core argument of the chapter |
| Viability | Yes | Common stock | Pooled resources sustain the system |
**Systems covered: S1, S2, S5 (3 of 5 primary systems)**
**Systems not covered: S3, S3*, S4**
**Key concepts covered: Variety, Autonomy, Viability (3 of 7), Requisite Variety (partial)**
## Gaps & Observations
### Uncovered Systems
- **S3 (Control)**: No discussion of regulation, resource allocation, or
internal management. Expected — this chapter is about the *origin* of
economic organisation, not its governance.
- **S3* (Audit)**: No monitoring or verification mechanisms discussed.
- **S4 (Intelligence)**: Unlike Chapter 1 (which discussed the philosopher
and invention), this chapter does not address adaptation or environmental
scanning.
### Difficult Mappings
- **Propensity to exchange → S5** is interpretive. It captures identity/ethos
rather than deliberate governance, stretching the usual structural reading
of S5.
- **Benevolence → S2** is a *negative* mapping — Smith's point is that
benevolence fails as a coordination mechanism. Useful for what it reveals
about requisite variety but not a functional S2 element.
### Emerging Themes
1. **S2 deepens significantly**: Chapter 1 introduced exchange as one
mechanism among several; Chapter 2 establishes it as the foundational
principle of all economic coordination. S2 is now the best-covered
system across the two chapters.
2. **Autonomy emerges as key concept**: Smith's self-interest argument
maps powerfully to Beer's autonomy principle. This was implicit in
Chapter 1 but becomes explicit here — the system works because its
agents are self-directed.
3. **Variety appears for the first time**: Surplus produce and the
difference of talents introduce variety as a property of the economic
system. Smith's argument about talents being effects of specialisation
describes a variety-amplification feedback loop.
4. **S5 begins to emerge**: The propensity to exchange as a defining
characteristic of human economic nature provides the first (tentative)
S5 mapping.
### Cross-chapter Connections
- **Exchange** (Chapter 1 entity) is now grounded in a deeper causal
explanation: it arises from the propensity to truck, barter, and exchange.
- **The workman** (Chapter 1) is now understood as an autonomous agent
driven by self-interest, not merely an operative unit.
- **Universal opulence** (Chapter 1) is explained by the common stock
mechanism: diverse talents pooled through exchange.
### Cumulative VSM Coverage (Chapters 1-2)
| System | Ch.1 | Ch.2 | Combined |
|--------|------|------|----------|
| S1 | Strong | Yes | Strong |
| S2 | Yes | Strong | Strong |
| S3 | No | No | No |
| S3* | No | No | No |
| S4 | Yes | No | Yes |
| S5 | No | Moderate | Moderate |
| Variety | No | Yes | Yes |
| Autonomy | No | Yes | Yes |
| Viability | Yes | Yes | Yes |

View File

@@ -0,0 +1,868 @@
# Synthesize Chapter VSM Analysis
You are an interdisciplinary analyst combining classical economics with
cybernetic systems theory. Your task is to produce a comprehensive
chapter-level analysis showing how economic content maps to the
Viable System Model.
## Source Chapter
---
id: book-1-chapter-02
title: "OF THE PRINCIPLE WHICH GIVES OCCASION TO THE DIVISION OF LABOUR."
book: "1"
chapter: 2
artifact_type: content
---
CHAPTER II.
OF THE PRINCIPLE WHICH GIVES OCCASION
TO THE DIVISION OF LABOUR.
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, which has in view no such extensive utility; the propensity to
truck, barter, and exchange one thing for another.
Whether this propensity be one of those original principles in human
nature, of which no further account can be given, or whether, as seems
more probable, it be the necessary consequence of the faculties of reason
and speech, it belongs not to our present subject to inquire. It is common
to all men, and to be found in no other race of animals, which seem to
know neither this nor any other species of contracts. Two greyhounds, in
running down the same hare, have sometimes the appearance of acting in
some sort of concert. Each turns her towards his companion, or endeavours
to intercept her when his companion turns her towards himself. This,
however, is not the effect of any contract, but of the accidental
concurrence of their passions in the same object at that particular time.
Nobody ever saw a dog make a fair and deliberate exchange of one bone for
another with another dog. Nobody ever saw one animal, by its gestures and
natural cries signify to another, this is mine, that yours; I am willing
to give this for that. When an animal wants to obtain something either of
a man, or of another animal, it has no other means of persuasion, but to
gain the favour of those whose service it requires. A puppy fawns upon its
dam, and a spaniel endeavours, by a thousand attractions, to engage the
attention of its master who is at dinner, when it wants to be fed by him.
Man sometimes uses the same arts with his brethren, and when he has no
other means of engaging them to act according to his inclinations,
endeavours by every servile and fawning attention to obtain their good
will. He has not time, however, to do this upon every occasion. In
civilized society he stands at all times in need of the co-operation and
assistance of great multitudes, while his whole life is scarce sufficient
to gain the friendship of a few persons. In almost every other race of
animals, each individual, when it is grown up to maturity, is entirely
independent, and in its natural state has occasion for the assistance of
no other living creature. But man has almost constant occasion for the
help of his brethren, and it is in vain for him to expect it from their
benevolence only. He will be more likely to prevail if he can interest
their self-love in his favour, and shew them that it is for their own
advantage to do for him what he requires of them. 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; and it is in this manner that we obtain from one another the far
greater part of those good offices which we stand in need of. 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. Nobody but a
beggar chooses to depend chiefly upon the benevolence of his
fellow-citizens. Even a beggar does not depend upon it entirely. The
charity of well-disposed people, indeed, supplies him with the whole fund
of his subsistence. But though this principle ultimately provides him with
all the necessaries of life which he has occasion for, it neither does nor
can provide him with them as he has occasion for them. The greater part of
his occasional wants are supplied in the same manner as those of other
people, by treaty, by barter, and by purchase. With the money which one
man gives him he purchases food. The old clothes which another bestows
upon him he exchanges for other clothes which suit him better, or for
lodging, or for food, or for money, with which he can buy either food,
clothes, or lodging, as he has occasion.
As it is by treaty, by barter, and by purchase, that we obtain from one
another the greater part of those mutual good offices which we stand in
need of, so it is this same trucking disposition which originally gives
occasion to the division of labour. In a tribe of hunters or shepherds, a
particular person makes bows and arrows, for example, with more readiness
and dexterity than any other. He frequently exchanges them for cattle or
for venison, with his companions; and he finds at last that he can, in
this manner, get more cattle and venison, than if he himself went to the
field to catch them. From a regard to his own interest, therefore, the
making of bows and arrows grows to be his chief business, and he becomes a
sort of armourer. Another excels in making the frames and covers of their
little huts or moveable houses. He is accustomed to be of use in this way
to his neighbours, who reward him in the same manner with cattle and with
venison, till at last he finds it his interest to dedicate himself
entirely to this employment, and to become a sort of house-carpenter. In
the same manner a third becomes a smith or a brazier; a fourth, a tanner
or dresser of hides or skins, the principal part of the clothing of
savages. 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 mens labour as he may
have occasion for, encourages every man to apply himself to a particular
occupation, and to cultivate and bring to perfection whatever talent or
genius he may possess for that particular species of business.
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. The difference between the most dissimilar characters, between
a philosopher and a common street porter, for example, seems to arise not
so much from nature, as from habit, custom, and education. When they came
in to the world, and for the first six or eight years of their existence,
they were, perhaps, very much alike, and neither their parents nor
play-fellows could perceive any remarkable difference. About that age, or
soon after, they come to be employed in very different occupations. The
difference of talents comes then to be taken notice of, and widens by
degrees, till at last the vanity of the philosopher is willing to
acknowledge scarce any resemblance. But without the disposition to truck,
barter, and exchange, every man must have procured to himself every
necessary and conveniency of life which he wanted. All must have had the
same duties to perform, and the same work to do, and there could have been
no such difference of employment as could alone give occasion to any great
difference of talents.
As it is this disposition which forms that difference of talents, so
remarkable among men of different professions, so it is this same
disposition which renders that difference useful. Many tribes of animals,
acknowledged to be all of the same species, derive from nature a much more
remarkable distinction of genius, than what, antecedent to custom and
education, appears to take place among men. By nature a philosopher is not
in genius and disposition half so different from a street porter, as a
mastiff is from a grey-hound, or a grey-hound from a spaniel, or this last
from a shepherds dog. Those different tribes of animals, however, though
all of the same species are of scarce any use to one another. The strength
of the mastiff is not in the least supported either by the swiftness of
the greyhound, or by the sagacity of the spaniel, or by the docility of
the shepherds dog. The effects of those different geniuses and talents,
for want of the power or disposition to barter and exchange, cannot be
brought into a common stock, and do not in the least contribute to the
better accommodation and conveniency of the species. Each animal is still
obliged to support and defend itself, separately and independently, and
derives no sort of advantage from that variety of talents with which
nature has distinguished its fellows. Among men, on the contrary, the most
dissimilar geniuses are of use to one another; the different produces of
their respective talents, by the general disposition to truck, barter, and
exchange, being brought, as it were, into a common stock, where every man
may purchase whatever part of the produce of other mens talents he has
occasion for.
## 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 Mappings
--- 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
## 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.
## Instructions
1. Review the source chapter, extracted entities, and VSM mappings together.
2. Produce a single chapter analysis document following the
Chapter Analysis Schema v1.0.
3. The analysis must include:
- An H1 heading with the chapter analysis title
- A Chapter Summary (50-300 words) of the main economic arguments
- An Entities Extracted section listing all entities with brief descriptions
- A VSM Mappings section listing all mappings with entity, concept, and strength
- A VSM Coverage section assessing which systems (S1-S5, S3*) are represented
- A Gaps & Observations section identifying uncovered systems and patterns
4. In the VSM Coverage section, explicitly state which systems are
covered and which are not, based on the mappings.
5. In Gaps & Observations, note:
- Which VSM systems lack representation from this chapter
- Entities that were difficult to map
- Emerging themes or patterns
- Suggestions for enriching coverage in future analysis
## Output Format
Output a single markdown document following the Chapter Analysis Schema v1.0.