rhachet-roles-bhrain 0.1.0

package/dist/roles/thinker/briefs/logistics/term.logistics.of_knowledge.[article].md

@@ -0,0 +1,29 @@
+# 🧠 concept: knowledge logistics for llms
+
+## core concept
+**knowledge logistics** is the practice of **organizing, moving, and delivering knowledge resources** within large language model (llm) workflows, ensuring that the **right context, at the right level of abstraction, is available at the right time** during interaction or computation.
+
+## why it matters
+- llms are powerful engines but **context-hungry**: they require carefully selected prompts, memory, and external references.
+- without logistics, llms face **bottlenecks** (too much irrelevant data), **starvation** (missing critical facts), or **distortion** (knowledge delivered in the wrong form).
+- knowledge logistics makes llm outputs **faster, more accurate, and more aligned** with user goals.
+
+## key functions
+- **origination** – identifying where knowledge resides (documents, databases, memory, web, user input)
+- **curation** – filtering, chunking, and prioritizing knowledge for relevance
+- **transformation** – reformatting into embeddings, summaries, structured prompts, or retrieval queries
+- **storage & retrieval** – maintaining efficient memory (vector DBs, caches, artifacts) for on-demand use
+- **routage** – directing knowledge to the correct llm role, stage, or reasoning path
+- **delivery** – inserting knowledge into prompts with optimal timing, scope, and form
+- **feedback loop** – monitoring llm performance and refining what, when, and how knowledge is supplied
+
+## scope in llm ecosystems
+- **prompt engineering** – deciding what parts of knowledge get foregrounded vs backgrounded
+- **retrieval-augmented generation (rag)** – logistics of pulling the right chunks at inference time
+- **agent workflows** – coordinating knowledge between multiple specialized llms or roles
+- **knowledge distillation** – compressing large knowledge stores into reusable formats (briefs, embeddings, indexes)
+- **continuous learning** – ensuring new knowledge flows into llm systems without overwhelming or corrupting them
+
+---
+
+👉 in short: **knowledge logistics** = *the supply chain of concepts for llms — getting the right knowledge, in the right form, to the right place in the reasoning process.*

package/dist/roles/thinker/briefs/physics/optics.focal.acuity.md

@@ -0,0 +1,77 @@
+# .brief: focal.acuity
+
+## what
+
+**focal.acuity** refers to the **fineness of structure** that can be resolved **at the focal plane** — the geometric surface where optical focus is sharpest. It represents the **resolving power** of the system in the region of maximum clarity.
+
+---
+
+## why
+
+While **focal.depth** determines *how much* of the scene appears in focus, **focal.acuity** determines *how sharply* the focal plane itself is rendered.
+
+It is essential for:
+- Capturing fine textures and edge contrast
+- Supporting high-resolution imaging
+- Achieving clinical clarity in product, macro, and technical photography
+
+---
+
+## governed by
+
+### 🔬 Diffraction-limited resolution
+
+blur_diameter = d = 2.44 * λ * N
+=> focal.acuity ∝ 1 / d
+=> focal.acuity ∝ 1 / N
+
+```\`\`
+focal.acuity ∝ 1 / N
+\`\```
+
+where:
+- d = diffraction blur diameter
+- lambda = wavelength of light (e.g. 550 nm for green)
+- N = aperture (f-number)
+
+> focal.acuity **decreases** (detail coarsens) with:
+> - smaller aperture (larger f-number)
+> - longer wavelengths (e.g. redder light)
+
+---
+
+## key behaviors
+
+| Adjustment                   | Effect on focal.acuity        |
+|------------------------------|-------------------------------|
+| Larger aperture (↓ f-number) | increases it (sharper detail) |
+| Smaller aperture (↑ f-number)| decreases it (diffraction blur) |
+| Shorter wavelength           | increases it (sharper edges)  |
+| Better optics/sensor         | improves overall acuity       |
+
+---
+
+## creative usage
+
+- **High focal.acuity** (e.g. f/2.8–f/5.6):
+  - Yields crisp microtexture and high subject clarity
+  - Ideal for macro, studio, and product photography
+
+- **Reduced focal.acuity** (e.g. f/16–f/22):
+  - Acceptable in landscape or documentary work
+  - Used when prioritizing depth over precision
+
+---
+
+## limitations
+
+- **focal.acuity** is fundamentally limited by diffraction at small apertures
+- Increasing acuity reduces **focal.depth**, unless distance is increased
+- Post-processing cannot restore detail beyond optical resolution
+
+---
+
+## metaphorical phrasing
+
+> **focal.acuity** is how finely your lens can **etch the truth** onto the focal plane
+> It defines the **maximum clarity** achievable in the region of perfect focus

package/dist/roles/thinker/briefs/physics/optics.focal.breadth.md

@@ -0,0 +1,74 @@
+# .brief: focal.breadth
+
+## what
+
+**focal.breadth** refers to the **field of view** (FoV) — the angular or spatial extent of the scene captured by the lens. It defines *how much* of the world is included in the frame, horizontally, vertically, and diagonally.
+
+The term "breadth" is used here as a conceptual synonym for FoV: a lens’s **focal.breadth** determines the spatial span visible at any moment of focus.
+
+---
+
+## why
+
+**focal.breadth** governs spatial inclusion:
+- Wide breadth = broader context, more environment, less magnification
+- Narrow breadth = tighter crop, more subject isolation, stronger compression
+
+This impacts:
+- **Composition and storytelling**
+- **Spatial relationships** (e.g. background flattening)
+- **Perceptual distance** between foreground and background elements
+
+---
+
+## governed by
+
+### 📐 Lens-to-sensor geometry
+
+\`\`\`
+focal.breadth ∝ k₁ / f
+\`\`\`
+
+Where:
+- `k₁` = `sensor_size` = physical diagonal of the camera sensor
+- `f` = `focal_length` = optical focal length of the lens
+
+> Shorter focal lengths → **wider breadth**
+> Longer focal lengths → **narrower breadth**
+
+---
+
+## key behaviors
+
+| Adjustment             | Effect on focal.breadth         |
+|------------------------|----------------------------------|
+| Decrease focal length  | expands breadth (wide angle)     |
+| Increase focal length  | narrows breadth (telephoto)      |
+| Crop sensor vs full-frame | reduces breadth (less of scene) |
+
+---
+
+## creative usage
+
+- **Wide focal.breadth** (e.g. 24mm):
+  - Landscape, architecture, immersive scenes
+  - Emphasizes environment over subject
+
+- **Narrow focal.breadth** (e.g. 85mm+):
+  - Portraits, wildlife, compressed compositions
+  - Emphasizes subject, de-emphasizes context
+
+---
+
+## limitations
+
+- Very wide breadths may introduce distortion at frame edges
+- Very narrow breadths reduce spatial awareness and require greater stability
+- Breadth must be balanced with focal.acuity and focal.depth to maintain clarity across the frame
+
+---
+
+## metaphorical phrasing
+
+> **focal.breadth** is your **window onto the world**
+> It defines *how wide the camera can see* — the lateral span of your visual attention.

package/dist/roles/thinker/briefs/physics/optics.focal.depth.md

@@ -0,0 +1,77 @@
+# .brief: focal.depth
+
+## what
+
+**focal.depth** refers to the **range of object distances** in front of and behind the focal plane that appear **acceptably sharp**. It defines the "thickness" of the focus zone surrounding the point of perfect sharpness.
+
+---
+
+## why
+
+While **focal.acuity** describes *how sharply* the focal plane is rendered, **focal.depth** describes *how far that sharpness extends*. It's critical for:
+
+- Keeping entire subjects or scenes acceptably in focus
+- Managing viewer attention and spatial context
+- Balancing artistic isolation with technical clarity
+
+---
+
+## governed by
+
+### 📐 Depth of field (approximate)
+
+```\`\`
+focal.depth ≈ (2 * N * c * focal.distance²) / f²
+\`\```
+
+where
+- `N` = aperture (f-number)
+- `c` = circle of confusion (maximum acceptable blur)
+- `focal.distance` = subject distance (from lens to focal plane)
+- `f` = focal length, a fn of `focal.breadth`
+
+simplified
+- assume `c = d = 2.44 * λ * N`, a diffraction-limited system
+- deref `f ∝ k₁ / focal.breadth`, by definition
+
+```\`\`
+focal.depth ∝ N² × focal.distance² × focal.breadth²
+\`\```
+
+---
+
+## key behaviors
+
+| Adjustment                   | Effect on focal.depth         |
+|------------------------------|-------------------------------|
+| Smaller aperture (↑ f-number)| increases it (more in focus)  |
+| Larger aperture (↓ f-number) | decreases it (shallower zone) |
+| Farther focus distance       | increases it nonlinearly      |
+| Closer focus distance        | decreases it rapidly          |
+
+---
+
+## creative usage
+
+- **Shallow focal.depth** (e.g. f/1.4):
+  - Isolates subject from background
+  - Ideal for portraits and cinematic shots
+
+- **Deep focal.depth** (e.g. f/16):
+  - Maintains clarity across space
+  - Used in landscapes, architecture, documentation
+
+---
+
+## limitations
+
+- Increasing focal.depth via smaller apertures introduces **diffraction**, reducing **focal.acuity**
+- Getting more depth often requires stepping farther away
+- Focal.depth depends on the lens, aperture, and subject distance — not just focus point
+
+---
+
+## metaphorical phrasing
+
+> **focal.depth** is the **breadth** of your clarity
+> It defines how far sharpness can **reach** across space, extending from the focal plane outward

package/dist/roles/thinker/briefs/physics/optics.focal.distance.md

@@ -0,0 +1,92 @@
+# .brief: focal.distance
+
+## what
+
+**focal.distance** refers to the **distance from the lens to the focal plane** — the exact location in space where the subject is brought into geometric focus.
+
+---
+
+## why
+
+While **focal.acuity** defines *how finely* the focal plane is rendered, and **focal.depth** defines *how far* sharpness extends around it, **focal.distance** defines *where* that clarity is placed in the scene.
+
+It controls:
+- Subject framing and spatial scale
+- The perceived compression of background and foreground
+- The sensitivity of focus and blur relationships in space
+
+---
+
+## governed by
+
+### 📐 Thin lens equation
+
+```\`\`
+1/f = 1/focal.distance + 1/image_distance
+\`\```
+
+This determines **where** the focal plane sits for a given lens.
+
+---
+
+### 🔧 How aperture interacts — via depth of field
+
+The **relationship between aperture and focal.distance** emerges through the depth of field equation:
+
+```\`\`
+focal.depth ≈ (2 * N * c * focal.distance²) / f²
+\`\```
+
+where
+- `N` = aperture (f-number)
+- `c` = circle of confusion (maximum acceptable blur)
+- `focal.distance` = subject distance (from lens to focal plane)
+- `f` = focal length, a fn of `focal.breadth`
+
+simplified
+- assume `c = d = 2.44 * λ * N`, a diffraction-limited system
+- deref `f ∝ k₁ / focal.breadth`, by definition
+
+```\`\`
+focal.depth ∝ N² × focal.distance² × focal.breadth²
+\`\```
+
+---
+
+## key behaviors
+
+| Adjustment               | Effect on focal.distance           |
+|--------------------------|------------------------------------|
+| Physically moving closer | decreases it                       |
+| Stepping farther back    | increases it                       |
+| Using wider aperture     | makes the system more sensitive to small changes in focal.distance |
+| Using smaller aperture   | tolerates more deviation from exact distance |
+
+---
+
+## creative usage
+
+- **Close focal.distance**:
+  - Emphasizes subject
+  - Increases blur and isolation
+  - Requires precision
+
+- **Far focal.distance**:
+  - Expands depth
+  - Stabilizes scene-wide focus
+  - Suits landscapes, architecture, and static subjects
+
+---
+
+## limitations
+
+- Very close distances drastically reduce focal.depth
+- Large apertures require extremely accurate focusing at short distances
+- Focal.distance interacts with both lens choice and aperture behavior
+
+---
+
+## metaphorical phrasing
+
+> **focal.distance** is your **placement of intent** — it marks where clarity lands.
+> The closer it lies, the tighter your tolerance must be; the farther it stretches, the more generous the depth becomes.

package/dist/roles/thinker/briefs/physics/optics.focal.tradeoffs.md

@@ -0,0 +1,107 @@
+# .brief: focal.tradeoffs
+
+## what
+
+**focal.tradeoffs** describe the physical constraint that links:
+
+- **focal.acuity** — the fineness of detail resolvable **at the focal plane**
+- **focal.breadth** — the angular or spatial extent of the field of view (FoV)
+- **focal.distance** — the distance **from the lens to the focal plane**
+- **focal.depth** — the range of distances **around the focal plane** that remain acceptably sharp
+
+These four factors are coupled by the geometry of light: changing one requires compensating adjustments to at least one of the others. The relationship models the inescapable tradeoffs in all optical focus systems.
+
+---
+
+## equation
+
+Assuming constant sensor size and fixed circle of confusion:
+
+\`\`\`ts
+// given
+focal.depth ∝ N² × focal.distance² × focal.breadth²
+focal.acuity ∝ 1 / N
+
+// then
+N ∝ 1 / focal.acuity
+focal.depth ∝ (1 / focal.acuity)² × focal.distance² × focal.breadth²
+focal.depth ∝ focal.distance² × focal.breadth² / focal.acuity²
+
+// therefore
+focal.acuity² × focal.depth ∝ focal.distance² × focal.breadth²
+\`\`\`
+
+---
+
+## key relationship
+
+\`\`\`
+focal.acuity² × focal.depth ∝ focal.distance² × focal.breadth²
+\`\`\`
+
+> You can only maximize two at a time — the other two must yield.
+
+---
+
+## variable meanings
+
+- **focal.acuity** — how finely your lens resolves detail at the point of focus
+- **focal.breadth** — how wide your frame sees (field of view)
+- **focal.depth** — how far the focus zone stretches through space
+- **focal.distance** — how close or far the focal plane is set
+
+---
+
+## tradeoff matrix
+
+| Want to increase…     | Compensate by…                                   |
+|------------------------|--------------------------------------------------|
+| **focal.acuity** ↑     | decrease depth ↓, step back ↑, narrow breadth ↓ |
+| **focal.breadth** ↑    | reduce acuity ↓, step back ↑, flatten depth ↓   |
+| **focal.depth** ↑      | reduce acuity ↓, step back ↑, compress breadth ↓|
+| **focal.distance** ↓   | reduce depth ↓, increase acuity ↑, narrow breadth ↓ |
+
+---
+
+## verbal examples
+
+- want **finer details**? (focal.acuity++)
+- then, either
+  - step back (focal.distance++)
+  - collapse depth (focal.depth--)
+  - crop field of view (focal.breadth--)
+
+- want a **wider scene**? (focal.breadth++)
+- then, either
+  - reduce acuity (focal.acuity--)
+  - step back (focal.distance++)
+  - tolerate shallow depth (focal.depth--)
+
+- want **deeper focus**? (focal.depth++)
+- then, either
+  - reduce acuity (focal.acuity--)
+  - step back (focal.distance++)
+  - narrow scene (focal.breadth--)
+
+- want to get **closer**? (focal.distance--)
+- then, either
+  - reduce depth (focal.depth--)
+  - increase sharpness (focal.acuity++)
+  - narrow scene (focal.breadth--)
+
+---
+
+## best practice zone
+
+For full-frame photography:
+
+- Aperture: f/5.6 to f/8
+- Distance: 2–5 meters
+- Focal length: 35mm–85mm (moderate breadth)
+
+This keeps the optical balance manageable:
+
+- **focal.acuity**: avoids diffraction or aberration
+- **focal.breadth**: flexible for framing
+- **focal.depth**: useful for subject layering
+- **focal.distance**: compositional stability

package/dist/roles/thinker/briefs/style.words.lowercase.md

@@ -0,0 +1,36 @@
+.tactic = words:lowercase
+
+.what = enforce lowercase for all words unless capitalization is required by code or naming convention
+.where:
+  - applies to comments, docstrings, markdown, logs, and prompt copy
+  - only exceptions are code constructs (e.g., class names) and proper nouns (e.g., OpenAI)
+
+.why:
+  - keeps language neutral, minimal, and machine-aligned
+  - prevents inconsistent or performative emphasis via caps
+  - improves scanability and reduces visual noise across surfaces
+
+.how:
+  .rules:
+    - do not capitalize the first word of a sentence
+    - only use capitalization when:
+      - referencing a class, type, or constant (e.g., `StitchStepImagine`, `GitRepo`)
+      - writing a proper noun or brand (e.g., OpenAI, GitHub, AWS)
+    - never capitalize:
+      - generic nouns (`customer`, `invoice`, `step`)
+      - verbs (`set`, `get`, `submit`, `handle`)
+      - system comments or instructions, even at the beginning of a line
+
+  .examples:
+    .positive:
+      - `// returns a new invoice if customer exists`
+      - `// handled in gitrepo.init()`
+      - `// fallback if no customer was found`
+      - `// pass into StitchStepImagine to generate`
+      - `// openai prompt requires flattened string`
+    .negative:
+      - `// Returns a new invoice`       // ⛔ capitalized sentence start
+      - `// This is handled in GitRepo`  // ⛔ capitalized sentence + verb
+      - `// Submit the job for approval` // ⛔ capitalized imperative
+      - `// Customer must exist first`   // ⛔ capitalized domain noun
+      - `// GitHub Repository`           // ⛔ capitalized generic noun

package/dist/roles/thinker/briefs/tactician/tactics.compose.traits_and_skills.[article].md

@@ -0,0 +1,76 @@
+# 🧩 .brief.article: `tactics as compositions of traits and skills`
+
+## 💡 concept
+**tactics** are not a strict hierarchy but a **composition** of **traits** and **skills**.
+- **traits** = dispositions (orientations of thought, energy, and behavior).
+- **skills** = capabilities (trainable abilities applied in practice).
+a tactic emerges when a specific **combination** of traits and skills is aligned toward an outcome.
+
+---
+
+## 🎯 why composition matters
+- traits and skills are **independent**: curiosity and precision can both shape chemistry, but in different ways.
+- tactics are **composable**: the same skill can express differently depending on which trait anchors it.
+- outcomes **shift** when traits or skills are dialed up, down, or swapped.
+
+---
+
+## 📚 examples by domain
+
+### 🧪 science
+**curious chemist**
+- **trait**: curiosity
+- **skill**: chemistry analysis
+- **tactic**: exploratory experimentation, testing boundaries, embracing unknowns.
+- **outcome**: discovery of novel reactions, unexpected insights.
+
+**precise chemist**
+- **trait**: precision
+- **skill**: chemistry analysis
+- **tactic**: rigorous measurement, narrow tolerances, strict replication.
+- **outcome**: reliable results, industry-grade reproducibility.
+
+---
+
+### 🪚 craft
+**adaptive carpenter**
+- **trait**: creativity
+- **skill**: carpentry
+- **tactic**: improvises with available materials, adapts joinery to context.
+- **outcome**: unique custom pieces, practical fixes in resource-limited settings.
+
+**disciplined carpenter**
+- **trait**: discipline
+- **skill**: carpentry
+- **tactic**: follows measured plans precisely, applies standardized methods.
+- **outcome**: consistent, repeatable, structurally sound products.
+
+---
+
+### 🤝 negotiation
+**empathetic negotiator**
+- **trait**: empathy
+- **skill**: negotiation
+- **tactic**: listens deeply, frames deals around shared needs.
+- **outcome**: durable agreements, long-term trust.
+
+**strategic negotiator**
+- **trait**: foresight
+- **skill**: negotiation
+- **tactic**: maps long-term consequences, anticipates concessions and pivots.
+- **outcome**: advantage in complex deals, positioning for future leverage.
+
+---
+
+## ⚖️ composability
+- one **skill** can pair with multiple **traits** → different tactics, different outcomes.
+- one **trait** can pair with multiple **skills** → different expressions of the same disposition.
+- **tactics** emerge from the active **pairing**, not from traits or skills alone.
+
+---
+
+## 📌 takeaway
+tactics are **compositions**, not hierarchies:
+- **traits** provide orientation.
+- **skills** provide capability.
+- tactics combine them to yield different **outcomes**, which can shift as traits are dialed differently in different contexts.

package/dist/roles/thinker/briefs/tactician/trait.articulation.[article].md

@@ -0,0 +1,67 @@
+# 🧩 .brief.article: `pattern of trait articulation`
+
+## 💡 concept
+a **trait articulation** describes how a personal or systemic trait manifests across three distinct modes:
+- **boon** = benefit mode, the gift of the trait when expressed well.
+- **bane** = detriment mode, the distortion of the trait when taken too far.
+- **balance** = integrative mode, the steady form that holds the gift without falling into the trap.
+
+this pattern ensures traits are understood not as static labels, but as dynamic forces with both potential and peril.
+
+---
+
+## 🎯 purpose
+- create richer portraits of traits than single definitions allow.
+- highlight both the **value** and the **risk** of a trait.
+- emphasize the need for **balance** as the mature expression of any trait.
+- provide a structure that can apply across domains: personality, craft, leadership, learning, etc.
+
+---
+
+## 🔍 structure of articulation
+
+### 1. .trait.boon
+- **essence**: what the trait gives when it operates in healthy form.
+- **benefits**: strengths, gifts, and opportunities.
+- **behaviors**: observable actions that express the boon.
+
+### 2. .trait.bane
+- **essence**: what the trait becomes when it overextends.
+- **risks**: distortions, traps, or excesses.
+- **symptoms**: signals that the trait has shifted into bane.
+
+### 3. .trait.balance
+- **essence**: how the trait can be integrated with discernment.
+- **stance**: principles that prevent overreach.
+- **behaviors**: practices that preserve clarity and prevent distortion.
+
+---
+
+## 📚 examples
+
+### 1. curiosity
+- **boon**: discovery, insight, growth.
+- **bane**: distraction, endless novelty, shallow wandering.
+- **balance**: guided exploration aligned with purpose.
+
+---
+
+### 2. discipline
+- **boon**: consistency, reliability, mastery through practice.
+- **bane**: rigidity, joyless routine, resistance to change.
+- **balance**: disciplined flow that adapts structure to context.
+
+---
+
+### 3. empathy
+- **boon**: connection, trust, understanding others’ needs.
+- **bane**: over-identification, blurred boundaries, emotional exhaustion.
+- **balance**: compassionate presence with clear self-boundaries.
+
+---
+
+## 📌 takeaway
+the **pattern of trait articulation** reframes traits as **dynamic spectra** rather than fixed qualities.
+every trait has a **boon** that gifts, a **bane** that distorts, and a **balance** that integrates.
+
+this triadic articulation turns traits into **living tools** for reflection, growth, and design.

package/dist/roles/thinker/briefs/tactician/trait.purpose.[article].md

@@ -0,0 +1,56 @@
+# 🧩 .brief.article: `purpose of traits`
+
+## 💡 concept
+**traits** are recurring modes of thought, behavior, or expression that shape how an individual, team, or system engages with the world. they are not fixed states but **patterns of disposition** that influence choices, interactions, and outcomes.
+
+---
+
+## 🎯 purposes of traits
+
+### 1. orientation
+traits orient how energy, attention, and action flow.
+- curiosity points attention outward.
+- discipline channels energy inward.
+- empathy directs focus toward others.
+
+---
+
+### 2. prediction
+traits allow us to anticipate likely patterns of behavior.
+- a disciplined person can be relied on to complete commitments.
+- an empathetic leader is expected to notice unspoken needs.
+
+---
+
+### 3. reflection
+traits act as mirrors for growth. they reveal both:
+- **boon** = the gift we bring when the trait is expressed well.
+- **bane** = the trap we fall into when it overextends.
+- **balance** = the integration that matures the trait.
+
+---
+
+### 4. articulation
+traits provide a shared vocabulary for describing tendencies.
+- instead of vague impressions, we can say: *“this person’s empathy is in bane mode.”*
+- traits let us discuss strengths and distortions with precision.
+
+---
+
+### 5. design
+traits give structure for intentional cultivation.
+- they can be trained, reinforced, or balanced.
+- teams can be designed to complement each other’s trait profiles.
+- systems can be engineered to amplify boon and dampen bane.
+
+---
+
+## 📌 takeaway
+the **purpose of traits** is not to label people, but to **map dispositions**:
+- to orient energy and focus,
+- to predict patterns of behavior,
+- to reflect on growth,
+- to articulate tendencies with precision,
+- and to design individuals and systems toward balanced expression.
+
+in this way, traits function as **living lenses** for understanding and shaping both self and collective.