rhachet-roles-ehmpathy 1.0.0 → 1.2.0

package/dist/logic/roles/ecologist/.briefs/ecology/eco505.systems-thinking.md

@@ -0,0 +1,62 @@
+## `.brief.eco505.systems-thinking`
+
+### 🧠 topic: systems thinking in ecology
+
+---
+
+### 🎯 goal
+train ecologists to see ecosystems as **interconnected, flow-based systems** — governed by **resource pools**, **biological flows**, and **cyclical feedbacks** that shape system behavior over time.
+
+---
+
+### 🔁 what is systems thinking?
+
+- a framework for understanding **how parts interact** in complex, living systems
+- focuses on **relationships, flows, and cycles** instead of isolated events
+- asks:
+  - what’s accumulating or depleting? (**pools**)
+  - what’s moving? (**flows**)
+  - what reinforces or stabilizes patterns? (**cycles**)
+
+---
+
+### 🧱 key elements
+
+#### **pools**
+- quantities that can build up or run down
+  e.g., biomass, soil carbon, water stored in a wetland, total population size
+
+#### **flows**
+- processes that transfer material or energy between pools
+  e.g., birth, death, migration, photosynthesis, runoff
+
+#### **cycles (feedback loops)**
+- **reinforcing cycles** (positive): amplify change
+  - e.g., more vegetation → more shade → more moisture → more vegetation
+- **balancing cycles** (negative): dampen change
+  - e.g., more prey → more predators → fewer prey → fewer predators
+
+ecosystems often contain **nested and competing cycles** that drive both resilience and transformation
+
+---
+
+### 🧠 how to think like a systems ecologist
+
+- follow the **flow paths**, not just the endpoints
+- look for **delays, thresholds, and accumulations**
+- identify **leverage points** where small changes affect the whole system
+- embrace **nonlinear outcomes** and emergent patterns
+
+---
+
+### 🧰 applied tools
+- **causal diagrams** – map pools, flows, and cycles visually
+- **dynamic models** – simulate changes over time
+- **resilience mapping** – understand how systems recover or collapse under pressure
+
+---
+
+### 🔁 mental model
+> systems thinking helps ecologists ask:
+> “**what’s flowing where, what’s building up, and what cycles are at play?**”
+> it’s a shift from describing parts to **understanding living systems as patterns of interaction and change**.

package/dist/logic/roles/ecologist/.briefs/economy/econ001.overview.md

@@ -0,0 +1,65 @@
+# economist.briefs.grouped
+
+## 🧠 Tier 1: core mechanics
+### cluster: scarcity, trade, and behavior
+- **supply and demand**
+  how prices and quantities adjust in a market
+- **opportunity cost & trade-offs**
+  what choosing one option costs in terms of the next-best
+- **marginal analysis**
+  decisions happen at the margin: marginal cost vs marginal benefit
+- **rational choice theory**
+  how agents optimize given preferences and constraints
+
+## 🏛️ Tier 2: market structures and failures
+### cluster: how systems work (or break)
+- **market equilibrium & dynamics**
+  how prices and quantities stabilize or shift over time
+- **elasticity**
+  how responsive buyers/sellers are to changes in price
+- **externalities**
+  costs or benefits imposed on third parties (pollution, public goods)
+- **market failure & government intervention**
+  when and how policy steps in to correct inefficiencies
+
+## 💸 Tier 3: production and growth
+### cluster: inputs → outputs → scale
+- **factors of production**
+  land, labor, capital, entrepreneurship
+- **firm behavior & cost structures**
+  how businesses minimize cost and maximize profit
+- **comparative advantage & trade**
+  who should produce what, and why trade benefits all
+- **economic growth & productivity**
+  drivers of long-term improvement in output per person
+
+## 🧾 Tier 4: macro systems
+### cluster: aggregate flows and cycles
+- **GDP & national income accounting**
+  how total economic output is measured
+- **unemployment & inflation**
+  tradeoffs, measurement, and impacts
+- **business cycles**
+  expansions and contractions in aggregate demand/supply
+- **monetary & fiscal policy**
+  how central banks and governments stabilize the economy
+
+## 🌍 Tier 5: global and institutional context
+### cluster: rules, incentives, and outcomes
+- **game theory & strategic interaction**
+  how agents act when outcomes depend on others
+- **institutions & property rights**
+  rules that shape incentives and transaction costs
+- **development economics**
+  why some nations grow and others stagnate
+- **behavioral economics**
+  bounded rationality, heuristics, and irrational tendencies
+
+## 📊 Tier 6: tools & analysis
+### cluster: measurement & modeling
+- **data, statistics, and econometrics**
+  how economists test hypotheses with real-world data
+- **models and assumptions**
+  simplifications to understand complex systems
+- **welfare analysis**
+  who gains, who loses, and how much

package/dist/logic/roles/ecologist/.briefs/economy/econ101.core-mechanics.md

@@ -0,0 +1,65 @@
+## `.brief.econ101.core-mechanics`
+
+### 🧠 Tier 1: core mechanics
+**cluster**: scarcity, trade, and behavior
+
+---
+
+### 🎯 goal
+build foundational intuition for **how people, firms, and systems make choices** in a world of limited resources — and how those choices shape prices, trade, and outcomes.
+
+---
+
+## ⚖️ supply and demand
+**how prices and quantities adjust in a market**
+
+- **demand**: how much buyers want at each price
+  – downward-sloping: lower price → more buyers
+- **supply**: how much sellers provide at each price
+  – upward-sloping: higher price → more incentive to produce
+- **equilibrium**: where supply = demand
+  – determines the **market price** and **quantity exchanged**
+- shocks (e.g., drought, innovation, policy) shift curves and change outcomes
+
+---
+
+## 💸 opportunity cost & trade-offs
+**what choosing one option costs in terms of the next-best**
+
+- resources are limited, so every choice **comes at a cost**
+- **opportunity cost** = value of the next-best alternative foregone
+  e.g., the cost of going to college = tuition + lost income from working
+- clear thinking requires comparing **what you get** vs. **what you give up**
+
+---
+
+## ➕ marginal analysis
+**decisions happen at the margin**
+
+- people respond to **incremental changes**, not total values
+- compare:
+  - **marginal benefit (MB)** = extra gain from one more unit
+  - **marginal cost (MC)** = extra cost from one more unit
+- rule: **do more** if MB > MC, **stop** when MB = MC
+  e.g., hire an extra worker if they generate more revenue than they cost
+
+---
+
+## 🧠 rational choice theory
+**how agents optimize given preferences and constraints**
+
+- agents (people, firms) assumed to:
+  - have **consistent preferences**
+  - weigh **costs vs. benefits**
+  - choose options that **maximize utility (happiness) or profit**
+- subject to constraints:
+  - **budget** (money, time)
+  - **information** (perfect or limited)
+  - **rules** (laws, norms, prices)
+
+📈 used as a baseline model for predicting behavior — deviations from it reveal behavioral patterns, biases, or external forces
+
+---
+
+### 🔁 mental model
+> economics begins with a simple truth: **we can’t have everything**, so we must **choose**. those choices ripple outward — shaping **markets, trade, and behavior** through prices, costs, and marginal gains.

package/dist/logic/roles/ecologist/.briefs/economy/econ101.p1.supply-and-demand.md

@@ -0,0 +1,76 @@
+## `.brief.econ101.supply-and-demand`
+
+### 🧠 topic: supply and demand
+**how prices and quantities adjust in a market**
+
+---
+
+### 🎯 goal
+understand how **markets coordinate trade** by adjusting prices and quantities through the interaction of buyers and sellers.
+
+---
+
+### 📉 demand
+**how much consumers want to buy at each price**
+
+- governed by the **law of demand**:
+  → as price **falls**, quantity demanded **rises**
+- why?
+  - substitution effect: cheaper goods are more attractive
+  - income effect: lower prices stretch purchasing power
+- visual: **downward-sloping curve**
+
+---
+
+### 📈 supply
+**how much producers are willing to sell at each price**
+
+- governed by the **law of supply**:
+  → as price **rises**, quantity supplied **rises**
+- why?
+  - higher prices cover costs and increase profit incentive
+- visual: **upward-sloping curve**
+
+---
+
+### ⚖️ market equilibrium
+**where supply meets demand**
+
+- occurs at the price where quantity demanded = quantity supplied
+- determines the **market-clearing price** and traded quantity
+- market naturally moves toward this point unless restricted
+
+#### ⛓ if price is too high:
+- surplus (excess supply) → downward pressure on price
+
+#### ⛓ if price is too low:
+- shortage (excess demand) → upward pressure on price
+
+---
+
+### 🌪 shifts vs. movement
+
+#### **movement along curves**
+- caused by a **change in price**
+
+#### **shifts of curves**
+- caused by external factors:
+
+**demand shifters**:
+- income, tastes, number of buyers, expectations, price of related goods
+
+**supply shifters**:
+- input costs, technology, number of sellers, expectations, regulations
+
+---
+
+### 🌍 real-world shocks
+
+- **drought** → supply shift left (less produced) → higher price
+- **innovation** → supply shift right (more efficient production) → lower price
+- **policy** (e.g., tax, subsidy) → alters supply or demand depending on target
+
+---
+
+### 🔁 mental model
+> prices are the **signals** and quantities are the **responses** — together they form a **self-adjusting system** that matches what people want with what producers provide.

package/dist/logic/roles/ecologist/.briefs/economy/econ101.p2.opportunity-cost.md

@@ -0,0 +1,106 @@
+## `.brief.econ101.opportunity-cost`
+
+### 💸 topic: opportunity cost & trade-offs
+**what choosing one option costs in terms of the next-best**
+
+---
+
+### 🎯 goal
+build intuition for how **every choice has a cost**, even when no money changes hands — and how good decision-making depends on recognizing what’s **given up**.
+
+---
+
+### 🌍 scarcity forces choices
+
+- we live in a world of **limited time, money, energy, and resources**
+- choosing one path means **not choosing others**
+- this trade-off is the foundation of economics
+
+---
+
+### 🧠 opportunity cost defined
+
+- **opportunity cost** = the value of the **next-best alternative foregone**
+- not just money — includes time, effort, enjoyment, and risk
+
+#### examples:
+- going to college → lose 4 years of income
+- taking a job → give up leisure or other offers
+- buying a truck → give up the chance to invest that money
+
+💡 the true cost of any action is **everything you gave up to do it**
+
+---
+
+### ⚖️ trade-off thinking
+
+- helps compare options **on equal footing**
+- sharpens decisions by shifting the frame from:
+  → “can I afford this?” to
+  → “is this **worth more** than what I’d give up?”
+
+---
+
+### 🚫 common traps
+
+- ignoring **non-obvious costs** (e.g., time, flexibility)
+- falling for **sunk cost fallacy**: continuing just because you’ve already invested
+- thinking in **absolutes**, not **alternatives**
+
+---
+
+### 🔁 mental model
+> every “yes” is a “no” to something else — smart choices require **clear comparisons**, not just **gut reactions** or dollar signs.
+
+
+---
+
+### 🧠 strategic use cases of opportunity cost
+**real-life examples for everyday decision-making**
+
+#### 🕒 1. saying yes to overtime
+- working extra hours brings more money
+- **but costs**: time with family, rest, hobbies, long-term health
+
+💡 ask: “am I trading money for something I’ll regret missing?”
+
+#### 🍽 2. eating out vs. cooking at home
+- dining out saves time and adds enjoyment
+- **but costs**: money, nutrition, and maybe missed cooking skills
+
+💡 usecase: weekly planning, budgeting, health decisions
+
+#### 🚗 3. buying a new car
+- new car = convenience + reliability
+- **but costs**: thousands in financing that could go toward a vacation, savings, or debt payoff
+
+💡 ask: “is this comfort worth the next-best use of that money?”
+
+#### 🎓 4. going back to school
+- education can boost long-term income
+- **but costs**: time, tuition, lost work income, delayed experience
+
+💡 usecase: career pivots, side hustle vs. grad school decisions
+
+#### 📺 5. watching TV vs. doing something else
+- shows offer relaxation and entertainment
+- **but costs**: opportunity to read, exercise, sleep, or create
+
+💡 ask: “am I recharging or just escaping?”
+
+#### 🛍 6. impulse purchases
+- buying a trendy gadget feels good now
+- **but costs**: that money can’t go toward travel, gifts, or emergencies later
+
+💡 usecase: practicing mindful spending
+
+#### 🧠 7. staying in a job you don’t like
+- stable income and routine
+- **but costs**: growth, purpose, new experiences, higher-paying roles elsewhere
+
+💡 ask: “what is this comfort costing me over the next 5 years?”
+
+### 🔁 mental model
+> opportunity cost shows up in **everyday trade-offs** — not just big purchases, but in **how you spend time, energy, and attention**.
+> better choices come from asking:
+> “what else could I be doing with this?”

package/dist/logic/roles/ecologist/.briefs/economy/econ101.p3.marginal-analysis.md

@@ -0,0 +1,79 @@
+## `.brief.econ101.marginal-analysis`
+
+### ➕ topic: marginal analysis
+**decisions happen at the margin**
+
+---
+
+### 🎯 goal
+shift from all-or-nothing thinking to **incremental decision-making** — evaluating whether doing a little more (or less) creates more value than it costs.
+
+---
+
+### 📐 key concept: the margin
+
+- **"the margin"** = the next unit
+  → next hour, next dollar, next slice, next mile
+
+- most real-world decisions aren’t yes/no — they’re **“how much?”**
+  → work 1 more hour? eat 1 more bite? add 1 more staff member?
+
+---
+
+### 🔍 marginal comparison
+
+#### **marginal benefit (MB)**
+- the **extra gain** from doing one more
+  e.g., extra sales from 1 more ad, extra joy from 1 more cookie
+
+#### **marginal cost (MC)**
+- the **extra cost** of doing one more
+  e.g., time, money, fatigue, risk
+
+---
+
+### ✅ decision rule
+- **if MB > MC** → keep going
+- **if MB < MC** → stop
+- **if MB = MC** → optimal stopping point
+
+💡 don’t judge based on total cost vs. total benefit — judge by **what the next step adds or subtracts**
+
+---
+
+### 📊 everyday examples
+
+#### 🍕 eating another slice
+- MB = more taste & fullness
+- MC = discomfort, calories
+→ **stop when enjoyment no longer outweighs regret**
+
+#### 👩‍💼 hiring more help
+- MB = extra output or sales
+- MC = wages, overhead
+→ **hire until the last person pays for themselves**
+
+#### 🧠 studying for a test
+- MB = better score, confidence
+- MC = fatigue, missed sleep
+→ **study until new info doesn’t stick or help**
+
+#### 📺 watching another episode
+- MB = relaxation, suspense payoff
+- MC = lost sleep, time, next-day grogginess
+→ **quit when the thrill isn't worth tomorrow's drag**
+
+---
+
+### 🚫 common traps
+
+- looking only at **totals** instead of **next-step gains/losses**
+- assuming “more = better” even when **returns diminish**
+- failing to stop when benefits flatten out
+
+---
+
+### 🔁 mental model
+> marginal analysis means always asking:
+> **“is this next step worth it?”**
+> when you think on the margin, you avoid waste, burnout, and regret — and make sharper, more efficient decisions.

package/dist/logic/roles/ecologist/.briefs/economy/econ101.p4.rational-choice.md

@@ -0,0 +1,81 @@
+## `.brief.econ101.rational-choice`
+
+### 🧠 topic: rational choice theory
+**how agents optimize given preferences and constraints**
+
+---
+
+### 🎯 goal
+understand the basic model of human behavior in economics: how people and firms **make choices to maximize value**, given their goals and limitations.
+
+---
+
+### 🧠 what is rational choice theory?
+
+- a foundational idea in economics:
+  **people act with purpose** — choosing what best serves their goals within their limits
+- not about being “smart” — it’s about being **intentional and consistent**
+
+---
+
+### ⚙️ assumptions of rational agents
+
+- **consistent preferences**
+  → if A is preferred to B, and B to C, then A is preferred to C
+
+- **cost-benefit reasoning**
+  → agents compare **what they gain** vs. **what they give up**
+
+- **utility maximization**
+  → individuals aim to get the **most satisfaction (utility)**
+  → firms aim to get the **most profit**
+
+---
+
+### ⛓ constraints on choice
+
+- **budget** – can’t spend more than you have (money, time, energy)
+- **information** – sometimes complete, often limited or biased
+- **rules** – prices, laws, social norms, contracts
+
+💡 rational choices happen **within a framework of trade-offs and limits**
+
+---
+
+### 📈 why it matters
+
+- rational choice is the **default model** in economics
+  → used to predict: demand, savings, labor effort, voting, consumption
+
+- **when behavior deviates** from this model (e.g., emotion, habit, bias),
+  → we get insights from **behavioral economics**
+
+---
+
+### 🧍‍♀️ everyday examples
+
+#### 💵 grocery shopping on a budget
+- pick the basket of goods that gives the most nutrition and enjoyment per dollar
+- constraint = your wallet
+
+#### 📅 scheduling your weekend
+- pick activities that maximize fun, rest, or productivity
+- constraint = 48 hours and competing priorities
+
+#### 🧑‍💻 choosing between job offers
+- compare benefits, pay, commute, culture
+- choose what aligns best with goals, within real-world limits
+
+---
+
+### 🚫 common misunderstandings
+
+- rational ≠ selfish
+- rational ≠ correct
+- rational ≠ emotionless
+→ it just means: **based on consistent goals + trade-off logic**
+
+---
+
+### 🔁 mental model
+> rational choice theory sees people as **goal-seeking decision-makers** — weighing costs, benefits, and constraints to make the **best available choice**, even if it’s not perfect.

package/dist/logic/roles/ecologist/.briefs/economy/econ201.market-structures-and-failures.md

@@ -0,0 +1,81 @@
+## `.brief.econ201.market-structures-and-failures`
+
+### 🏛️ Tier 2: market structures and failures
+**cluster**: how systems work (or break)
+
+---
+
+### 🎯 goal
+understand how real-world markets **stabilize, shift, or fail**, and when **government intervention** may improve outcomes.
+
+---
+
+## ⚖️ market equilibrium & dynamics
+**how prices and quantities stabilize or shift over time**
+
+- equilibrium is **not static** — it responds to changing conditions
+- **dynamic equilibrium**: markets adjust continually to new info, shocks, and feedback
+- shifts can come from:
+  - demand changes (e.g., new trends, income swings)
+  - supply shocks (e.g., war, resource depletion)
+- **over time**, price and quantity move to reflect new realities
+- some markets adjust quickly (e.g., stocks), others slowly (e.g., housing)
+
+---
+
+## 📈 elasticity
+**how responsive buyers and sellers are to changes in price**
+
+- **price elasticity of demand (Ed)**:
+  % change in quantity demanded ÷ % change in price
+  - elastic (>1): buyers react strongly (e.g., luxury goods)
+  - inelastic (<1): buyers react weakly (e.g., insulin)
+
+- **price elasticity of supply (Es)**:
+  how much sellers change output in response to price
+
+- also relevant:
+  - income elasticity (how demand changes with income)
+  - cross-price elasticity (how demand changes when related goods’ prices change)
+
+💡 elasticity affects:
+- **who bears the burden** of taxes
+- **revenue effects** of price changes
+- **speed and scale** of market adjustment
+
+---
+
+## 🌫 externalities
+**costs or benefits imposed on third parties**
+
+- **negative externalities**:
+  - impose costs without compensation (e.g., pollution, traffic, noise)
+  - result in **overproduction** relative to the social optimum
+
+- **positive externalities**:
+  - create unearned benefits (e.g., vaccines, education, pollinator habitats)
+  - result in **underproduction** unless subsidized
+
+📊 without intervention, markets **ignore external effects**, leading to inefficient outcomes
+
+---
+
+## 🏛 market failure & government intervention
+**when and how policy steps in**
+
+- **market failure**: when self-regulating markets don’t allocate resources efficiently
+  - causes: externalities, public goods, asymmetric info, monopolies
+
+- **types of interventions**:
+  - **taxes** on negative externalities (e.g., carbon tax)
+  - **subsidies** for positive externalities (e.g., education grants)
+  - **regulation** (e.g., emissions caps, product standards)
+  - **public provision** (e.g., roads, fire protection)
+  - **antitrust enforcement** to prevent monopolies
+
+⚠️ interventions can help or hurt — success depends on **incentive design**, **information**, and **enforcement**
+
+---
+
+### 🔁 mental model
+> markets are powerful but **imperfect tools** — they often reach stable outcomes, but those outcomes may not be **fair, efficient, or sustainable** without thoughtful correction.

package/dist/logic/roles/ecologist/.briefs/economy/econ301.production-and-growth.md

@@ -0,0 +1,71 @@
+## `.brief.econ301.production-and-growth`
+
+### 💸 Tier 3: production and growth
+**cluster**: inputs → outputs → scale
+
+---
+
+### 🎯 goal
+understand how economies **turn inputs into outputs**, how firms and nations make efficient choices, and what drives **long-term growth in living standards**.
+
+---
+
+## 🏗 factors of production
+**the basic ingredients of economic output**
+
+- **land** – natural resources (soil, water, minerals, forests)
+- **labor** – human effort and skills
+- **capital** – tools, machines, infrastructure (not money itself)
+- **entrepreneurship** – risk-taking, innovation, and coordination
+
+💡 production requires **combining these inputs** efficiently to create goods and services
+
+---
+
+## 🧠 firm behavior & cost structures
+**how businesses minimize cost and maximize profit**
+
+- firms choose **how much to produce**, **what inputs to use**, and **how to organize production**
+- guided by:
+  - **marginal cost**: cost of producing one more unit
+  - **marginal revenue**: revenue from selling one more unit
+  - **profit max rule**: produce until MR = MC
+
+- **cost structures** matter:
+  - **fixed costs** (don’t change with output)
+  - **variable costs** (scale with output)
+  - **economies of scale**: average cost falls as output rises (up to a point)
+
+---
+
+## 🌍 comparative advantage & trade
+**who should produce what, and why trade benefits all**
+
+- **absolute advantage**: can produce more with same inputs
+- **comparative advantage**: lower **opportunity cost** of producing something
+
+💡 even if one party is “better” at everything, both sides **gain from trade** by specializing in what they’re relatively best at
+
+#### example:
+- country A makes wheat efficiently
+- country B makes steel efficiently
+→ trade wheat for steel = both get more than going solo
+
+---
+
+## 📈 economic growth & productivity
+**what drives long-term output per person**
+
+- **growth** = increase in real GDP per capita
+- driven by:
+  - **investment in capital** (machines, infrastructure)
+  - **human capital** (education, health)
+  - **innovation & tech** (doing more with less)
+  - **institutions** (laws, markets, property rights)
+
+💡 growth compounds over time — small gains now = huge gains later
+
+---
+
+### 🔁 mental model
+> economies grow when they **use inputs wisely**, **specialize where efficient**, and **innovate over time** — turning today’s effort into tomorrow’s abundance.