Files
markitect-main/examples/infospace-with-history/output/analyses/book-1-chapter-02-analysis.md
tegwick fecc2fd4fa 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>
2026-02-11 01:17:58 +01:00

138 lines
7.3 KiB
Markdown

# 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 |