# Real* Architecture & Implementation Plan

**Purpose:** Align the codebase and product with the Real* platform taxonomy (RealFlow, RealFuel, RealFeel, RealExpression, RealAction), Instruction² Composer, and LLM-as-Cortex so THRPY **consumes** (not contains) licensable primitives.  
**Last Modified:** 2026-02-09  
**Status:** Plan — use for naming, components, and phased implementation.  
**Product positioning:** THRPY is voice- and visual-first; text is always available as fallback. See [VOICE_FIRST_AND_MODALITY_ROADMAP.md](VOICE_FIRST_AND_MODALITY_ROADMAP.md).  
**Related:** [realflow/](realflow/), [realfuel/](realfuel/), [THRPY_PROTO_SOURCE_OF_TRUTH.md](THRPY_PROTO_SOURCE_OF_TRUTH.md).

**Reuse principle:** Reuse most or all of what exists in this plan and in the repo. Where formulas, solutions, architecture patterns, or extensions exist in **sibling projects** (THRPY_PROTO repo or in-repo sibling folders), **copy or port** from them rather than reimplementing. See §9 Reuse and sibling sources and §10 Architecture extensions.

**Feature inventory (before implementation):** See [FEATURE_INVENTORY_BEFORE_IMPLEMENTATION.md](FEATURE_INVENTORY_BEFORE_IMPLEMENTATION.md) for what is **implemented & functional**, **available but not implemented as named**, **planned pure new**, and **implemented but misaligned** (e.g. epiphany vs Latent Convergence). Use it to avoid duplicating and to know what to extract vs add.

---

## 1. Canonical One-Line Definitions (use everywhere)

| Term | Definition |
|------|-------------|
| **RealFlow** | A continuous bidirectional real-time intelligence loop. |
| **RealFuel** | Live signal injection into a running real-time system. |
| **RealFeel** | Affective state engine (continuous, numeric, latent; non-linguistic, non-performative). |
| **RealExpression** | Affective modulation of real-time AI expression (how to say it). |
| **RealAction** | Real-time behavioural controller (what to do: interrupt, escalate, pause, route). |
| **RealUI Control** | Bidirectional interface layer: how the experience adapts and is navigated; user–system co-regulation in real time (overrides, consent-based guidance, safety-first controls). |
| **Instruction² Composer** | Cognition & governance layer: rules, state interpretation, mode selection, instruction compilation. Configures Real* layers; does not stream, speak, or touch signal directly. |
| **LLM (Cortex)** | Bursty cognition injector; returns candidate intent + content into RealFlow; Action + Expression turn it into final output. |

---

## 2. The Loop (mental model)

```
RealFuel  →  RealFlow  →  RealFeel
                ↓
         RealExpression  →  Output
         RealAction      →  (what may do)
         RealUI Control  →  (how experience adapts)
                ↑
          User / Composer
```

- **RealFuel** injects signal (user speech, sensors, memory, events).
- **RealFlow** maintains time, ordering, sync, state propagation.
- **RealFeel** tracks affective state (VAD, stress, confidence, etc.).
- **RealExpression** modulates output (tone, speed, prosody, phrasing).
- **RealAction** governs behaviour (interrupt, escalate, pause, route).
- **RealUI Control** governs how the experience adapts and is navigated (bidirectional: user overrides + consent-based system guidance). Parallel to Expression and Action; driven by RealFlow, governed by Instruction², interruptible by the user.

**LLM placement:** RealFlow → LLM Node → RealFlow (candidate packet). Then RealAction (decide) → RealExpression (shape) → Output (stream).  
**Instruction²** sits above: when to call LLM, which model, which schema, constraints, forbidden/required.

**End of turn:** Commit → RealMemoryDecay/compaction (inside RealFlow) → ContextPack for next turn.

---

## 3. Current Codebase vs Target

### 3.1 RealFlow (temporal spine)

| Current | Location | Target / Notes |
|---------|----------|----------------|
| RealFlow streaming service | `chat-api/app/realflow_streaming_service.py` | Keep; ensure it **only** owns time, ordering, sync, state. No “what to feel/say”. |
| RealFlow turn context | `RealFlowTurnContext` in same file | Align with TurnCommit → MemoryWeave → MemoryDecay → ContextPack stages. |
| Turn phases | `docs/09_reference/realflow/TURN_PHASES.md` | Already Ingest → Transcribe → Inference → Governance → Compose → Generate → Persist. Map Persist to TurnCommit + MemoryDecay. |
| Frontend: RealFlowChat, useRealFlow, useRealFlowChat | `RealFlowChat.tsx`, `useRealFlowChat.ts`, etc. | Naming already aligned; ensure UI speaks “RealFlow” only for pipeline/spine, not for Fuel/Feel/Expression. |

**RealFlow detectors (governing rule):** RealFlow may host **flow-native observers** that observe the stream and emit **neutral signals** consumable by any Real* product. Detectors must be shared, stateless or lightly stateful, non-clinical, non-opinionated, non-decisional. RealFlow may *notice*; it must never *interpret* or *judge*. See [realflow/REALFLOW_DETECTORS_BOUNDARY.md](realflow/REALFLOW_DETECTORS_BOUNDARY.md).

### 3.2 RealFuel (injection + domain analytics)

| Current | Location | Target / Notes |
|---------|----------|----------------|
| RealFuel pipeline | `chat-api/app/services/realfuel.py`, rflow_* (text, audio, vad, emotion_distribution, base, emc2) | Already defined in [REALFUEL_PIPELINE_DEFINITION.md](realfuel/REALFUEL_PIPELINE_DEFINITION.md). RealFlow **calls** RealFuel; no reverse dependency. |
| Naming | [REALFUEL_NAMING_CONVENTION.md](realfuel/REALFUEL_NAMING_CONVENTION.md) | Components full (RealFuelAnalyser); Rfa* inside only. Apply consistently. |
| Wellness / mental health analysis | Currently "wellness" in parallel inference | **Domain analyzers**, not flow detectors. Live in **RealFuel Analytics** (e.g. RealFuel Wellness Analyzer). They fuse flow-native signals (e.g. speech rate, interruptions) with lexical/history and output stress, cognitive load, agitation trend → feed RealFeel and Instruction². RealFlow detectors emit only neutral events; RealFuel interprets relevance. |

### 3.3 RealFeel (affective state — new compartment)

| Current | Location | Target / Notes |
|---------|----------|----------------|
| VAD / emotion as “inference” | RealFuel outputs VAD, emotion_distribution | **RealFeel** = consumer of RealFuel outputs + any other affective signals. Owns “current affective state” (vectorised, continuous). No speech, no actions. |
| RealFlowTurnContext.vocal_inference, text_inference | `realflow_streaming_service.py` | Treat as **inputs to RealFeel**. RealFeel layer aggregates → single “affective state” snapshot per tick/turn. |
| New module | TBD e.g. `chat-api/app/services/real_feel_engine.py` or `realfeel/` | RealFeelEngine: inputs = VAD, confidence, optional stress/load; output = RealFeelState (numeric, latent). Used by Instruction² and RealExpression. |

### 3.4 RealExpression (modulation — new compartment)

| Current | Location | Target / Notes |
|---------|----------|----------------|
| synthesis_guidance | `RealFlowTurnContext.synthesis_guidance` | Move under **RealExpression**: tone, speed, prosody, phrase softness, hesitation. RealExpression takes RealFeelState + context → synthesis_guidance. |
| TTS params / voice shaping | gemini_tts_client, supertonic, etc. | RealExpression **outputs** parameters that drive TTS (pitch, rate, energy). Same intent, different delivery. |
| New module | TBD e.g. `real_expression.py` or `realexpression/` | RealExpressionEngine: inputs = RealFeelState, mode, safety; output = expression params (and/or text-style hints for text-only). |

### 3.5 RealAction (behaviour — new compartment)

| Current | Location | Target / Notes |
|---------|----------|----------------|
| Safety gate, crisis, escalate | safety_client, governance in RealFlow | **RealAction** owns: interrupt, pause, escalate, route, trigger audit, end session. Policy-bound, auditable. |
| “Governance” in turn phases | TURN_PHASES.md, realflow_streaming_service | Rename conceptually to **RealAction** (decide) + Instruction² (constraints). RealAction executes; Instruction² configures. |
| New module | TBD e.g. `real_action.py` or `realaction/` | RealActionEngine: inputs = safety_assessment, rules, mode; output = action decision (allow/block/escalate/delay). RealFlow calls it before committing output. |

### 3.6 Instruction² Composer (cognition & governance)

| Current | Location | Target / Notes |
|---------|----------|----------------|
| InstructionComposer, compose_with_context | `instructions2/composer.py`, used in realflow_streaming_service | This **is** the Instruction² Composer. Clarify: it compiles rules + mode → system prompt + constraints; it does **not** stream or speak. |
| Rule engine / mode selector | Partially in instructions2, config | Formalise: Rule Engine, State Interpreter, Mode Selector, Instruction² Compiler as sub-components of Composer (docs + optional refactor). |
| Latent Convergence Engine | Between MMRY/KEG and Composer | Pre-insight surfacing: pattern convergence → hypotheses (latent_convergence signals). Composer decides whether to surface; never "epiphany detection." See [core/LATENT_CONVERGENCE_ENGINE.md](core/LATENT_CONVERGENCE_ENGINE.md). |
| THRPY | Product | “THRPY = RealFlow + licensed RealFuel + RealFeel profiles + domain policy.” Composer is THRPY’s orchestration layer. |

### 3.7 LLM (Cortex)

| Current | Location | Target / Notes |
|---------|----------|----------------|
| LLM call inside RealFlow | realflow_streaming_service, simple_chat | Keep LLM as **side branch**: RealFlow sends request packet → LLM returns **candidate** (draft text, intent, risk_flags, tool_requests). RealAction + RealExpression then gate and shape final output. |
| Naming | — | Optional: introduce **CortexNode** or **RealCortex** as the LLM interface name in docs/code for clarity. |

### 3.8 RealMemoryDecay / Commit pipeline

| Current | Location | Target / Notes |
|---------|----------|----------------|
| Memory decay / importance | `chat_service._apply_memory_decay_filtering`, memory_importance_service | Move **conceptually** under RealFlow as “Commit Pipeline”: TurnCommit → MemoryWeave → **MemoryDecay** (apply decay + compaction) → **ContextPack** (assemble next-turn context). |
| Context packing for LLM | simple_chat, realflow build_context | ContextPack = the “fuel-air mix” for next cognition burst (pinned facts, session goals, recent window, decayed memory summaries, RealFeel trajectory, safety state). |
| THRPY_PROTO | `THRPY_PROTO_SOURCE_OF_TRUTH.md` | Memory decay and context budgeting in PROTO; port/align with RealMemoryDecay and ContextPack stages. **Reuse:** See §9 for PROTO and in-repo sibling sources (e.g. `app/mmry/` in PROTO or `clinical-interaction-engine_memory-decay/app/mmry/`). |

### 3.9 RealUI Control (bidirectional interface layer)

| Current | Location | Target / Notes |
|---------|----------|----------------|
| Frontend controls (pause, stop, theme, guided meditation) | UI components, RealFlowChat, guided flows | **RealUI Control**: User→System = authoritative (go straight into RealFlow, override expression, may trigger RealAction). System→User = consent-based only (highlights, focus cues, gentle prompts; no auto-open, no forced navigation). See [realui/REALUI_CONTROL.md](realui/REALUI_CONTROL.md). |
| Emergency / force-stop | Safety, crisis flows | Emergency triggers RealAction HALT → propagates to RealUI Control → audio stop, animation freeze, high-contrast safe state, clear exit. Hard-stop dominance. |
| Insight drawer / emotional UI surfacing | Drawer, highlights | Composer emits UI Suggestion Event only when allowed; RealUI Control highlights and requests consent; user decides before deeper content opens. |

---

## 4. Naming Conventions Summary

- **RealFlow:** [REALFLOW_NAMING_CONVENTION.md](realflow/REALFLOW_NAMING_CONVENTION.md) — pipelines and components full (RealFlowChat, RealFlowVibeGauge); Rfs/Rfw/Rf inside only.
- **RealFuel:** [REALFUEL_NAMING_CONVENTION.md](realfuel/REALFUEL_NAMING_CONVENTION.md) — RealFuel* components full; Rfa* inside only.
- **RealFeel / RealExpression / RealAction / RealUI Control:** Use same rule: **component and module names fully spelled out** (RealFeelEngine, RealExpressionEngine, RealActionEngine, RealUIControl). Short prefixes only **inside** each module if desired.

---

## 5. Frontend Components (existing → alignment)

| Component | Current | Alignment |
|-----------|---------|-----------|
| RealFlowChat | Page / pipeline UI | Keep; represents “RealFlow” pipeline to user. |
| RealFlowVibeGauge | VAD / emotion display | Shows **RealFeel**-derived state (from RealFuel → RealFeel). Optionally label in UI as “Affective state” or keep “RealFlow” for brand. |
| VoiceInputRealFlow | Voice input for RealFlow | Keep; part of RealFlow surface. |
| RealFlowOrb | Audio visualisation | Keep; RealFlow pipeline UI. |
| RealFlowSessionTimeline, RealFlowGuidedExperience | Timeline, guided | Keep; full names per naming convention. |
| useRealFlow, useRealFlowChat, useRealFlowHttpChat | Hooks | Keep; entry points to RealFlow. |

No need to rename existing “RealFlow” UI to “RealFeel” or “RealExpression”; keep RealFlow as the **product surface**. New UI that explicitly shows “affective state” vs “expression controls” can use RealFeel/RealExpression in docs and optional labels.

---

## 6. Phased Implementation Plan

### Phase 1: Docs and naming (no code moves)

- [ ] **Reuse audit:** Identify and document reuse from **THRPY_PROTO** (memory decay, context budgeting, confidence/prediction engines) and **in-repo siblings** (see §9). Copy formulas and patterns rather than reimplementing; add to this plan or to realflow/REALMEMORYDECAY_COMMIT_PIPELINE.md where applicable.
- [ ] Add **RealFeel**, **RealExpression**, **RealAction** one-pagers under `docs/09_reference/` (e.g. `realfeel/README.md`, `realexpression/README.md`, `realaction/README.md`) with definitions and boundaries.
- [ ] Update [realflow/TURN_PHASES.md](realflow/TURN_PHASES.md) to reference TurnCommit → MemoryWeave → MemoryDecay → ContextPack.
- [ ] Document Instruction² Composer as “cognition & governance layer” and LLM as “Cortex” in [REALFLOW_STREAMING_SERVICE.md](realflow/REALFLOW_STREAMING_SERVICE.md) and this plan.
- [ ] Audit existing RealFlow/RealFuel file and export names against naming conventions; fix any abbreviations in **public** names.
- [ ] Enforce **RealFlow detector boundary**: any component in RealFlow that emits clinical/wellness/risk *meaning* must be treated as a **RealFuel Analytics** (domain) component, not a flow-native detector. Flow detectors emit only neutral signals (see [realflow/REALFLOW_DETECTORS_BOUNDARY.md](realflow/REALFLOW_DETECTORS_BOUNDARY.md)).

### Phase 2: RealFeel and RealExpression (thin layers)

- [ ] Introduce **RealFeel** aggregation: input = RealFuel outputs (VAD, emotion_distribution, confidence) + optional extra; output = RealFeelState (e.g. dict or dataclass). Consumed by Composer and RealExpression.
- [ ] Introduce **RealExpression**: input = RealFeelState + mode/context; output = synthesis_guidance (and/or text-style params). RealFlow continues to call existing TTS with these params.
- [ ] Keep existing `synthesis_guidance` in `RealFlowTurnContext`; populate it from RealExpression in the pipeline.

### Phase 3: RealAction (explicit behaviour layer)

- [ ] Introduce **RealAction** module: input = safety_assessment, rules, mode; output = action decision (allow / block / escalate / delay / etc.). RealFlow calls RealAction before committing output.
- [ ] Move “governance” decision logic (crisis divert, block, escalate) into RealAction where possible; Instruction² remains the source of rules and constraints.

### Phase 4: Commit pipeline and MemoryDecay

- [ ] Formalise in RealFlow: after “output” is finalised, run **TurnCommit** (record output + actions + metrics), **MemoryWeave** (write to MMRY/KEG), **MemoryDecay** (apply decay + compaction rules), **ContextPack** (assemble next-turn context).
- [ ] Align `_apply_memory_decay_filtering` and context building with ContextPack; ensure LLM receives only the governed context packet.
- [ ] Align with THRPY_PROTO memory decay and context budgeting where applicable. **Reuse:** Port or adapt formulas and stages from THRPY_PROTO `app/mmry/` (memory_decay, memory_budget, mmry_context) and/or from `clinical-interaction-engine_memory-decay/app/mmry/` (memory_decay.js, memory_budget.js, mmry_context.js, keg_store.js) so one canonical approach is used.

### Phase 5: Licensing and IP boundaries

- [ ] Ensure clear separation: RealFlow stack = platform; Instruction² + THRPY-specific rules = product. Document what can be licensed (RealFlow alone, RealFeel alone, RealFuel adapters, “clinical real-time stack”).
- [ ] **Patent claim spine** (use for claim drafting; see [IP_EVALUATION_ARCHITECTURE_AND_CLAIMS.md](IP_EVALUATION_ARCHITECTURE_AND_CLAIMS.md) §7): (1) Real-time loop; (2) Injection vs modulation (RealFuel inject, RealExpression modulate); (3) Affective state as control signal (RealFeel); (4) Expression as measurable layer (RealExpression); (5) Action as auditable behaviour layer (RealAction); (6) Composer as governance (Instruction²); (7) **RealUI Control** — bidirectional UI co-regulation, user override dominance, consent-based system guidance, emergency propagation to hard-stop; (8) **Pre-insight surfacing (Latent Convergence)** — pattern convergence across time/modality/memory → hypotheses (no epiphany or truth claim); Composer gates surfacing; (9) **RealMemoryDecay** — deterministic memory decay and context compaction within the loop (TurnCommit → MemoryWeave → MemoryDecay → ContextPack).

---

## 7. Where THRPY Fits

- **THRPY** = product. **Real*** = platform.
- THRPY **orchestrates**: RealFlow + licensed RealFuel + RealFeel profiles + RealExpression profiles + RealAction policies + RealUI Control (co-regulation) + Instruction² Composer (rules, mode, compilation).
- One-line: *“THRPY is a governed cognitive orchestration layer operating over a real-time intelligence platform.”*

---

- **UI co-regulation one-liner:** *"THRPY includes real-time UI co-regulation — users and the system can shape the experience together, with immediate overrides, consent-based guidance, and safety-first controls."*
- **Full stack (zoomed out):** RealFlow · RealFuel · RealFeel · Latent Convergence (engine) · Instruction² · RealExpression · RealAction · **RealUI Control**. A real-time co-regulated intelligence system, not just an app. (Pre-insight surfacing is named **Latent Convergence (engine)** in the stack; we do not use “RealInsight” to keep the Real* namespace for platform layers only.)

---

## 9. Reuse and sibling sources (reference only for now)

**Principle:** Reuse first when implementing. Where sibling projects (external repo or in-repo folders) already implement formulas, solutions, or architecture that map to Real*, **copy or port** from them into antigravity; do not reimplement from scratch. **You may copy from and reference siblings; do not change the source** — all edits stay in thrpy-antigravity. Sibling locations below are **reference only** until the plan explicitly calls for porting or reuse.

### 9.0 Sibling folder outside this project: THRPY VLT / VAULT

A **sibling folder** (or repo) **THRPY VLT** or **THRPY VAULT** may exist **outside** thrpy-antigravity — e.g. same parent directory (`../THRPY_VAULT`, `../THRPY_VLT`, or similar). It holds:

| Content | Use |
|--------|-----|
| **Secrets, keys** | API keys, env files, MASTER_KEYS — **ops only**; never committed. |
| **Legal / IP** | Legal docs, IP assignment, invention disclosures; reference for [docs/11_legal_regulatory](docs/11_legal_regulatory) and patent strategy. |

- **Role:** Ops and legal reference only. No app features; not part of the build.
- **Copy/reference only; do not change source** — read or copy from VLT/VAULT; do not edit files in the sibling.
- **In-repo vs outside:** This project may also contain in-repo `VAULT/` or `VLT/` (gitignored or not); the **external** sibling is the one outside the thrpy-antigravity repo. See [PRD §2.5](../10_product/PRD_BEST_OF_BREED_PHASED_ROLLOUT.md) (VAULT/, VLT/) and [IP hygiene report](../11_legal_regulatory/03_ip_hygiene/IP_HYGIENE_REPORT.md) (VAULT/Legal/IP).

### 9.1 THRPY_PROTO (sibling repository)

| Area | Location in PROTO | What to port / align |
|------|-------------------|------------------------|
| Memory decay & context budgeting | `app/mmry/` | Decay formulas, budget limits, context assembly. Align RealMemoryDecay and ContextPack with PROTO so one canonical approach is used. |
| Policy & protocols | `app/policy/` | Intervention patterns; port into Instruction² or RealAction where applicable. |
| Confidence engine | `app/state/confidence_engine.js` | State confidence logic; reference for RealFeel or Composer. |
| Prediction engine | `app/state/prediction_engine.js` | Prediction patterns; reference for Latent Convergence or recommendations. |

See [THRPY_PROTO_SOURCE_OF_TRUTH.md](THRPY_PROTO_SOURCE_OF_TRUTH.md). **Do not fork**; copy/port from PROTO into antigravity. **Do not change the source** (edit only in antigravity).

### 9.2 In-repo sibling folders (same workspace)

Copy from and reference only; do not change the source. When reusing, implement or adapt in antigravity (e.g. chat-api, realflow); do not edit the sibling folders.

| Folder | Role | Reuse for Real* |
|--------|------|------------------|
| **clinical-interaction-engine_memory-decay/** | Voice + memory decay (Node) | `app/mmry/` (memory_decay.js, memory_budget.js, mmry_context.js, keg_store.js) → RealMemoryDecay / ContextPack. `app/state/` (confidence_engine, prediction_engine), `app/ai/` (voice_state, stt/tts) → patterns for RealFlow voice and state. |
| **prod-webrtc-ai-voice/** | WebRTC voice (Node) | voice_state.js, STT/TTS flow, turn_store → reference for RealFlow WebSocket voice state and turn handling. |
| **_z_voicellm-chat/** | Standalone voice chat (Vite) | UI/UX patterns for voice chat; not same backend. |
| **gemini/**, **my-audio-orb/**, **audio-orb-main/** | Gemini integration, orb visuals | Enriched Live / Gemini Live; emotional orb in chat (Phase 2). |
| **1-clinical_system/** | Clinical specs & design (347 files) | Requirements and validation for Phase 3+; admin/clinical dashboards, NHS export, assessments. Use as **spec** only. |
| **deferred-services/** | Future microservices (audio, auth, chat, emotion, memory) | When splitting out: reuse service boundaries and APIs; plug in as optional layers. |
| **clinical-interaction-engine/** (+protocols, _gemini-mmry-keg) | Clinical interaction variants | Align with RealFlow + clinical-interaction-engine_memory-decay; Phase 3. |

**Component Reuse Matrix:** See [PRD_BEST_OF_BREED_PHASED_ROLLOUT.md](../10_product/PRD_BEST_OF_BREED_PHASED_ROLLOUT.md) §6 for capability → primary source → alternative by phase.

### 9.3 Formulas and solutions to reuse

- **Memory decay:** Use or adapt decay curves and budget logic from THRPY_PROTO `app/mmry/` or `clinical-interaction-engine_memory-decay/app/mmry/`; document in [realflow/REALMEMORYDECAY_COMMIT_PIPELINE.md](realflow/REALMEMORYDECAY_COMMIT_PIPELINE.md) so implementation matches one canonical formula.
- **ContextPack:** `pinned facts + session goals + recent window + decayed memory summaries + RealFeel trajectory + safety state` (already in §3.8 and REALMEMORYDECAY doc). Any context-budget or slot limits from PROTO/siblings should align with this contract.
- **Voice state / turn handling:** prod-webrtc-ai-voice and clinical-interaction-engine_memory-decay both have voice_state and turn semantics; unify with RealFlow turn context and WebSocket message types so one mental model holds.

---

## 10. Architecture extensions

These extend the core Real* plan without replacing it. Reuse existing sibling work where it fits.

| Extension | Source / doc | Notes |
|-----------|--------------|-------|
| **Sign language (designed-in)** | [VOICE_FIRST_AND_MODALITY_ROADMAP.md](VOICE_FIRST_AND_MODALITY_ROADMAP.md) | Sign as first-class modality: RealFuel (camera, gesture) → RealFeel (sign-aware) → RealExpression (sign output) → RealUI Control. Phase 2/3; not in initial phases. |
| **Deferred-services** | deferred-services/ | Optional plug-in when scaling or splitting; preserve Real* boundaries so services consume RealFlow/RealFuel/RealFeel contracts. |
| **Clinical real-time stack** | 1-clinical_system/, clinical-interaction-engine* | Phase 3+: admin views, NHS export, assessments; use 1-clinical_system as spec only. Align clinical-interaction-engine with RealFlow + memory-decay. |
| **Voice stack unification** | RealFlow WebSocket + Gemini Live; prod-webrtc-ai-voice; clinical-interaction-engine_memory-decay | Document canonical voice path (RealFlow primary); how siblings relate and when to use which. See PRD §8 Open Points. |

---

## 8. Related Docs

- [realflow/README.md](realflow/README.md) — RealFlow docs index.
- [realfuel/README.md](realfuel/README.md) — RealFuel docs index.
- [realfuel/REALFUEL_PIPELINE_DEFINITION.md](realfuel/REALFUEL_PIPELINE_DEFINITION.md) — RealFuel boundary and portability.
- [realfuel/REALFUEL_NAMING_CONVENTION.md](realfuel/REALFUEL_NAMING_CONVENTION.md) — RealFuel naming.
- [realflow/REALFLOW_NAMING_CONVENTION.md](realflow/REALFLOW_NAMING_CONVENTION.md) — RealFlow naming.
- [realflow/REALFLOW_STREAMING_SERVICE.md](realflow/REALFLOW_STREAMING_SERVICE.md) — Pipeline technical doc.
- [realflow/TURN_PHASES.md](realflow/TURN_PHASES.md) — Turn loop.
- [realflow/REALMEMORYDECAY_COMMIT_PIPELINE.md](realflow/REALMEMORYDECAY_COMMIT_PIPELINE.md) — RealMemoryDecay and Commit pipeline (TurnCommit → MemoryWeave → MemoryDecay → ContextPack).
- [THRPY_PROTO_SOURCE_OF_TRUTH.md](THRPY_PROTO_SOURCE_OF_TRUTH.md) — PROTO integration and memory decay.
- [core/LATENT_CONVERGENCE_ENGINE.md](core/LATENT_CONVERGENCE_ENGINE.md) — Pre-insight surfacing (latent convergence → hypotheses); not epiphany detection.
- [realui/REALUI_CONTROL.md](realui/REALUI_CONTROL.md) — Bidirectional UI co-regulation; User→System (overrides), System→User (consent-based guidance); emergency force-stop; tier mapping.
- [PRD_BEST_OF_BREED_PHASED_ROLLOUT.md](../10_product/PRD_BEST_OF_BREED_PHASED_ROLLOUT.md) — Component reuse matrix (§6), phased rollout, sibling folders and use-in-best-of-breed.
- [FEATURE_INVENTORY_BEFORE_IMPLEMENTATION.md](FEATURE_INVENTORY_BEFORE_IMPLEMENTATION.md) — Implemented & functional vs available-not-implemented vs planned pure new vs misaligned; use before implementation to reuse and align.