The Operating System for Vibe Coding

Your AI Chatbot
Has Amnesia.

You explain the architecture. It nods. You paste the error. It fixes it. Five minutes later, it suggests the same bad code again.

Stop the loop. Resonance gives your LLM a file-based brain that remembers your project's soul, stack, and rules forever.

Generic Chatbot (Memory: 8k)
User: "Use Tailwind."
AI: "Okay, using Tailwind."
... 10 minutes later ...
User: "Make it blue."
AI: "Here is some Bootstrap CSS..."
User: "I SAID TAILWIND!"
vs
Resonance (Memory: ∞)
@Kernel: Reading `.resonance/01_state.md`
> Stack: Tailwind, React
> Color: #7025eb (Midnight)
AI: "I see you're using the Midnight theme. I've applied the `bg-midnight` utility as defined in your design tokens."
IMMUTABLE LAWS

PRIME DIRECTIVES

The 4 rules that separate Resonance from a generic chatbot.

01
ZERO_DIVERGENCE

One Brain. One Truth.

The .resonance folder is the Single Source of Truth. Code must never contradict the five pillars of law: Soul, Systems, State, Memory, and Tools.

02
ZERO_ENTROPY

Intentionality, Not Complexity.

We build with the precision of the top 1%. We reject 'good enough' and thoughtless defaults. Every logic flow must be simple and intentional.

03
ZERO_GUESSWORK

Science, Not Magic.

We do not fix bugs without a reproduction script. We do not ship features without a test. The Scientific Method is mandatory.

04
ZERO_DRAG

Performance is a Feature.

Interaction must feel instant. We mask latency with prediction and treat every millisecond of delay or grain of confusion as a bug.

THE PROBLEM

GROUNDHOG DAY CODING

Every time you start a new chat session, you have to re-explain your life story.

"We are using Next.js."
"Don't use `any` types."
"Our primary color is #7025eb."

It's exhausting. It's inefficient. And it leads to a codebase that looks like a patchwork quilt of random decisions.

THE SOLUTION

THE FILE-SYSTEM BRAIN

Resonance saves your project's context in Markdown files right next to your code.

🧠
02_memory.md
"We decided to use Tanstack Query because Redux was overkill."
🧭
00_soul.md
"This app should feel like a luxurious Swiss watch."

Result: Start a new chat, type "Build a settings page", and the AI already knows the design system, the state management library, and the vibe.

METHODOLOGY

THE WORKFLOW ENGINE

Standardized protocols for every stage of development.
Don't think about "how". Just run the command.

01 INCEPTION
/init

The Interview

Resonance asks you 5 questions to generate your Project Soul & PRD.

/plan

Deep Spec

Converts your idea into a 30-page implementation plan (80% Research).

02 EXECUTION
/build

The TDD Loop

Writes the test. Fails. Writes the code. Passes. Refactors.

/debug

Scientific Method

Auto-generates reproduction scripts before attempting a fix.

/design

Visual Engine

Creates pixel-perfect UI components with isolated feedback loops.

/refactor

Atomic Cleanup

Structural improvements without changing behavior. Enforces SOLID.

03 VERIFICATION
/test

Pyramid Testing

Runs Unit, Integration, and E2E tests against the spec.

/audit

Local Audit

Runs the 'Swarm' for security, performance, and lint checks.

/review-pr

Gatekeeper

Analyzes external PRs against internal standards before merging.

04 DELIVERY
/ship

Release Protocol

Updates changelog, bumps version, checks health, and deploys.

05 EVOLUTION
/capture

Knowledge Base

Documents hard-won solutions into the .resonance/memory.

/system-health

System Quantified

Calculates a health score (0-100) based on tests, linting, and drift.

/update-roadmap

Sync Territory

Compares Git history vs Plan and updates the roadmap.

QUALITY ASSURANCE

TRIPLE-GATE PROTOCOL

FRAMEWORK
DRIVEN
REFERENCE
BACKED
AGENT
READABLE
QUALITY CHECKS: ACTIVE
THE ROSTER

DOMAIN
EXPERTISE

Don't ask a generalist to do a specialist's job. Resonance gives you 26 distinct roles, each trained on specific engineering protocols.

PM
Product Manager
● Online
"I'll make sure we don't build features nobody wants."
AR
Architect
● Online
"I'll ensure the architecture scales before we write a line of code."
SA
Security Auditor
● Online
"I'll hack your auth flow before we ship."
CD
Creative Director
● Online
"I'll stop you from using generic Bootstrap colors."

BUILT ON ESTABLISHED STANDARDS:

C4 Architecture Models
OWASP Top 10 Security
StoryBrand Framework
Fogg Behavior Model
Google Core Web Vitals
12-Factor App methodology
Domain-Driven Design
Atomic Design System
Scientific Method Debugging
+92 more
Product Manager Specialist • Tech Lead Specialist • Growth Strategist Specialist • Venture Validator Specialist • Research Scientist Specialist • Creative Director Specialist • Backend Specialist • Frontend Specialist • Mobile Specialist • Game Dev Specialist • Database Specialist • DevOps Specialist • Debugger Specialist • Tooling Specialist • Security Specialist • QA Specialist • Performance Specialist • SEO Specialist • Conversion Specialist • Copywriter Specialist • Studio Specialist • Code Reviewer Specialist • Refactor Specialist • Skill Author Specialist • Librarian Specialist • The Kernel Specialist • Product Manager Specialist • Tech Lead Specialist • Growth Strategist Specialist • Venture Validator Specialist • Research Scientist Specialist • Creative Director Specialist • Backend Specialist • Frontend Specialist • Mobile Specialist • Game Dev Specialist • Database Specialist • DevOps Specialist • Debugger Specialist • Tooling Specialist • Security Specialist • QA Specialist • Performance Specialist • SEO Specialist • Conversion Specialist • Copywriter Specialist • Studio Specialist • Code Reviewer Specialist • Refactor Specialist • Skill Author Specialist • Librarian Specialist • The Kernel Specialist •
~/consciousness
├── .resonance/00_soul.md
Mission & Vision
├── .resonance/01_state.md
Active Context
├── .resonance/02_memory.md
Decision Log
├── .resonance/03_tools.md
Capability Map
├── .resonance/04_systems.md
Architecture Map
├── .agent/skills/*
26 Specialized Agents
├── .agent/workflows/*
13 Scientific Workflows

SYSTEM ARCHITECTURE

FILE-SYSTEM
CONSCIOUSNESS

Resonance does not live in the cloud. It lives in your repo. The folder structure IS the architecture. Deleting the folder deletes the brain.

LOCAL_FIRST
GIT_NATIVE
SYSTEM READY

INITIALIZE
SECOND BRAIN

Deploy the memory bank into your project.
Zero config. Instant intelligence.

$ git clone https://github.com/manusco/resonance .resonance
Browse Repository