tegwick
fa27572f43
INFRA-TASKS #5 — process_chapters.py now skips writing *-prompt.md files when the corresponding output file already exists on disk. DB-only rebuilds no longer dirty the working tree with unchanged prompt content. INFRA-TASKS #8 — Added '## Quality Metrics' section to the entity and VSM mapping schemas, defining the five evaluation dimensions (Definition Precision, Source Grounding, Domain Placement, VSM Relevance, Explanatory Value) with 1–5 rubrics used by the evaluate-entity template. Also updated INFRA-TASKS.md to reflect current resolution status for tasks 4–19 across S2 and S3. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
87 lines
3.6 KiB
Markdown
87 lines
3.6 KiB
Markdown
# 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").
|