rhachet-roles-bhrain 0.1.0

package/dist/roles/thinker/briefs/knowledge/kno201.documents.demos.[article].md

@@ -0,0 +1,42 @@
+# 🧩 documents.demo (relational treatment)
+
+## .what
+a **demo** is a document form that provides a **relational treatment** of a concept.
+its role is to **show how a particular instance exemplifies a concept**, making the abstract tangible through lived or observable cases.
+
+demos do not create the concept — they **materialize it** by spotlighting the link between instance and concept.
+
+---
+
+## 🔬 characteristics
+- **exemplificatory** → highlights “this is how *that* shows *this*”
+- **concrete** → rooted in specific cases, narratives, or simulations
+- **relational** → frames the connection between instance and concept
+- **illustrative** → emphasizes visibility and graspability over abstraction
+
+---
+
+## 🧷 forms of demos
+> note: these clusters are not exhaustive, but demonstrative
+
+- **case studies** → detailed instances exemplifying a concept in practice
+- **simulations** → modeled scenarios demonstrating principles
+- **narratives** → stories or dialogues that embody concepts
+- **worked examples** → step-by-step demonstrations of how a concept applies
+- **videos / performances** → live or recorded enactments of concepts in action
+
+---
+
+## 📌 examples
+- Portland as a demo of **walkability**
+- the Ferrari F1-75 as a demo of a **racecar**
+- a clinical case study as a demo of **disease presentation**
+- a worked math example as a demo of **algebraic principles**
+- a role-play video as a demo of **conflict resolution**
+
+---
+
+## ✨ role
+- **reveal** → make abstract concepts perceivable through concrete exemplars
+- **bridge** → connect the rawness of instances with the abstraction of concepts
+- **transmit** → enable intuitive grasp by showing, not just telling

package/dist/roles/thinker/briefs/knowledge/kno201.documents.lessons.[article].md

@@ -0,0 +1,42 @@
+# 🧩 documents.lesson (pedagogical treatment)
+
+## .what
+a **lesson** is a document form that provides a **pedagogical treatment** of a concept.
+its role is to **guide how a concept is learned and practiced**, sequencing instances and explanations into a structured path of understanding.
+
+lessons do not create the concept — they **materialize it** by arranging knowledge for comprehension, retention, and skill-building.
+
+---
+
+## 🔬 characteristics
+- **instructional** → oriented toward teaching and learning
+- **sequenced** → organizes material step by step, building progressively
+- **scaffolded** → supports learners with examples, exercises, and reinforcement
+- **transformative** → aims to change the learner’s state of knowledge or ability
+
+---
+
+## 🧷 forms of lessons
+> note: these clusters are not exhaustive, but demonstrative
+
+- **textbooks** → structured expositions covering domains systematically
+- **curricula** → multi-lesson frameworks guiding progression over time
+- **tutorials** → stepwise guides for practical skills or concepts
+- **workshops / exercises** → interactive sessions with application focus
+- **training manuals** → prescriptive guides for applied contexts
+
+---
+
+## 📌 examples
+- Euclid’s *Elements* as a lesson in **geometry**
+- a programming tutorial teaching **loops and conditionals**
+- a biology textbook chapter on **cell division**
+- a curriculum on **civic education** in schools
+- a workshop manual for **first aid procedures**
+
+---
+
+## ✨ role
+- **teach** → enable learners to internalize concepts through structured progression
+- **scaffold** → support comprehension with examples, practice, and review
+- **transmit** → pass concepts across generations and communities in durable form

package/dist/roles/thinker/briefs/knowledge/kno301.doc.compression.1.refs._.[article].md

@@ -0,0 +1,41 @@
+# 🧩 .brief: `documents.refs (minimal references)`
+
+## .what
+**refs** are a type of document at the most minimal scale.
+they function as **direct pointers to concepts** — often just a word, phrase, or short sentence.
+unlike longer documents, they do not develop, explain, or organize; they simply **reference**.
+
+---
+
+## 🔬 characteristics
+- **minimal** → the smallest possible form of a document
+- **indexical** → serve to point toward a concept without elaboration
+- **atomic** → can be embedded within larger documents as building blocks
+- **dependent** → rely on context (shared language, prior knowledge) to be meaningful
+
+---
+
+## 🧷 forms of refs
+> note: not exhaustive, but demonstrative
+
+- **single words** → “gravity,” “justice,” “walkability”
+- **short phrases** → “social contract,” “supply and demand”
+- **sentence-pointers** → “see Newton on planetary motion,” “refer to Portland as an example”
+- **labels / tags** → category names, hashtags, keywords
+
+---
+
+## 📌 examples
+- the term **“photosynthesis”** pointing to the concept of energy conversion in plants
+- the word **“democracy”** referencing the concept of collective governance
+- a tag like **#leadership** indexing content about the social concept of leadership
+- a margin note: *“cf. Euclid, Book I”*
+
+---
+
+## ✨ role
+- **name** → provide handles for concepts so they can be referenced in discourse
+- **index** → act as entry points into larger bodies of knowledge
+- **embed** → function as the basic building blocks within more expansive documents
+
+refs are thus the **minimal mode of documents**: pure reference without expansion, anchoring the link between language and concepts.

package/dist/roles/thinker/briefs/knowledge/kno301.doc.compression.2.kernels._.[article].i1.md

@@ -0,0 +1,50 @@
+# 🧩 .brief: `doc.kernel`
+
+## .what
+a **doc.kernel** is the **atomic variant of a document**.
+it carries exactly **one concept**, expressed in its **minimal viable form**.
+a kernel is not a pointer (like a ref), nor a structured articulation (like a brief) — it is the smallest **fertile expression** of a concept, portable across contexts.
+
+---
+
+## 🎯 purpose
+- **seed** a concept for recomposition, growth, or articulation
+- preserve integrity of a single idea while stripping away excess context
+- provide a unit small enough to combine, cluster, or transplant into new docs
+
+---
+
+## ⚙️ properties
+- **atomic** — cannot be reduced further without losing the concept
+- **fertile** — can grow into a brief, article, or larger doc
+- **portable** — independent of its original doc; reusable elsewhere
+- **focused** — always represents *one and only one* concept
+
+---
+
+## 🔄 relation to other variants
+- 🔖 **doc.ref** = *points* to a concept, but carries no content
+- 🌱 **doc.kernel** = *seeds* a concept in its minimal expression
+- 🪴 **doc.brief** = *carries* one or more concepts in structured, compressed form
+- 📚 **doc** = *hosts* concepts at any scale, compression unspecified
+
+---
+
+## 📌 examples
+
+### ⚖️ gravity
+- 🌱 **doc.kernel:** `masses attract one another`
+
+### 🎵 music
+- 🌱 **doc.kernel:** `organized sound creates aesthetic or emotional experience`
+
+### 🧩 triangle
+- 🌱 **doc.kernel:** `a triangle has three sides`
+
+---
+
+## ✨ insight
+a **doc.kernel** is the **seed-unit of conceptual materialization**:
+- smaller than a brief, richer than a ref.
+- designed for portability, recomposition, and growth.
+- the foundation of the compression axis — the **irreducible carriers of meaning** inside the doc ecosystem.

package/dist/roles/thinker/briefs/knowledge/kno301.doc.compression.3.briefs._.[article].md

@@ -0,0 +1,40 @@
+# 🧩 .brief: `documents.briefs (compressed references)`
+
+## .what
+**briefs** are a type of document that provide **compressed, high-density articulation** of a concept.
+they sit between minimal references (🔖 refs) and expansive documents, guaranteeing **at least a few paragraphs** of structured content with **maximum signal and minimum noise**.
+
+---
+
+## 🔬 characteristics
+- **compressed** → distill essential meaning without redundancy
+- **structured** → organized into clear sections for readability
+- **length-anchored** → never too short (≥ a few paragraphs), but intentionally concise
+- **treatment-flexible** → can take the form of article, catalog, demo, or lesson
+
+---
+
+## 🧷 forms of briefs
+> note: not exhaustive, but demonstrative
+
+- **brief.article** → compressed definitional treatment
+- **brief.catalog** → compressed organizational mapping
+- **brief.demo** → compressed instance-to-concept exemplification
+- **brief.lesson** → compressed pedagogical sequence
+
+---
+
+## 📌 examples
+- a 3-paragraph **brief.article** on **leadership** defining the concept clearly
+- a **brief.catalog** listing and explaining three main types of **volcanoes**
+- a **brief.demo** showing Portland as an instance of **walkability**
+- a **brief.lesson** on **supply and demand** with a short guided example
+
+---
+
+## ✨ role
+- **distill** → cut away noise, leaving only essential articulation
+- **transmit** → offer quick but thorough grasp of a concept
+- **standardize** → provide a reliable format for compressed knowledge work
+
+briefs are the **high-efficiency mode of documents**: not minimal pointers, but maximally compact treatments that balance depth with brevity.

package/dist/roles/thinker/briefs/knowledge/kno301.doc.compression._.[article].md

@@ -0,0 +1,90 @@
+# 🧩 .brief: `document variants along the compression axis`
+
+## .what
+all four are **documents**.
+the compression axis distinguishes how a doc carries concepts, from anemic pointers to compressed articulations.
+
+---
+
+## 📊 compressed overview
+
+| variant           | purpose | compression  | concept span   | role |
+|-------------------|---------|--------------|----------------|------|
+| 🔖 **doc.ref**    | point   | anemic       | one            | handle into a concept (no content itself) |
+| 🌱 **doc.kernel** | seed    | atomic       | one            | minimal expression, fertile for growth |
+| 🪴 **doc.brief**  | carry   | compressed   | one or more    | self-contained, structured, and transferable |
+| 📚 **doc**        | host    | unspecified  | one or more    | general materialization at any scale |
+
+---
+
+## 🌳 hierarchy
+
+📚 **doc** (unspecified; superset of all document forms)
+├─ 🔖 **doc.ref** — point | anemic | one concept
+├─ 🌱 **doc.kernel** — seed | atomic | one concept
+└─ 🪴 **doc.brief** — carry | compressed | one or more concepts
+
+---
+
+## 🔬 variants
+
+### 🔖 doc.ref
+- **purpose:** point to a concept
+- **concept span:** one
+- **compression:** **anemic** — no content beyond the pointer
+- **role:** handle or entry point
+
+---
+
+### 🌱 doc.kernel
+- **purpose:** seed a concept
+- **concept span:** one
+- **compression:** **atomic** — smallest viable expression
+- **role:** seed for recomposition and growth
+
+---
+
+### 🪴 doc.brief
+- **purpose:** carry concepts
+- **concept span:** one or more
+- **compression:** **compressed** — maximally dense and structured
+- **role:** portable garden — transplant kernels into new soil to grow structured articulations
+
+---
+
+### 📚 doc
+- **purpose:** host concepts
+- **concept span:** one or more
+- **compression:** **unspecified** — may be sprawling or concise, raw or polished
+- **role:** general garden of concept-materialization
+
+---
+
+## 📌 examples
+
+### ⚖️ gravity
+- 🔖 **doc.ref:** *“gravity”*
+- 🌱 **doc.kernel:** `masses attract one another`
+- 🪴 **doc.brief:** a short structured explanation of gravitational attraction
+- 📚 **doc:**
+    1. *Principia Mathematica* — a formal treatise systematizing mechanics
+    2. a student’s scattered lecture notes on gravitational formulas
+    3. a transcript of a casual conversation about why objects fall
+
+---
+
+### 🎵 music
+- 🔖 **doc.ref:** *“music”*
+- 🌱 **doc.kernel:** `organized sound creates aesthetic or emotional experience`
+- 🪴 **doc.brief:** a short structured explanation of rhythm, melody, and harmony
+- 📚 **doc:**
+    1. *The Oxford History of Western Music* — a comprehensive historical survey
+    2. a rehearsal-room conversation captured on tape
+    3. a brainstorm list of lyrics and riffs scattered in a notebook
+
+---
+
+## ✨ insight
+- 📚 **doc** = the superset: compression **unspecified**.
+- 🔖 **doc.ref**, 🌱 **doc.kernel**, and 🪴 **doc.brief** = declared variants along the compression axis.
+- all are docs; the axis shows their distinct **purposes**, **compression roles**, and **concept spans**.

package/dist/roles/thinker/briefs/knowledge/kno301.doc.compression._.[catalog].persp.garden.md

@@ -0,0 +1,64 @@
+# 🧩 .brief.catalog: `doc types as gardens`
+
+## .what
+these are **examples of 📚 docs viewed through the compression axis**, expressed as garden metaphors.
+they illustrate different ways concepts can be carried or hosted, but the list is **not exhaustive** — other forms of docs exist.
+
+---
+
+## 📊 compressed overview
+
+| doc type         | garden type             | character                          | growth style                          |
+|------------------|-------------------------|------------------------------------|---------------------------------------|
+| **ref**          | plant label / tag       | minimal, purely indicative          | marks seeds, sprouts, plots, or pots  |
+| **kernel**       | seed                    | atomic, fertile, irreducible        | portable, can be planted anywhere     |
+| **brief**        | portable garden (pot)   | compact, structured, self-contained | sprout-scale growth, transplantable   |
+| **book**         | orchard                 | expansive, long-term                | cultivated trees with interlinked roots |
+| **conversation** | wild plot               | untamed, fertile, messy             | spontaneous sprouts, weeds, mixed seeds |
+
+---
+
+## 🎨 clusters
+
+### 🔖 **ref = plant label**
+- acts as a marker or tag in the garden.
+- points to kernels, sprouts, or plots without carrying content.
+- enables orientation and indexing.
+
+---
+
+### 🌱 **kernel = seed**
+- atomic, fertile unit.
+- irreducible expression of one concept.
+- can be harvested and transplanted into new soil.
+
+---
+
+### 🪴 **brief = portable garden (pot)**
+- structured but compact.
+- kernels transplanted from other soil.
+- sprouts cultivated in a way that’s easy to move, share, or repurpose.
+
+---
+
+### 🌳 **book = orchard**
+- long-term conceptual growth.
+- cultivated trees arranged with intention.
+- produces durable harvests, often interconnected.
+
+---
+
+### 🌾 **conversation = wild plot**
+- unstructured, seeds scattered by chance.
+- sprouts and weeds intermingle.
+- kernels must be harvested before reuse.
+
+---
+
+## 🌿 implications
+- these garden types are **illustrative examples of 📚 docs along the compression axis**, not an exhaustive taxonomy.
+- 🔖 **refs = labels** that point but don’t carry.
+- 🌱 **kernels = seeds** that hold one fertile concept.
+- 🪴 **briefs = pots** — portable gardens designed for clarity.
+- 🌳 **books = orchards** — cultivated ecosystems of durable concepts.
+- 🌾 **conversations = wild plots** — messy, fertile, but unstructured scatterings of kernels.

package/dist/roles/thinker/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[article].md

@@ -0,0 +1,45 @@
+# 🧩 .brief: `from instances to documents.briefs`
+
+## .what
+**instances** (🔹 observations: data, events, specimens, cases) are the raw substrate of knowledge.
+**documents.briefs** (📝 compressed references) are structured, high-density articulations of concepts.
+a brief emerges by **selecting, arranging, and compressing instances** to materialize a concept with maximal clarity.
+
+---
+
+## ⚙️ process
+
+1. **collect instances**
+   - gather relevant observations tied to the concept
+   - e.g., apples falling, planets orbiting, ocean tides
+
+2. **select for salience**
+   - choose the most representative instances
+   - filter out noise or redundancies
+
+3. **arrange structurally**
+   - organize chosen instances into a compact narrative or argument
+   - highlight how they reveal the concept’s pattern or principle
+
+4. **compress articulation**
+   - distill explanation into a few paragraphs
+   - ensure maximum signal, minimal noise
+
+---
+
+## 📌 example: gravity
+
+- 🔹 **instances:** apple falling, moon orbit, ocean tides
+- 📝 **brief.article:** a 3-paragraph compressed articulation:
+  - defines gravity as attraction of masses
+  - relates with the falling apple and lunar orbit
+  - explains significance for physics and daily life
+
+---
+
+## ✨ insight
+- **instances supply the evidence**
+- **briefs supply the compressed articulation**
+- the act of making a brief is the act of **curating and condensing instances** so the concept becomes both perceptible and transmissible in minimal space.
+
+briefs are thus **concept-materializations distilled through selective instance organization**.

package/dist/roles/thinker/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].algorithm.md

@@ -0,0 +1,54 @@
+# 🧩 .brief.demo: `brief archetypes via algorithm`
+
+## .what
+the same set of **instances** (🔢 sorting a list, 🗺️ shortest-path on a map, 📐 euclid’s gcd) can be compressed into different **brief archetypes**.
+this demo shows how the concept of an **algorithm** is materialized differently depending on the treatment: definitional, organizational, relational, or pedagogical.
+
+---
+
+## 📖 brief.article — definitional
+**treatment:** clarify *what an algorithm is*
+**content:**
+- defines an algorithm as a **finite, effective procedure** that transforms inputs to outputs via well-specified steps
+- relates with sorting a list (input→ordered output) and navigating a shortest path (start→goal)
+- explains key properties: correctness, termination, complexity, and determinism/probabilism
+
+---
+
+## 🗂️ brief.catalog — organizational
+**treatment:** map *how algorithms vary*
+**content:**
+- **paradigms:** divide-and-conquer, dynamic programming, greedy, backtracking
+- **guarantees:** exact vs approximate; deterministic vs randomized
+- **models/costs:** time vs space complexity; online vs offline
+- relates these facets as dimensions for classifying algorithms
+
+---
+
+## 🎬 brief.demo — relational
+**treatment:** show *how one instance exemplifies the concept*
+**content:**
+- takes **euclid’s algorithm** for gcd(a, b) as the focal instance
+- relates the step rule `gcd(a, b) = gcd(b, a mod b)` until `b = 0` → output `a`
+- bridges concreteness (repeated remainder) to general qualities: termination, correctness proof, complexity `O(log min(a,b))`
+
+---
+
+## 🎓 brief.lesson — pedagogical
+**treatment:** guide *how to learn algorithms step by step*
+**content:**
+1. start with a recipe-like task (sort 5 numbers by hand) and write the steps
+2. trace pseudocode for selection sort; count comparisons/swaps
+3. compare with merge sort; discuss divide-and-conquer idea
+4. apply to a pathfinding task (sketch dijkstra on a tiny graph)
+- relates concrete traces to abstractions (invariants, correctness, big-O)
+
+---
+
+## ✨ insight
+- 📖 **article** defines the essence (finite, effective, specified steps)
+- 🗂️ **catalog** organizes paradigms, guarantees, and cost models
+- 🎬 **demo** exemplifies via a single concrete algorithm (euclid)
+- 🎓 **lesson** teaches the craft through tracing, proofs, and analysis
+
+this demo shows how **algorithms**—though formal and abstract—are materialized through brief archetypes, each relating shared instances in a distinct way.

package/dist/roles/thinker/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].color.md

@@ -0,0 +1,56 @@
+# 🧩 .brief.demo: `brief archetypes via color`
+
+## .what
+the same **instances** (🌈 prism spectrum, 📱 rgb display, 🎨 paint mixing, 👗 “the dress” illusion) can be compressed into different **brief archetypes**.
+this demo shows how **color** is materialized differently depending on the treatment: definitional, organizational, relational, or pedagogical.
+
+---
+
+## 📖 brief.article — definitional
+**treatment:** clarify *what color is*
+**content:**
+- defines color as a **perceptual attribute** arising from a stimulus’s spectral power distribution **as interpreted by the human visual system** (cone responses and opponent channels)
+- relates with additive light mixing (rgb on a display) vs subtractive pigment mixing (cmyk/paint) and notes **color constancy** (perceived color stabilizes across lighting)
+
+---
+
+## 🗂️ brief.catalog — organizational
+**treatment:** map *how color varies*
+**content:**
+- **physical:** wavelength/spectrum, illuminant, reflectance
+- **physiological:** l/m/s cones; opponent axes (red↔green, blue↔yellow)
+- **psychophysical:** hue, saturation/chroma, lightness/value
+- **representational:** rgb, cmyk, cie xyY / lab / lch; device gamut
+- **contextual phenomena:** constancy, adaptation, metamerism, simultaneous contrast
+- relates these lenses as complementary slices of one concept
+
+---
+
+## 🎬 brief.demo — relational
+**treatment:** show *how one instance exemplifies color*
+**content:**
+- takes **“the dress”** photo as the focal instance
+- relates how **assumed illuminant** (cool shadow vs warm spotlight) shifts perceived white balance, yielding **blue/black** vs **white/gold**
+- bridges to color constancy and the role of priors/context in perception
+
+---
+
+## 🎓 brief.lesson — pedagogical
+**treatment:** guide *how to learn color step by step*
+**content:**
+1. view a phone screen through a macro lens to see **rgb subpixels** (additive mixing)
+2. mix **cyan, magenta, yellow** paints to feel subtractive interactions
+3. compare two lights that look the **same color** but have **different spectra** (metamers)
+4. try a checker-shadow or gray-bar illusion to feel **context effects**
+5. plot a few samples in **cie lab** to connect perception to coordinates
+- relates hands-on activities to the principles of spectrum → cones → appearance → color spaces
+
+---
+
+## ✨ insight
+- 📖 **article** defines
+- 🗂️ **catalog** organizes
+- 🎬 **demo** exemplifies
+- 🎓 **lesson** teaches
+
+one concept, **color**, becomes graspable through different brief treatments, each relating shared instances in a distinct way.

package/dist/roles/thinker/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].empathy.md

@@ -0,0 +1,54 @@
+# 🧩 .brief.demo: `brief archetypes via empathy`
+
+## .what
+the same set of **instances** (🔹 comforting a friend, 🏥 a nurse attending a patient, 🤝 a manager listening to an employee) can be compressed into different **brief archetypes**.
+this demo shows how the concept of **empathy** is materialized differently depending on the treatment: definitional, organizational, relational, or pedagogical.
+
+---
+
+## 📖 brief.article — definitional
+**treatment:** clarify *what empathy is*
+**content:**
+- defines empathy as the capacity to understand and share another’s feelings
+- relates with the instance of a friend comforting another in distress
+- explains its role in emotional intelligence and social connection
+
+---
+
+## 🗂️ brief.catalog — organizational
+**treatment:** map *how empathy manifests across cases*
+**content:**
+- **cognitive empathy** → recognizing another’s perspective (manager listening to employee)
+- **emotional empathy** → sharing another’s feeling (friend comforting friend)
+- **compassionate empathy** → acting to alleviate suffering (nurse caring for patient)
+- relates these forms as variations of one overarching concept
+
+---
+
+## 🎬 brief.demo — relational
+**treatment:** show *how one instance exemplifies empathy*
+**content:**
+- takes the nurse attending to a patient as the focal instance
+- relates this act of attentive care to the broader concept of empathy
+- bridges the concrete act with the general principle of responding to another’s suffering
+
+---
+
+## 🎓 brief.lesson — pedagogical
+**treatment:** guide *how to learn empathy step by step*
+**content:**
+1. observe someone in emotional discomfort (instance: friend in distress)
+2. practice perspective-taking (imagine how they feel)
+3. respond verbally or physically to validate their feelings (comfort them)
+4. reflect on the impact of your action (did it help them feel understood?)
+- relates specific practices to the abstract principle of empathy
+
+---
+
+## ✨ insight
+- 📖 **article** defines empathy
+- 🗂️ **catalog** organizes types of empathy
+- 🎬 **demo** exemplifies empathy through a concrete case
+- 🎓 **lesson** teaches empathy as a learnable skill
+
+this demo shows how a single human concept, **empathy**, can be materialized through different brief archetypes, each relating the same set of instances in a distinct way.

package/dist/roles/thinker/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].entropy.md

@@ -0,0 +1,54 @@
+# 🧩 .brief.demo: `brief archetypes via entropy`
+
+## .what
+the same set of **instances** (🧊 ice melting, 🃏 shuffling a deck, 🗜️ lossless data compression limits) can be compressed into different **brief archetypes**.
+this demo shows how the concept of **entropy** is materialized differently depending on the treatment: definitional, organizational, relational, or pedagogical.
+
+---
+
+## 📖 brief.article — definitional
+**treatment:** clarify *what entropy is*
+**content:**
+- defines entropy as a measure of multiplicity/disorder (thermo) or uncertainty/information (info theory)
+- relates with ice melting (more microstates) and shuffled cards (higher uncertainty)
+- explains why entropy tends to increase in closed systems and how it bounds compression
+
+---
+
+## 🗂️ brief.catalog — organizational
+**treatment:** map *how entropy manifests across cases*
+**content:**
+- **thermodynamic entropy** → energy dispersal, phase change (ice → water)
+- **statistical entropy** → microstate counts, shuffled deck outcomes
+- **information entropy** → average surprise, compression limits
+- relates the three as views of “states + probabilities” under different lenses
+
+---
+
+## 🎬 brief.demo — relational
+**treatment:** show *how one instance exemplifies entropy*
+**content:**
+- takes shuffling a new deck of cards as the focal instance
+- relates the move from a highly ordered state to one with vastly more possible arrangements
+- bridges this to uncertainty (info theory) and to the likelihood of higher-entropy states (stat mech)
+
+---
+
+## 🎓 brief.lesson — pedagogical
+**treatment:** guide *how to learn entropy step by step*
+**content:**
+1. start with coin flips to feel uncertainty (1 flip vs 10 flips)
+2. compare ordered vs shuffled decks (counting possibilities)
+3. observe ice warming/melting (energy dispersal)
+4. connect to compression: truly random data resists shrinking
+- relates concrete activities to the abstract principle “more possible states → higher entropy”
+
+---
+
+## ✨ insight
+- 📖 **article** defines entropy across domains
+- 🗂️ **catalog** organizes thermodynamic, statistical, and information views
+- 🎬 **demo** exemplifies entropy via a single concrete case
+- 🎓 **lesson** teaches entropy through progressive activities
+
+this demo shows how cross-domain **entropy** can be materialized through brief archetypes, each relating the same instances in a distinct way.