rhachet-roles-ehmpathy 1.0.0 → 1.2.0

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**.

package/dist/logic/roles/ecologist/.briefs/product/user.journey._.[article].i1.md

@@ -0,0 +1,68 @@
+# 🧩 .brief: `user.journey`
+
+## .what
+
+A **user journey** is a detailed visualization or narrative that maps out the steps a user takes to achieve a particular goal with a product or service. It captures the user's experience over time and across touchpoints, highlighting interactions, emotions, pain points, and opportunities for improvement.
+
+---
+
+## 🎯 purpose
+
+- **understand user experience**: identify how users interact with your product at each stage
+- **improve design**: reveal areas where the product flow may need optimization
+- **align teams**: provide a shared framework for stakeholders to agree on user needs and expectations
+- **empathize with users**: gain insights into the emotional journey and challenges faced by users
+
+---
+
+## 🛠 components
+
+1. **personas**: represent the user segments for whom the journey is mapped
+2. **touchpoints**: identify where and how interactions occur with the product
+3. **actions**: outline the steps taken by the user to achieve their goal
+4. **emotions**: track user feelings at each stage to provide context on their experience
+5. **pain points**: highlight obstacles faced by users, offering areas for improvement
+6. **opportunities**: suggest enhancements to better meet user needs and expectations
+
+---
+
+## 🧭 example
+
+### `persona`: Anna, a busy professional looking to manage her tasks
+
+1. **awareness**: Anna discovers a task management app via a friend recommendation
+   - **emotion**: curious
+   - **pain point**: unsure of which app features suit her needs
+
+2. **consideration**: researches and compares app features
+   - **emotion**: interested but overwhelmed
+   - **pain point**: too many options to filter through
+
+3. **decision**: downloads the app after reading positive reviews
+   - **emotion**: excited but cautious
+   - **opportunity**: easy onboarding process simplifies initial use
+
+4. **retention**: uses the app to organize tasks effectively
+   - **emotion**: satisfied and productive
+   - **pain point**: occasional difficulties in app navigation
+
+5. **advocacy**: recommends the app to colleagues
+   - **emotion**: confident and pleased
+   - **opportunity**: loyalty program to encourage referrals
+
+---
+
+## 🔗 related concepts
+
+- **customer journey**: broader scope capturing all interactions a customer has with a brand
+- **service blueprint**: complements user journeys by detailing back-end processes
+
+---
+
+## ⚠️ notes
+
+- Ensure the journey is based on actual user research to maintain accuracy
+- Visual representations, like diagrams or storyboards, can enhance understanding
+- User journeys should be revisited regularly to adapt to changing user needs and behaviors
+
+---

package/dist/logic/roles/ecologist/.briefs/product/user.journey.purpose.[article].i1.md

@@ -0,0 +1,52 @@
+# 🧩 .brief: `purpose of a user.journey`
+
+## .what
+
+The **purpose of a user journey** is to holistically understand and improve the user experience with a product or service. It provides a structured approach to mapping out the user’s interactions, emotions, and challenges, ensuring that each stage of the journey contributes to a seamless and satisfying user experience.
+
+---
+
+## 🎯 goals
+
+- **enhance user experience**: identify areas of friction and opportunities for improvement.
+- **inform design decisions**: provide insights and data to guide UX and UI enhancements.
+- **align cross-functional teams**: offer a unified view of user interactions to foster collaboration across departments like marketing, development, and support.
+- **increase empathy**: deepen understanding of user emotions and motivations to drive user-centered design.
+
+---
+
+## 🌿 benefits
+
+- **clarity**: reveals the full end-to-end user narrative, facilitating better decision-making.
+- **insight**: uncovers specific pain points and emotional highs and lows that users experience.
+- **strategy**: aids in prioritizing feature development and customer support improvements.
+- **innovation**: stimulates new opportunities for offering value through enhanced user interactions.
+
+---
+
+## 🔄 process integration
+
+Creating a user journey typically involves:
+
+1. **Research**: Collect data through user interviews, surveys, and observation to understand user actions and feelings.
+2. **Synthesis**: Identify key stages and touchpoints in the user’s interaction with the product.
+3. **Mapping**: Develop a visual or narrative representation of the user journey to highlight crucial interactions.
+4. **Analysis**: Evaluate the journey to identify areas for enhancement and innovation.
+
+---
+
+## 🗂️ application
+
+- Useful in **product development** to ensure user needs guide feature updates.
+- Vital for **marketing teams** to tailor messaging and communication strategies.
+- Incorporated in **customer support** to improve service quality and responsiveness.
+
+---
+
+## ❗️ considerations
+
+- Ensure the journey is grounded in authentic user data to remain relevant and actionable.
+- Regular updates are necessary as user needs and technologies evolve.
+- Visual aids like storyboards and flowcharts can enhance comprehension and engagement with the journey map.
+
+---

package/dist/logic/roles/ecologist/.briefs/product/user.journey.purpose.[article].md

@@ -0,0 +1,52 @@
+# 🧩 .brief: `purpose of a user.journey`
+
+## .what
+
+The **purpose of a user journey** is to holistically understand and improve the user experience with a product or service. It provides a structured approach to mapping out the user’s interactions, emotions, and challenges, ensuring that each stage of the journey contributes to a seamless and satisfying user experience.
+
+---
+
+## 🎯 goals
+
+- **enhance user experience**: identify areas of friction and opportunities for improvement.
+- **inform design decisions**: provide insights and data to guide UX and UI enhancements.
+- **align cross-functional teams**: offer a unified view of user interactions to foster collaboration across departments like marketing, development, and support.
+- **increase empathy**: deepen understanding of user emotions and motivations to drive user-centered design.
+
+---
+
+## 🌿 benefits
+
+- **clarity**: reveals the full end-to-end user narrative, facilitating better decision-making.
+- **insight**: uncovers specific pain points and emotional highs and lows that users experience.
+- **strategy**: aids in prioritizing feature development and customer support improvements.
+- **innovation**: stimulates new opportunities for offering value through enhanced user interactions.
+
+---
+
+## 🔄 process integration
+
+Creating a user journey typically involves:
+
+1. **Research**: Collect data through user interviews, surveys, and observation to understand user actions and feelings.
+2. **Synthesis**: Identify key stages and touchpoints in the user’s interaction with the product.
+3. **Mapping**: Develop a visual or narrative representation of the user journey to highlight crucial interactions.
+4. **Analysis**: Evaluate the journey to identify areas for enhancement and innovation.
+
+---
+
+## 🗂️ application
+
+- Useful in **product development** to ensure user needs guide feature updates.
+- Vital for **marketing teams** to tailor messaging and communication strategies.
+- Incorporated in **customer support** to improve service quality and responsiveness.
+
+---
+
+## ❗️ considerations
+
+- Ensure the journey is grounded in authentic user data to remain relevant and actionable.
+- Regular updates are necessary as user needs and technologies evolve.
+- Visual aids like storyboards and flowcharts can enhance comprehension and engagement with the journey map.
+
+---