rhachet-roles-ehmpathy 1.0.0 → 1.1.0

package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p2.trophic-dynamics.md

@@ -0,0 +1,59 @@
+## `.brief.eco101.trophic-dynamics`
+
+### 🧠 topic: trophic dynamics
+
+---
+
+### 🎯 goal
+understand how energy moves through ecosystems by examining who eats whom, how much energy transfers, and what happens when the balance shifts.
+
+---
+
+### 🧭 trophic levels
+
+- **autotrophs (producers)** – organisms that create energy-rich compounds from sunlight or chemicals (e.g., plants, algae)
+- **herbivores (primary consumers)** – eat autotrophs (e.g., deer, insects)
+- **carnivores (secondary+ consumers)** – eat other consumers (e.g., wolves, hawks)
+- **decomposers** – break down dead organisms and recycle nutrients (e.g., fungi, bacteria)
+
+🔄 energy flows **up**, nutrients **cycle**
+
+---
+
+### ⚡ energy transfer efficiency
+
+- only ~**10%** of energy is passed to the next trophic level
+- ~**90%** is lost as heat, movement, metabolism, or undigested material
+- explains why:
+  - food chains rarely extend beyond 4–5 levels
+  - top predators are few in number and require large territories
+
+---
+
+### 🔗 food chains vs. food webs
+
+#### **food chain**
+- a **linear** sequence of who eats whom
+  example: grass → grasshopper → frog → snake → hawk
+
+#### **food web**
+- a **network** of interconnected food chains
+- reflects real-world complexity
+- shows redundancy, indirect effects, and resilience potential
+
+---
+
+### 🔄 top-down vs. bottom-up control
+
+#### **top-down (predator-driven)**
+- predators suppress herbivores, allowing plant populations to grow
+  example: adding wolves to Yellowstone → fewer deer → more willow trees
+
+#### **bottom-up (resource-driven)**
+- changes in resource availability (e.g., nutrients, water) affect producers, which cascade upward
+  example: nutrient-poor soil → fewer plants → fewer herbivores → fewer predators
+
+---
+
+### 🔁 mental model
+> trophic dynamics describe the **flow of energy and influence** in an ecosystem — like a supply chain where **efficiency is low** and **imbalances ripple** in either direction.

package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p3.population-ecology.md

@@ -0,0 +1,71 @@
+## `.brief.eco101.population-ecology`
+
+### 🧠 topic: population ecology
+
+---
+
+### 🎯 goal
+learn how populations grow, shrink, and stabilize — and what forces shape their numbers over time.
+
+---
+
+### 📈 population growth models
+
+#### **exponential growth**
+- occurs when resources are unlimited
+- population grows at a constant rate
+- **J-shaped curve**
+- equation: `dN/dt = rN`
+  where `r` = intrinsic rate of increase, `N` = population size
+
+#### **logistic growth**
+- growth slows as resources become limited
+- approaches a maximum size: **carrying capacity (K)**
+- **S-shaped curve**
+- equation: `dN/dt = rN(1 - N/K)`
+
+---
+
+### 🏞 carrying capacity & density dependence
+
+#### **carrying capacity (K)**
+- the max population size an environment can sustain over time
+- shaped by resource availability, habitat space, and ecosystem limits
+
+#### **density-dependent factors**
+- effects that increase with population size
+  e.g., disease, competition, predation, stress
+
+#### **density-independent factors**
+- effects unrelated to population size
+  e.g., weather events, natural disasters, pollution
+
+---
+
+### 🧮 population change drivers
+
+- **births (B)** – increase population
+- **deaths (D)** – decrease population
+- **immigration (I)** – individuals entering the population
+- **emigration (E)** – individuals leaving the population
+
+📊 total change: `ΔN = (B + I) - (D + E)`
+
+---
+
+### 📊 life tables & survivorship curves
+
+#### **life tables**
+- track survival and reproduction across age classes
+- used to calculate life expectancy, mortality rates, and reproduction output
+
+#### **survivorship curves**
+- graph survival probability over lifespan
+  - **Type I**: low early mortality (e.g., humans)
+  - **Type II**: constant mortality (e.g., birds)
+  - **Type III**: high early mortality (e.g., fish, plants)
+
+---
+
+### 🔁 mental model
+> population ecology reveals how a species’ **numbers respond to internal feedbacks and external forces** — shaped by **births, deaths, limits, and movement** over time.

package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p4.community-interactions.md

@@ -0,0 +1,78 @@
+## `.brief.eco101.community-interactions`
+
+### 🧠 topic: community interactions
+
+---
+
+### 🎯 goal
+understand how species interact, compete, and cooperate — and how these relationships shape the structure and function of ecological communities.
+
+---
+
+### 🔗 interaction types
+
+#### **competition (– / –)**
+- both species are harmed by shared resource use
+  e.g., two plants competing for sunlight
+
+#### **predation (+ / –)**
+- one species benefits by consuming another
+  e.g., wolf hunting deer
+
+#### **mutualism (+ / +)**
+- both species benefit
+  e.g., bees pollinate flowers while collecting nectar
+
+#### **parasitism (+ / –)**
+- one species benefits by exploiting another
+  e.g., tapeworm in a mammal’s intestine
+
+#### **commensalism (+ / 0)**
+- one species benefits, the other is unaffected
+  e.g., barnacles on a whale
+
+---
+
+### 📈 impact on fitness & composition
+
+- interactions affect **reproductive success**, survival, and access to resources
+- over time, these interactions shape:
+  - **who thrives or disappears**
+  - **which species coexist**
+  - **what niches get filled**
+
+---
+
+### 🧩 keystone species & niche partitioning
+
+#### **keystone species**
+- has a **disproportionate impact** on community structure
+- removing it can collapse food webs or shift ecosystems
+  e.g., sea otters controlling sea urchins, preserving kelp forests
+
+#### **niche partitioning**
+- species avoid direct competition by **dividing resources**
+  - by time (e.g., day vs. night feeders)
+  - by space (e.g., canopy vs. ground dwellers)
+  - by food type (e.g., seeds vs. insects)
+
+---
+
+### 🌱 succession: community change over time
+
+#### **primary succession**
+- starts from bare substrate (e.g., lava flow, glacier retreat)
+- slow buildup of soil and life from scratch
+
+#### **secondary succession**
+- recovery after disturbance (e.g., fire, flood, logging)
+- faster, since soil and seed banks may remain
+
+#### **climax community**
+- stable endpoint (in theory)
+- actual systems often remain dynamic due to ongoing disturbance
+
+---
+
+### 🔁 mental model
+> communities are **living tapestries woven by interaction** — shaped by who competes, who cooperates, and how species carve out niches, respond to change, and shape each other over time.

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.