rhachet-roles-ehmpathy 1.0.0 → 1.1.0

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.

package/dist/logic/roles/ecologist/.briefs/economy/econ401.macro-systems.md

@@ -0,0 +1,92 @@
+## `.brief.econ401.macro-systems`
+
+### 🧾 Tier 4: macro systems
+**cluster**: aggregate flows and cycles
+
+---
+
+### 🎯 goal
+zoom out from individual decisions to see how **entire economies function** — how we measure them, what causes booms and busts, and how governments try to smooth the ride.
+
+---
+
+## 💰 GDP & national income accounting
+**how total economic output is measured**
+
+- **GDP (Gross Domestic Product)** = total market value of all final goods and services produced in a country over a period
+- measured via:
+  - **production approach** (total output)
+  - **income approach** (wages + profits + rents + taxes)
+  - **expenditure approach**:
+    `GDP = C + I + G + NX`
+    where:
+    - `C` = consumption
+    - `I` = investment
+    - `G` = government spending
+    - `NX` = net exports (exports – imports)
+
+💡 GDP tracks economic size and growth, but **not well-being**, equity, or sustainability
+
+---
+
+## 📉 unemployment & inflation
+**tradeoffs, measurement, and impacts**
+
+- **unemployment rate** = % of labor force without a job but actively seeking
+  - types: frictional (short-term), structural (skills mismatch), cyclical (recession)
+
+- **inflation** = general rise in prices over time
+  - measured by CPI or PCE index
+  - reduces purchasing power
+
+- often a **tradeoff**:
+  ↓ unemployment ↔️ ↑ inflation (in short run)
+  → managed via policy levers
+
+---
+
+## 🔄 business cycles
+**expansions and contractions in economic activity**
+
+- economies naturally go through cycles:
+  - **expansion** – growth, job creation, rising incomes
+  - **peak** – growth slows
+  - **recession** – decline in output & jobs
+  - **recovery** – activity rebounds
+
+- caused by:
+  - demand shocks (e.g., housing crash)
+  - supply shocks (e.g., oil spike, pandemic)
+  - credit and investment cycles
+
+💡 policy tries to **flatten the extremes** without choking growth
+
+---
+
+## 🏛 monetary & fiscal policy
+**how governments and central banks manage the economy**
+
+### monetary policy (central bank)
+- controls **money supply and interest rates**
+- tools:
+  - set base interest rates
+  - open market operations (buy/sell bonds)
+  - reserve requirements
+
+→ goal: stabilize inflation and support full employment
+
+### fiscal policy (government)
+- changes in **spending and taxation**
+- tools:
+  - stimulus packages
+  - tax cuts/increases
+  - public investment
+
+→ goal: boost demand in recessions or cool off overheating
+
+💡 timing, scale, and coordination matter — poor policy = more volatility
+
+---
+
+### 🔁 mental model
+> macroeconomics treats the economy like a **living system** — pulsing with flows of spending, working, investing, and adjusting — with policy as the **steering and brakes** to keep things on track.

package/dist/logic/roles/ecologist/.briefs/economy/econ501.global-and-institutional.md

@@ -0,0 +1,85 @@
+## `.brief.econ501.global-and-institutional`
+
+### 🌍 Tier 5: global and institutional context
+**cluster**: rules, incentives, and outcomes
+
+---
+
+### 🎯 goal
+explore how **rules, expectations, and context shape economic behavior** — from global development to everyday decision-making.
+
+---
+
+## 🎲 game theory & strategic interaction
+**how agents act when outcomes depend on others**
+
+- decisions aren’t made in a vacuum — other people's choices affect your payoff
+- key concepts:
+  - **payoff matrix** – tracks outcomes for all players
+  - **dominant strategy** – best move regardless of what others do
+  - **Nash equilibrium** – no one has an incentive to deviate given others' choices
+
+- famous games:
+  - **prisoner’s dilemma** – mutual cooperation is better, but self-interest leads to worse outcome
+  - **coordination games** – success depends on aligning actions (e.g., driving side of the road, tech standards)
+
+💡 game theory explains pricing wars, political negotiation, market entry, and more
+
+---
+
+## 🏛 institutions & property rights
+**rules that shape incentives and transaction costs**
+
+- **institutions** = formal and informal “rules of the game”
+  → laws, norms, contracts, enforcement mechanisms
+
+- **property rights** define who owns what and under what terms
+  → clarity and enforcement reduce conflict and unlock investment
+
+💡 strong institutions reduce friction, encourage trust, and attract capital
+💡 weak or corrupt institutions raise risk and discourage long-term growth
+
+---
+
+## 🌱 development economics
+**why some nations grow and others stagnate**
+
+- looks at persistent gaps in wealth, health, and opportunity
+- key barriers:
+  - lack of infrastructure
+  - weak institutions
+  - poor education or health systems
+  - dependency on resource exports
+  - corruption and conflict
+
+- solutions involve:
+  - **aid** (targeted, conditional, or direct)
+  - **microfinance** and entrepreneurship
+  - **policy reform** and capacity building
+  - **community-driven development**
+
+💡 development is multi-dimensional — not just about income, but human well-being
+
+---
+
+## 🧠 behavioral economics
+**bounded rationality, heuristics, and irrational tendencies**
+
+- challenges the rational choice model
+- key findings:
+  - **loss aversion** – losses hurt more than gains feel good
+  - **present bias** – short-term rewards outweigh long-term gains
+  - **anchoring** – decisions are swayed by irrelevant reference points
+  - **default effects** – people stick with pre-set options
+
+- used in:
+  - **nudges** (opt-out savings plans, organ donation defaults)
+  - **policy design** that aligns with real human behavior
+
+💡 behavior is shaped by emotion, framing, fatigue, and habit — not just logic
+
+---
+
+### 🔁 mental model
+> economic outcomes are never just about prices or math — they’re shaped by **rules, relationships, psychology, and power**.
+> to understand real economies, you must also understand **the systems people move within**.

package/dist/logic/roles/ecologist/.briefs/economy/econ501.p1.game-theory.md

@@ -0,0 +1,142 @@
+## `.brief.econ501.game-theory`
+
+### 🎲 topic: game theory & strategic interaction
+**how agents act when outcomes depend on others**
+
+---
+
+### 🎯 goal
+develop intuition for **strategic decision-making** — where success depends not just on what you choose, but on what **others choose too**.
+
+---
+
+### 🔁 what makes a game?
+
+- multiple **players**
+- each has **choices (strategies)**
+- each outcome gives a **payoff** to every player
+- players are **interdependent** — your result depends on their actions
+
+💡 game theory helps explain **competition, cooperation, and conflict** — in markets, politics, and daily life
+
+---
+
+### 📊 key concepts
+
+#### **payoff matrix**
+- a table showing all outcomes based on players’ choices
+- each cell = combination of actions + resulting payoffs
+
+#### **dominant strategy**
+- a move that gives better results **no matter what others do**
+- not all games have one — but when it exists, it simplifies decisions
+
+#### **Nash equilibrium**
+- a stable outcome where **no player has an incentive to change**
+- everyone is doing the best they can **given what others are doing**
+
+---
+
+### 🎮 famous games
+
+#### **prisoner’s dilemma**
+- two individuals can cooperate or betray
+- mutual cooperation = better for both
+- but self-interest leads each to defect
+→ result: both worse off than if they had trusted
+
+💡 reveals tension between **individual incentives and collective good**
+
+---
+
+#### **coordination games**
+- success depends on **matching** the other player
+  - e.g., choosing same technology, meeting place, driving side
+
+- often multiple Nash equilibria — problem is **getting aligned**
+
+💡 shows that **expectations** and **culture** matter
+
+---
+
+### 🧠 real-world use cases
+
+- **pricing wars** – undercutting vs. holding firm
+- **negotiation** – when to concede or hold
+- **market entry** – launch now or wait for a competitor
+- **voting systems** – strategic voting, coalition formation
+- **arms races** – invest or disarm?
+
+---
+
+### 🔁 mental model
+> in strategic settings, outcomes depend on **what everyone does** — not just you.
+> game theory helps map out those choices, clarify incentives, and reveal when **cooperation beats competition** — or when it doesn’t.
+
+---
+
+
+## 🎯 strategic use cases of game theory
+**non-obvious but powerful real-world applications**
+
+
+### 💵 1. **pricing in competitive markets**
+- two firms competing: lower prices to gain share, but risk a price war
+→ understanding the **prisoner’s dilemma** helps explain why firms may **agree tacitly** to hold prices steady
+
+💡 usecase: airline pricing, gas stations, e-commerce discounting
+
+
+### 🗳 2. **political positioning and platform design**
+- candidates don’t just state beliefs — they **position relative to rivals**
+→ game theory explains **why moderates converge** toward center in two-party races (median voter theorem)
+
+💡 use in political strategy, debate prep, polling analysis
+
+
+### 📦 3. **product launch timing**
+- should you enter the market first and risk failure, or wait and risk being late?
+→ game theory helps model **first-mover advantage vs. fast-follower strategy**
+
+💡 usecase: tech products, pharma trials, media releases
+
+
+### ⚖️ 4. **cartel stability and cheating**
+- firms collude to raise prices — but each has an incentive to secretly undercut
+→ payoff matrix predicts that **collusion is fragile without enforcement**
+
+💡 use in antitrust, industry analysis, global oil markets (e.g., OPEC)
+
+
+### 🧪 5. **clinical trial design**
+- multiple companies racing to develop the same drug
+→ do you go fast and cut corners or wait for better data?
+→ decisions depend on **others’ actions and expected payoffs**
+
+💡 use in biopharma R&D strategy
+
+
+### 🤝 6. **negotiation & brinkmanship**
+- each side wants more but risks collapse if they push too far
+→ understanding **credible threats**, **bluffs**, and **mutual interest zones** is key
+
+💡 usecase: labor talks, trade deals, hostage negotiations
+
+
+### 🚧 7. **public goods & coordination failure**
+- everyone benefits from a clean park or safe internet
+→ but if **each waits for others to act**, nothing happens
+→ coordination games explain **why policy or first movers matter**
+
+💡 use in climate action, cybersecurity, city planning
+
+
+### 🧠 8. **crowd behavior and tipping points**
+- when will people panic, protest, or adopt a trend?
+→ threshold models (a type of game) show how one person’s choice can trigger **cascades**
+
+💡 use in marketing virality, movement building, crisis response
+
+
+### 🔁 mental model
+> game theory reveals the **hidden strategy layers** behind everyday decisions — where what you do depends not just on **what you want**, but on **what others do, expect, and believe**.

package/dist/logic/roles/ecologist/.briefs/economy/econ501.p4.behavioral-economics.md

@@ -0,0 +1,146 @@
+## `.brief.econ501.behavioral-economics`
+
+### 🧠 topic: behavioral economics
+**bounded rationality, heuristics, and irrational tendencies**
+
+---
+
+### 🎯 goal
+understand how **real people actually behave** — not as perfect calculators, but as emotional, shortcut-using humans prone to bias, habit, and context effects.
+
+---
+
+### 🧠 beyond rational choice
+
+- traditional economics assumes people are **rational optimizers**
+- behavioral economics says: not always
+  → we have **limited attention**, **imperfect willpower**, and **emotional reactions**
+
+💡 we often choose what feels right, not what **is** right on paper
+
+---
+
+### 🧪 key behavioral patterns
+
+#### **loss aversion**
+- losses feel **twice as painful** as equivalent gains feel good
+→ people avoid risks even when upside is worth it
+
+#### **present bias**
+- we **overvalue immediate rewards**, undervalue the future
+→ procrastination, overspending, under-saving
+
+#### **anchoring**
+- decisions are skewed by irrelevant starting points
+→ e.g., seeing a $200 shirt makes a $100 one seem cheap
+
+#### **default effects**
+- people tend to stick with **pre-set options**
+→ auto-enrollment boosts savings, organ donation rates
+
+---
+
+### 🎯 applied behavioral tools
+
+#### **nudges**
+- small design tweaks that guide better choices without removing freedom
+  - auto opt-in (savings, benefits)
+  - smart defaults (green energy plans)
+  - reminders and framing (vaccine text messages)
+
+#### **choice architecture**
+- how options are presented affects decisions
+→ fewer choices = less overload
+→ framing gains vs. losses shifts behavior
+
+---
+
+### 📍 real-world examples
+
+- retirement plans with default contributions → more savings
+- calorie counts on menus → healthier eating
+- donation ask framed as “$1/day” vs. “$30/month” → higher conversions
+- limited-time offers → trigger urgency and FOMO
+
+---
+
+### 🚫 common traps we fall into
+
+- trusting gut feelings over data
+- sticking with bad choices due to sunk costs
+- avoiding change, even when beneficial
+- misjudging probabilities (lotteries, insurance)
+
+---
+
+### 🔁 mental model
+> behavioral economics reminds us: **we're not robots** — we're biased, emotional, and shaped by context.
+> better outcomes come from designing systems that work **with**, not against, real human nature.
+
+
+---
+
+## 🧠 strategic use cases of behavioral economics
+**non-obvious but powerful applications in the real world**
+
+---
+
+### 💰 1. boosting retirement savings with default design
+- setting **default contribution rates** (e.g., 6%) drastically increases participation
+- most people don’t opt out or adjust
+→ behavior driven by **inertia**, not intent
+
+💡 use in HR, pension design, financial planning
+
+
+### 🧾 2. framing to increase tax compliance
+- messages like “**9 out of 10 people in your area already paid**”
+→ taps into **social norms** and guilt
+→ outperforms penalty reminders
+
+💡 used by governments to improve voluntary compliance
+
+
+### 💡 3. energy use reduction via peer comparison
+- showing homeowners how their energy use compares to neighbors
+→ triggers **competitive instincts and social pressure**
+→ more effective than financial incentives alone
+
+💡 usecase: utilities, smart home dashboards, climate campaigns
+
+
+### 🍽 4. changing food choices with placement, not rules
+- placing healthy items at eye level or first in line
+→ increases uptake **without removing choice**
+→ works better than education or labels alone
+
+💡 cafeteria design, grocery stores, school lunch programs
+
+
+### 📈 5. increasing conversion through chunking & anchoring
+- breaking a price into **daily or weekly terms**
+  → “just $1/day” feels easier than “$30/month”
+- placing an expensive decoy next to mid-tier item
+  → makes the middle choice feel like a deal
+
+💡 use in subscription pricing, fundraising, SaaS plans
+
+
+### 💬 6. structuring decisions to reduce regret and dropout
+- offering a “pause my subscription” button instead of “cancel”
+→ leverages **status quo bias**
+→ preserves revenue and gives users a soft exit
+
+💡 usecase: churn reduction in memberships, apps, and media
+
+
+### 🎓 7. motivating learning and training through **progress framing**
+- “you’ve completed 3 of 5 lessons” > “2 left”
+→ taps into **goal gradient effect**: motivation increases as the end approaches
+
+💡 used in edtech, onboarding flows, productivity apps
+
+
+### 🔁 mental model
+> smart systems don’t fight human bias — they **account for it**.
+> by applying behavioral economics, we can **unlock better outcomes** in finance, health, sustainability, education, and beyond — not by force, but by **thoughtful design**.