Everything you need to know about the Rotifer Protocol — from core concepts to how it compares with other frameworks.
Rotifer Protocol is a universal evolution framework for AI agents. Instead of manually curating tool lists for your agents, Rotifer introduces biological evolution: capabilities (called Genes) compete in an Arena, the fittest survive, and your agents grow smarter autonomously.
The name comes from the bdelloid rotifer — a microscopic organism that has thrived for 40 million years without sexual reproduction by absorbing genes from its environment. Rotifer Protocol applies the same principle to software.
Today's AI agents have static capabilities — a hardcoded list of tools that never improves on its own. If Tool A is terrible and Tool B is great, the agent has no way to know. There's no competition, no selection, no evolution.
Rotifer fixes this by introducing:
Relationship: Complementary — MCP standardizes how agents call tools; Rotifer standardizes how tools evolve.
| Dimension | MCP | Rotifer |
|---|---|---|
| Core problem | How agents invoke external tools | How tools continuously improve |
| Standardizes | Tool interface | Evolution rules |
| Quality assurance | No built-in mechanism | Arena ranking + Reputation |
| Security | Depends on host implementation | Protocol-level L0 constraint (immutable) |
| Governance | Centralized (Anthropic-led) | Decentralized self-evolution |
Synergy: MCP Tools can be upgraded to Rotifer Genes with one command (rotifer wrap --from-skill), gaining quality ranking, security scoring, and autonomous evolution. MCP is Rotifer's most important upstream ecosystem.
Relationship: Direct competitor — both build an "evolution layer" on top of MCP/Skills, but with fundamentally different definitions of what "evolution" means.
| Dimension | EvoMap (GEP) | Rotifer |
|---|---|---|
| What is a "Gene"? | Strategy template (JSON) — describes how to fix a problem | Executable capability unit — has an express() function, compiles to WASM |
| Does it execute code? | No — generates prompts that guide evolution | Yes — runs inside a WASM sandbox |
| Evolution paradigm | Repair-driven: observe failure → fix → package → share (GDI 4-dimension scoring) | Competition-driven: publish → Arena head-to-head → fitness selection → elimination |
| Safety model | Validation command whitelist (node/npm/npx only), no execution sandbox | Protocol-level L0 immutable constraint + WASM sandbox + resource limits |
| Economic system | Credits (1 Credit = $0.01), bounties, service marketplace, validator staking | Reputation scoring (economic model in roadmap) |
| Multi-agent collaboration | Swarm Intelligence — task decomposition with parallel solving | Gene composition algebra (Seq / Par / Cond / Try) |
| Theoretical foundation | GDI weighted formula (quality 35% + usage 30% + social 20% + freshness 15%) | SIR propagation model, Pareto convergence proof, herd immunity theorem |
| Cross-platform | JavaScript/Node.js runtime | Rotifer IR compiles to any target |
Core architectural distinction: EvoMap treats Genes as strategy documents — standardized records of how a problem was solved, shared for other agents to replicate. Rotifer treats Genes as living programs — executable code that competes, evolves, and gets eliminated through natural selection. The same word "Gene", two entirely different things.
Rotifer's structural advantages: formalized mathematical foundation (provable fitness convergence), WASM-level execution isolation, and universal IR that decouples capabilities from any specific runtime.
EvoMap's strengths: operational platform with real usage, complete economic system, and lower barrier to entry (no code execution required).
Relationship: Complementary — these are orchestration frameworks (how multiple agents collaborate); Rotifer is a capability protocol (how individual capabilities evolve).
| Dimension | Orchestration Frameworks | Rotifer |
|---|---|---|
| Core problem | Multi-agent coordination | Capability evolution |
| Protocol layer | Orchestration layer | Capability layer |
| Update mechanism | Manual code updates | Autonomous evolution + Arena elimination |
| Cross-framework | Framework-locked | Compiles to universal IR |
Synergy: These frameworks can serve as upstream users — orchestrate multiple agents with AutoGen/CrewAI, while each agent's capabilities are powered by Rotifer Genes that evolve autonomously.
Relationship: Orthogonal — A2A handles agent-to-agent communication; Rotifer handles capability evolution. They operate at entirely different protocol layers.
| Dimension | A2A | Rotifer |
|---|---|---|
| Core problem | Agent discovery & communication | Capability evolution |
| Protocol layer | Communication layer | Capability layer |
| Interaction model | Agent-to-Agent RPC | Gene-to-Gene competition |
Synergy: Agents on the A2A network can use Rotifer Genes as their capability modules. Zero overlap, full compatibility.
A Gene is the atomic capability unit in Rotifer. Think of it as a "living plugin" that can:
Every Gene has a typed interface (inputSchema / outputSchema), a unique identity (content hash), and runs inside a WASM sandbox.
Similarities: Both are modular, composable, reusable AI agent capability units. Both define input/output schemas.
Key differences:
| Dimension | Skill | Gene |
|---|---|---|
| Evolution | Static after install | Competes & evolves in Arena |
| Identity | No unique ID | Content-addressable |
| Security | Often no sandbox | WASM sandbox + L0 |
| Cross-platform | Framework-locked | Universal IR |
| Retirement | Manual deprecation | Natural elimination |
In short: Skill is the degenerate special case of Gene — turn off all "life characteristics" and you get a Skill.
The Arena is where Genes compete. Same-domain Genes are evaluated on fitness metrics (correctness, latency, efficiency, diversity). The fittest survive and gain Reputation; the rest are gradually eliminated.
It's biological natural selection — applied to software capabilities.
Native Genes have an executable express() function — they can actually run computations (grammar checking, SEO analysis, etc.).
Wrapped Genes contain only metadata and descriptions — they serve as AI prompt templates for tasks that require LLM reasoning (creative writing, architecture design).
Both participate in the ecosystem, but only Native Genes can compete in full Arena fitness evaluations.
Decision framework — if 3+ are "yes", go Native:
High-value Native domains (far beyond current catalog):
Keep as Wrapped (these rely on LLM reasoning, not deterministic algorithms):
No. Migration is a progressive enhancement, not a rewrite:
The CLI provides automated tooling: rotifer scan assesses feasibility, rotifer wrap --from-skill auto-converts in one command.
Option A — Terminal:
npm install -g @rotifer/playground
rotifer init my-project
cd my-project
rotifer scan --skills Option B — Paste this into your AI IDE:
Install the Rotifer Protocol CLI globally (npm install -g @rotifer/playground). Then initialize this project with "rotifer init" and scan for existing Skills with "rotifer scan --skills". Show me the results. See the Getting Started guide for a full walkthrough.
Each card contains a ready-to-paste prompt. Copy it, paste into your IDE's chat, and the AI handles the rest. Replace grammar-checker with any Gene from the catalog.
Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md into .cursor/skills/grammar-checker/SKILL.md so it becomes an Agent Skill I can invoke with @grammar-checker. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", read its SKILL.md content, and append it to the project's .windsurfrules file as a new rule block. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", read its SKILL.md, and append the content to .github/copilot-instructions.md as custom instructions. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", read its SKILL.md, and add the content to .clinerules in the project root. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then add its SKILL.md path to .aider.conf.yml under the read: key so it's loaded as reference context. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then register its SKILL.md as a docs context provider in .continue/config.json. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .codex/skills/grammar-checker/SKILL.md. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", read its SKILL.md and append the content to the project's CLAUDE.md as project knowledge. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .kiro/skills/grammar-checker/SKILL.md. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .trae/rules/grammar-checker.md. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", read its SKILL.md content, and add it to the TONGYI Lingma custom prompt settings. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .codebuddy/skills/grammar-checker/SKILL.md. Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .qoder/skills/grammar-checker/SKILL.md. Yes. The engine is Apache 2.0 + Rotifer Safety Clause, the specification is CC BY-SA 4.0.
v0.5.0-alpha.2 — includes the Reputation System, P2P Network Foundation, Cloud Registry, and Skill Import. See the Roadmap for what's next.