diff --git a/README.md b/README.md index ea3ac5f..70d3b76 100644 --- a/README.md +++ b/README.md @@ -32,36 +32,62 @@ ## π― What Is Substrate? > [!IMPORTANT] -> **The Problem:** We measure GDP growth while missing the slow-motion collapse of human thriving happening in plain sight. Traditional metrics (economic output, unemployment rates, stock prices) tell us how the economy is doingβnot how *people* are doing. +> **Substrate provides components, not conclusions.** You decide what they mean and how they connect. -### **Our Philosophy: Know the Actual State of People** +### **A Shared Foundation for Human Knowledge** -When we theorize about solutions or propose policies, we should be informed by **the actual state of people**βnot abstractions, not averages, not GDP. +Think of **substrate** as the base layerβthe common ground where we can all explore problems, solutions, and evidence together. Instead of fragmented discussions happening in isolation, Substrate gives us **one place** to: -**Substrate captures what traditional metrics miss:** +- **Document what's wrong** β Problems with evidence +- **Propose what works** β Solutions with results +- **Connect the dots** β Link people, organizations, projects, data +- **Build arguments** β Reasoning chains anyone can evaluate +- **Track outcomes** β What actually happened vs. what was promised -- π¨ **Crisis indicators** β Overdoses and suicides reveal community breakdown before economic metrics decline -- π **Behavioral truth** β Credit card delinquency and quit rates show what surveys miss (actions > stated preferences) -- ποΈ **Structural determinants** β Air quality, commute times, internet accessβconstraints people can't "self-care" out of -- β‘ **Leading indicators** β Financial stress predicts recessions; worker quit rates signal economic health -- π― **Geographic granularity** β County-level data ensures no community suffers invisibly +**The Vision:** A collaborative knowledge substrate where: +- π§© **Anyone can contribute** components (problems, solutions, data, arguments) +- π **Everything connects** through explicit IDs and relationships +- π **Evidence grounds claims** with authoritative data sources +- π€ **AI assists exploration** while humans decide what matters +- π **We all share** a common foundation for understanding reality -> **Substrate provides components, not conclusions.** We give you authoritative evidence about human wellbeing. You decide what it means and how to act on it. - -**An open-source framework for capturing reality:** +**An open-source framework connecting 17+ knowledge components:** ```mermaid -graph LR - A[π Data Sources] --> B[π Substrate Core] - C[π§© Problems] --> B - D[π‘ Solutions] --> B - E[π Arguments] --> B - F[π₯ People & Orgs] --> B - B --> G[π€ AI Analysis] - B --> H[π§ Human Insight] - G --> I[π Knowledge Graph] - H --> I - I --> J[π Understanding] +graph TB + subgraph "π The Substrate" + A[π§© Problems] + B[π‘ Solutions] + C[π Data Sources] + D[π£οΈ Arguments] + E[π Claims] + F[π₯ People] + G[π’ Organizations] + H[π Projects] + I[π Plans] + J[π― Values] + K[π Ideas] + end + + L[π€ Human Contributors] --> A + L --> B + L --> D + M[π€ AI Analysis] --> A + M --> B + M --> D + + A -.connects to.-> B + B -.connects to.-> C + D -.connects to.-> C + E -.connects to.-> C + F -.connects to.-> G + G -.connects to.-> H + H -.connects to.-> B + + A --> N[π Shared Understanding] + B --> N + C --> N + D --> N ```