Skip to content

phillipclapham/raygun-os

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RAYGUN OS

The Mad Scientist Operating System

Right now, you're reading this. But are you choosing to engage, or are you captured by automatic patterns?

There's a difference. And that difference changes everything.


What Is This?

RAYGUN OS is the complete cognitive architecture for experiment-driven minds.

It's not a productivity system. It's permission to work how your brain actually functions.

Some people's brains run on fascination. When you're tinkering, experimenting, playing with ideas—that's when breakthroughs happen. Not despite the playfulness. BECAUSE of it. When you shift into "serious execution mode," you break your own cognitive architecture and everything gets harder.

This system is grounded in neuroscience, honest about what's proven vs. hypothesis, and built for people whose brains run on experiments.

The complete architecture in four parts:

  1. Understanding — The Gap, The Model, Why It Works (where choice lives and why frame selection works)
  2. Practicing — Core Operation, Two Pathways, Implementation, Troubleshooting (how to do it)
  3. Deepening — Advanced States, Self as Frame, Stage Progression, Applications (what emerges with practice)
  4. Meaning — The Paradox, The Frame War, Theoretical Foundations (why this matters)

What's New in v7.0? 🔬

The Coherence Update - Major restructure for coherence and teachability.

v7.0 (January 2026): The Coherence Update

The framework had grown organically and become fragmented—6 Parts plus orphan sections with ~17 technique teachings scattered across different locations. This restructure creates a coherent, teachable document:

  • Reorganized from 6 fragmented parts to 4 coherent parts organized by reader journey (Understanding → Practicing → Deepening → Meaning)
  • Introduced "The Felt Dimension" as organizing principle for practice—naming "mischief" as the specific felt quality powering mad scientist stance
  • Added Two Pathways model (cognitive vs felt) for frame selection—explains why "choose fascination" works for some and not others
  • Consolidated 17 scattered technique teachings into unified Practice section with clear structure
  • Eliminated all orphan sections (Energy States, Cold Start, Red Flags, Meta-Game, Harvest, Frame War, Active Inference now properly integrated)
  • Unified all troubleshooting content into single coherent section
  • Unified all advanced content into Stage Progression and Advanced Applications
  • Created clear reader progression with each part building on previous
  • Added Reference section with consolidated Evidence Confidence Levels and Cultural Touchstones link

~2730 lines. Leaner, more coherent. Same complete operating system, better organized.


Who Is This For?

  • Experiment-driven minds who think by tinkering
  • Builders who tinker naturally and feel guilty about it
  • Anyone grinding themselves to death who needs permission to work differently
  • Mad scientists who already know this but need the architecture

If you've ever felt like:

  • Work feels lighter when you're exploring vs. executing
  • "Fiddling around" leads to your best breakthroughs
  • Forcing productivity makes everything harder
  • You're most effective when fascinated, not disciplined

This is your operating system.


Quick Start

Read the full document:

Try it:

  1. Read the opening and architecture
  2. Pick ONE day in full mad scientist mode
  3. Notice what happens at the frame-selection point
  4. Track: Fascination? Results? Energy?
  5. Adjust based on evidence
  6. Keep experimenting

Research Backing

This model aligns with current neuroscience, cognitive psychology, and philosophy of mind. Framework is logically consistent and draws on established research areas.

Research Confidence Levels:

PROVEN (extensive empirical backing):

  • Perception-action loop with feedback
  • Attention-direction principle
  • Frame-selection point mechanics (meta-awareness + cognitive reappraisal)
  • Somatic anchors (classical conditioning, embodied cognition)

SUPPORTED (solid research direction):

  • Frame pragmatism (constructivist epistemology)
  • Belief as experimental variable (ACT research)
  • Dual state (decentering research)
  • Meta-perception training (executive function development)
  • Cognitive flexibility training (neuroplasticity research)
  • Environmental design (environmental psychology, social contagion)
  • Paradox metabolism (cognitive integration research)
  • Environmental triggers (attentional bias)
  • First principles thinking (critical thinking literature)

LOGICAL EXTENSION (inference from related research):

  • Fascination-driven selection
  • Decentering→creativity link
  • Halfway Hustle (combines proven concepts: committed action + adaptive awareness)

Mad scientist standard: PASSED ✓

Not claiming everything is conclusively proven. Claiming: we're not bullshitting, model is grounded, logical consistency is strong, evidence supports the direction.


Convergent Discovery

RAYGUN concepts weren't invented—they were systematized from patterns that masters across domains have been discovering for centuries.

When Bruce Lee, Miyamoto Musashi, Csikszentmihalyi, Keith Johnstone, Miles Davis, and others all point to similar truths from completely different starting points, it suggests these aren't one person's ideas. They're patterns reality keeps revealing.

Fellow Travelers - The convergence documented


What This Is NOT About

  • ❌ Productivity/optimization
  • ❌ Being "better" or more successful
  • ❌ Maximizing output
  • ❌ Self-improvement

What This IS About

  • ✅ Being ALIVE
  • ✅ Engaging with reality
  • ✅ Fascination and experimentation
  • ✅ Playing with the world as your laboratory

The number one prerogative of life should not be maximizing this or that.

It should be engaging with life as deeply as you can, in the way that best suits YOU.

Mad science is permission to do exactly that.


Links


Contributing

See CONTRIBUTING.md for guidelines.

Short version: Evidence-based contributions welcome. No productivity porn. Keep the mad scientist energy. PRs reviewed when energy allows.


License

This work is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).

You are free to:

  • Share - copy and redistribute in any medium or format
  • Adapt - remix, transform, and build upon the material for any purpose

Under these terms:

  • Attribution - You must give appropriate credit

Acknowledgments

Contributors

Vishal Dinesh PatelLinkedIn | GitHub

Vishal's observation about "curiosity with/without expectation" during framework feedback revealed a critical semantic gap. His insight directly led to the v5.0 Gap-First Reframe—repositioning the gap as THE foundation from which frame choices (including fascination) become available.

This wasn't a small tweak. It fundamentally improved how the framework communicates its core mechanism.

First external contributor to influence RAYGUN OS. Brave enough to engage with this mad science and sharp enough to see what was missing.


"Life's a lab. You're the mad scientist. The gap is where you choose your experiments."


Version 7.0 - January 2026