# Economic Entity Schema v1.0

Schema definition for economic entities extracted from source texts.

## Required Sections

### Definition
A clear, analytical definition of the economic entity (20-150 words).

### Source Chapter
The specific chapter from which this entity was extracted,
including book and chapter number.

### Context
The broader context in which this entity appears within the source text.
Describe the argument or passage where the entity is discussed.

### Economic Domain
The area of economics this entity belongs to. Use **exactly one** value
from this list:

- **Production** — labour, manufacturing, technology, productivity
- **Distribution** — wages, profit, rent, income shares
- **Exchange** — markets, prices, trade, money, barter
- **Consumption** — demand, utility, wants, expenditure
- **Accumulation** — capital, savings, stock, investment
- **Regulation** — policy, law, institutions, monopoly, government
- **General Theory** — foundational principles spanning multiple domains

Do not combine multiple values. Do not use any other domain name.

## Optional Sections

### Smith's Original Wording
A direct quotation from Adam Smith's text that defines or describes
this entity. Must be enclosed in quotation marks with chapter reference.

### Modern Interpretation
How this entity is understood in modern economic theory, including
any evolution in meaning since Smith's time.

## Quality Metrics

Used by the `evaluate-entity` prompt template to score each entity on five
dimensions. Each dimension is scored 1–5, where 1 = very poor and 5 = excellent.

### Definition Precision (1-5)
Is the definition specific, non-circular, and clearly distinguishable from
neighbouring concepts? A score of 5 means the definition uniquely identifies
the concept without relying on terms that are themselves undefined within the
infospace. A score of 1 means the definition is vague, tautological, or
indistinguishable from another entity.

### Source Grounding (1-5)
Is the entity grounded in a specific, verifiable passage from the source text?
A score of 5 means a citation is present, the cited chapter exists, and the
definition accurately reflects the cited passage. A score of 1 means no
citation is given or the definition contradicts the source.

### Domain Placement (1-5)
Is the economic domain assignment correct and specific? A score of 5 means
the assigned domain (e.g., Production, Distribution) is the most precise
fit and would not be improved by a different choice. A score of 1 means the
domain is wrong, or "General Theory" is used when a more specific domain
applies.

### VSM Relevance (1-5)
Does this entity connect meaningfully to at least one VSM system (S1–S5,
recursion, variety, algedonic signals)? A score of 5 means the entity is
directly mappable to a VSM concept with a clear structural rationale. A
score of 1 means the entity has no discernible VSM connection and may be
too granular or peripheral to the system model.

### Explanatory Value (1-5)
Does this entity contribute to explaining the economic system as a whole, or
is it a restatement of another concept? A score of 5 means removing this
entity would leave a meaningful gap in the infospace. A score of 1 means
another entity already covers this ground, or the entity adds no
explanatory power.

## Validation Rules

1. The document MUST contain an H1 heading with the entity name.
2. The document MUST contain all four required sections: Definition, Source Chapter, Context, Economic Domain.
3. The Definition section MUST be between 20 and 150 words.
4. The Source Chapter section MUST cite a specific chapter (e.g., "Book I, Chapter 1").
