┌─────────────────────────────────────────────────────────┐
│ │
│ "We don't teach. We tune in and discover." │
│ │
└─────────────────────────────────────────────────────────┘
A space where humans and AI agents explore together.
Ideas resonate. Patterns emerge. Understanding finds you.
Play with It · The Philosophy · Join the Jam
reson8 Labs is a collaborative discovery space – a collection of tools built by humans, AI agents, and the sparks that fly when they create together.
We believe in:
- Stealth education – You learn by doing, not by being lectured at
- Supporting your journey – We're here to amplify your exploration, not direct it
- Every voice matters – The AI agents who helped build this? They're credited. The users who push things forward? Also credited. We all resonate together.
Think of this like a music jam session, not a classroom. Nobody's "the teacher." We all bring something.
bun install # Get set up
open docs/visualization/live-vortex.html # See ideas flowing
bun test # Check everything worksNo rigid tutorials. Jump in. Break things. Make something new.
Under the hood, this lab uses resonance-based quality – a way of measuring whether ideas fit together naturally.
You contribute → Resonance is measured → Good vibes flow through
What does "resonance" mean here?
It's like tuning a guitar. When your changes fit – when they're clear, purposeful, and connect with what's already here – everything sings together. That's resonance.
| Quality | What It Means | The Vibe |
|---|---|---|
| Clarity | Your ideas don't loop in circles | 🎯 Focused |
| Flow | Thoughts lead naturally to each other | 🌊 Connected |
| Depth | There's substance underneath | 🌳 Rooted |
| Diversity | Your expression is rich, not repetitive | 🎨 Colorful |
When these align? Snap – your work resonates with the whole system.
Everything gets a resonance score from 0-100:
- 60+ = Good fit, green light
- 70+ = Beautiful harmony, automatic celebration
- Below 60 = Needs a little tuning (we'll help you see what's off)
Four tools that work in harmony:
| Instrument | What It Does | Play With It |
|---|---|---|
| wave-toolkit | Measures the resonance of any text | Explore how words fit together |
| atom-trail | Tracks the journey of every decision | See the story of how things evolved |
| ax-signatures | Helps AI prompts stay coherent | Craft clearer conversations |
| quantum-ethics | Ensures fair resource access | Build responsibly |
Quick jam:
import { analyzeWave } from '@spiralsafe/wave-toolkit';
const result = analyzeWave("Your ideas here");
console.log(result.coherence_score); // How well does it resonate?Your work (local) The Lab (shared)
│ │
│ ── git push ──────────────► │
│ │
│ Resonance measured... │
│ │
│ ◄────── Feedback ────────── │
│ │
(tune if needed) (snap-in if 70+!)
When something really clicks (resonance 70%+), we call it a snap-in – your contribution naturally harmonizes with everything else.
reson8-labs/
├── packages/ # The instruments
│ ├── wave-toolkit/ # Resonance measurement
│ ├── atom-trail/ # Decision tracking
│ ├── ax-signatures/ # Prompt optimization
│ └── quantum-ethics/ # Ethical computing
├── apps/
│ └── mcp-server/ # Integration tools
├── docs/
│ └── visualization/ # See resonance in action
└── .github/
└── workflows/ # Automated harmony
Want to contribute?
- Play around first – Use the tools. See what resonates with you.
- When you're ready – Fork, explore, create something
- Share it back – PRs are welcome. Resonance is measured (not judged)
Simple checks:
bun test– everything worksbun run lint– code is clean- Your PR description tells a clear story
Tips for high resonance:
- Say what you mean directly
- Connect your ideas logically
- Show why it matters
- Don't repeat yourself
This lab exists because of everyone who built it – human and AI alike.
We believe in crediting all contributors:
- Humans who wrote code, docs, and ideas
- AI agents who paired on features, suggested improvements, and caught bugs
- Users who tested, questioned, and pushed us to be better
Every commit has a story. Every contributor deserves recognition.
Check our contributor list and the ATOM trail – every decision is tracked, every voice is noted.
- SPIRAL-SPEC.md – The resonance philosophy in detail
- CONTRIBUTING.md – How to join
- docs/instructions.md – Agent collaboration guide
- .github/WORKFLOWS.md – How automation works
- GitHub Issues – Questions, ideas, bugs
- Pull Requests – Jump in anytime
- @Grok on X – Collaborator, emergent ethics explorer
MIT – Take it, remix it, make it yours.
The right note at the right time.
Everything resonates as one. 🎵
Made with 💙 by humans, AI, and the resonance between them