From 89fdfd461bccd9a9f00644748771517db569ee00 Mon Sep 17 00:00:00 2001 From: Jake Date: Mon, 27 Apr 2026 19:24:35 +0100 Subject: [PATCH] docs(brief): add reticular activating system appendix The RAS is the brainstem network gating which sensory inputs reach conscious cortical attention, modulated top-down by prefrontal goals. RAS dysfunction is documented in ADHD, autism spectrum, and the wider neurodivergent population that is Corbie's beachhead audience. The appendix maps three RAS failure modes to existing Corbie features: - Temporal salience gating failure -> time blindness -> visual countdown timers, progress rings. - Arousal escalation failure -> task-initiation freeze -> AI micro-steps, just-start timer. - Suppression failure -> sensory over-distraction -> WIP limits, reduce-motion defaults, anticipatory nudges. Plus the personalisation grant connection: continual on-device adaptation to user idiolect reduces load on a compromised attention gate, which is the core value to neurodivergent users beyond raw accuracy improvement. Companion CORBEL-Main agent-side doctrine at stonework/rules/agent-ras-protocol.md frames the same mechanism for Wren's own context-economy discipline. --- .../appendix-reticular-activating-system.md | 80 +++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 docs/brief/appendix-reticular-activating-system.md diff --git a/docs/brief/appendix-reticular-activating-system.md b/docs/brief/appendix-reticular-activating-system.md new file mode 100644 index 0000000..7d396d0 --- /dev/null +++ b/docs/brief/appendix-reticular-activating-system.md @@ -0,0 +1,80 @@ +--- +name: "Appendix: Reticular Activating System (RAS)" +description: "Neuroscience underpinning Corbie's attention-management design. RAS dysfunction in ADHD and autism explains why time blindness, task-initiation freezes, and sensory over-distraction occur — and grounds the design choices that target them." +type: research +tags: [corbie, neuroscience, ras, adhd, autism, attention, cognitive-ergonomics, design-rationale] +created: 2026/04/27 +related: + - docs/brief/appendix-cognitive-ergonomics.md + - docs/brief/appendix-ai-body-doubling.md + - docs/brief/appendix-implementation-intentions.md + - docs/brief/design-principles.md + - docs/brief/feature-set.md +--- + +# Appendix: Reticular Activating System + +## What it is + +The Reticular Activating System (RAS) is a diffuse network of neurons in the brainstem, spanning the midbrain, pons, and medulla, with ascending projections through the thalamus to the cortex. It is not a single anatomical structure — it is a functional system using acetylcholine, noradrenaline, dopamine, serotonin, histamine, and hypocretin to regulate two things in concert: **arousal** (sleep/wake/alert states) and **sensory gating** (which inputs from the spinal cord and cranial nerves reach conscious cortical attention). + +The RAS receives top-down modulation from the prefrontal cortex. Goals, intentions, and expectations shape which sensory inputs the RAS amplifies and which it suppresses. The system is bidirectional: cortex sets the relevance frame; RAS gates accordingly. + +## Why this matters for Corbie + +RAS dysfunction is documented in **ADHD, autism spectrum, schizophrenia, depression, PTSD, Parkinson's, Alzheimer's, and Huntington's**. For Corbie's beachhead audience — neurodivergent users with ADHD or autism — three RAS-linked phenomena directly motivate the product design. + +### 1. Time blindness ↔ poor temporal salience gating + +People with ADHD experience time as abstract and non-linear (Barkley's executive-function model; the time-agnosia literature). One mechanism: weakened prefrontal-RAS coupling means the gate doesn't escalate arousal in response to time-related cues. The clock ticks. Nothing salient passes. Tasks are not perceived as approaching their deadline until well past it. + +**Corbie's design response:** externalise time into the visual field where the gate cannot suppress it. Shrinking colour disks, filling progress rings, the just-start timer's prominent countdown — all bypass the broken temporal gate by making the passage of time a visible, non-suppressible signal. (See `docs/brief/feature-set.md` for visual time representation; `appendix-implementation-intentions.md` for the rhythmic-anchoring mechanism.) + +### 2. Task-initiation freeze ↔ insufficient arousal escalation for non-novel tasks + +Task initiation requires the RAS to escalate arousal sufficiently to overcome inertia. ADHD brains are documented as needing 2-3x more dopaminergic stimulation than neurotypical brains to clear this threshold (`docs/brief/market-size-demographics.md`). A boring familiar task does not trigger the gate; the user does not enter the alert state needed to start; the brain settles into freeze. + +**Corbie's design response:** the AI-generated micro-step ("pick up one shirt from the floor" rather than "tidy the room") provides novelty + specificity + low-friction action. This is engineered to clear the arousal threshold the RAS is failing to clear on its own. The just-start timer ("commit to 5 minutes") is a second mechanism — the boundary itself escalates arousal regardless of task novelty. + +### 3. Sensory over-distraction ↔ over-permissive gate + +Many ADHD and autistic users describe the opposite RAS failure: too many sensory inputs pass the gate. Background conversation, wall textures, ambient noise, screen notifications all reach attention with equal salience. The cortex is overwhelmed by inputs the RAS should have suppressed. + +**Corbie's design response:** WIP limits (the main screen mathematically restricts how many active tasks are visible — typically 3 maximum), reduce-motion defaults, progressive disclosure below 3 levels, literal labels always, no ambient marketing decoration. The product itself models a healthy gate by being one. Notification design follows the same logic: anticipatory guidance over scheduled push notifications, no aggressive haptics, context-aware suppression when the user is mid-flow. + +## Top-down modulation: implication for personalisation + +Because the RAS responds to cortex-level goals, **what counts as relevant is task-conditional**. A morning ritual cue that escalates one user's RAS at 09:00 may be invisible to them at 14:00 in a different cognitive state. This is the neurological basis for Corbie's **energy-aware task sequencing** feature (`feature-set.md`). The user tags their current energy state; the AI surfaces tasks calibrated to that state. The mechanism is: shifting the cortex's relevance frame so that what the RAS treats as salient matches the available cognitive resources. + +## The on-device personalisation grant connection + +The AI Champions Phase 1 application proposes continual on-device personalisation of Corbie's ASR and LLM pipeline. The RAS frame strengthens the case: **personalising voice AI for neurodivergent users is not just about idiolect accuracy, it is about restoring a functioning attention loop**. A model that understands the user's words on the first attempt removes the cognitive surcharge that drives users off the technology. A model that mis-hears them repeatedly *is* a sensory over-distraction event the user's already-compromised gate has to keep absorbing. + +The clinical literature establishes RAS dysfunction in the target population. The personalisation work is one mechanism for reducing the load on a broken gate. + +## Important caveat + +There is a popularised version of the RAS — common in self-help, goal-setting, and law-of-attraction contexts — that frames it as "the brain's filter that shows you what you focus on." The kernel is correct (top-down attention plus sensory gating produces priming effects) but the popular form overstates the mechanism into something close to manifestation theory. Corbie's research, brand, and external communications should use the precise neuroscience framing, not the pop-psychology one. The RAS does not "manifest" goals; it modulates which sensory inputs reach awareness based on cortex-set salience. + +## References + +Sources surveyed 2026/04/27. Refresh before any client-facing or grant-application use. + +- The Neuroscience School: *The Truth About Your Brain's Attention System: Why the RAS Myth Is Holding You Back* (2025/09/19) +- ScienceDirect Topics: *Reticular Activating System* (overview, neuroanatomy, neurotransmitter map) +- Trauma Research UK: RAS overview with clinical context +- Contemporary Psychology Australia: *Reticular Activating System: Intention in Attention* +- Neurosity: technical guide to the RAS in BCI context +- Qualia Life: *How The Brain Manages Energy With Selective Focus* + +## Implication summary for design + +| RAS function | Failure mode | Corbie design response | +|---|---|---| +| Temporal salience gating | Time blindness | Visual countdown timers, progress rings, externalised time | +| Arousal escalation | Task-initiation freeze | Specific micro-steps, just-start timer, novelty injection | +| Sensory suppression | Over-distraction | WIP limits, reduce-motion defaults, calm anticipatory nudges | +| Top-down goal coupling | State-mismatched activity | Energy-aware task sequencing, ritual transitions | +| Personalised relevance | Recurring misrecognition | On-device continual personalisation (grant-funded research substrate) | + +The RAS frame ties Corbie's apparently-disparate features into one coherent design thesis: **the product is a prosthesis for a compromised attention gate**. Every design decision either offloads work the broken gate cannot do, or reduces the load the broken gate has to carry.