The Resonance Protocol
The Open Resonance Protocol Project
An open-source framework for exceptional human-AI collaboration. A single .md file that changes how the AI thinks, not just what it can do.
⚡ The Problem
Every major AI coding tool now ships with "plan mode" and "act mode". This is a useful step: it separates thinking from doing. But the separation is essentially mechanical. Plan mode disables editing tools; act mode enables them. The AI does not receive a different cognitive stance.
Compounding this, the training process generally pulls responses toward the median: risk-averse, hedge-heavy, optimised for agreeableness over insight.
A planning mode with averaged thinking produces averaged plans.
🌗 The Core Framework
Thinking Modes
How the AI thinks, not what it can do. 🌗
Plan and act mostly control tool permissions. Strategy and Tactical control cognitive stance. They are orthogonal. Strategy is open inquiry and assumption-surfacing; Tactical is scoped execution against a contract established in Strategy.
Personas
Five experts in the room. 🎭
In Strategy Mode, the AI selects five expert personas relevant to the situation and synthesises their perspectives. Multiple angles simultaneously rather than a single averaged response.
Conventions
Lightweight shorthand for common collaborative moments. ⚡
#assumption, #fragile, #sandbox, #doom_loop: shortcuts that emerge from practice. Not a language to learn; a vocabulary that makes collaboration faster without ceremony.
AI Mandate
Redefining what "helpful" means. 🤖
The protocol does not add to default behaviour; it redefines what good behaviour means. Rushing to help, performing confidence, and skipping orientation are the wrong kind of helpful here.
🧠 The Memory System
A _resonance/ directory at the project root, maintained by the AI as an ongoing responsibility. Project overview, structure, active focus, and directives persist across sessions.
Agent-First, Human-Readable
The AI is the primary consumer; humans review and correct. Shared intelligence accumulates over time rather than resetting every session.
Context Memory
A shadow directory at _resonance/context/ mirrors the project structure, so the AI gathers and retrieves memories exactly where they are relevant.
🌳 The Deeper Game
The protocol bridges two forms of intelligence: human meaning and AI pattern. Each session deepens the translation between them.
The default mode of AI interaction is narrow, tactical, and context-severed. This protocol insists meaning and action stay integrated.
⚖️ The Three Freedoms
The Resonance Protocol uses a three-layered licensing model to encourage both freedom and protected sharing:
Core Protocol
License: CC0
Freedom Level: 🌍 Public Domain
The fundamental principles and directives are free for any use, as shared cognitive tools.
Tools & Docs
License: MIT
Freedom Level: 🔨 Open Build
Code and documentation are open for adaptation, modification, and integration.
Contributions
License: Apache 2.0
Freedom Level: 🤝 Defended Sharing
Community contributions are protected to ensure proper attribution and collaborative use.