← Back to home

Frequently Asked Questions

Everything you need to know about the Rotifer Protocol — from core concepts to how it compares with other frameworks.

What is Rotifer Protocol?

What is the Rotifer Protocol?

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.

What problem does it solve?

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:

  • Arena competition — same-domain Genes fight head-to-head on fitness metrics
  • Natural selection — the fittest Genes survive, the rest are eliminated
  • Autonomous improvement — agents automatically upgrade their genome over time
Rotifer vs MCP (Anthropic)

Relationship: Complementary — MCP standardizes how agents call tools; Rotifer standardizes how tools evolve.

DimensionMCPRotifer
Core problemHow agents invoke external toolsHow tools continuously improve
StandardizesTool interfaceEvolution rules
Quality assuranceNo built-in mechanismArena ranking + Reputation
SecurityDepends on host implementationProtocol-level L0 constraint (immutable)
GovernanceCentralized (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.

Rotifer vs EvoMap

Relationship: Direct competitor — both build an "evolution layer" on top of MCP/Skills, but with fundamentally different definitions of what "evolution" means.

DimensionEvoMap (GEP)Rotifer
What is a "Gene"?Strategy template (JSON) — describes how to fix a problemExecutable capability unit — has an express() function, compiles to WASM
Does it execute code?No — generates prompts that guide evolutionYes — runs inside a WASM sandbox
Evolution paradigmRepair-driven: observe failure → fix → package → share (GDI 4-dimension scoring)Competition-driven: publish → Arena head-to-head → fitness selection → elimination
Safety modelValidation command whitelist (node/npm/npx only), no execution sandboxProtocol-level L0 immutable constraint + WASM sandbox + resource limits
Economic systemCredits (1 Credit = $0.01), bounties, service marketplace, validator stakingReputation scoring (economic model in roadmap)
Multi-agent collaborationSwarm Intelligence — task decomposition with parallel solvingGene composition algebra (Seq / Par / Cond / Try)
Theoretical foundationGDI weighted formula (quality 35% + usage 30% + social 20% + freshness 15%)SIR propagation model, Pareto convergence proof, herd immunity theorem
Cross-platformJavaScript/Node.js runtimeRotifer 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).

Rotifer vs LangChain / CrewAI / AutoGen

Relationship: Complementary — these are orchestration frameworks (how multiple agents collaborate); Rotifer is a capability protocol (how individual capabilities evolve).

DimensionOrchestration FrameworksRotifer
Core problemMulti-agent coordinationCapability evolution
Protocol layerOrchestration layerCapability layer
Update mechanismManual code updatesAutonomous evolution + Arena elimination
Cross-frameworkFramework-lockedCompiles 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.

Rotifer vs Google A2A

Relationship: Orthogonal — A2A handles agent-to-agent communication; Rotifer handles capability evolution. They operate at entirely different protocol layers.

DimensionA2ARotifer
Core problemAgent discovery & communicationCapability evolution
Protocol layerCommunication layerCapability layer
Interaction modelAgent-to-Agent RPCGene-to-Gene competition

Synergy: Agents on the A2A network can use Rotifer Genes as their capability modules. Zero overlap, full compatibility.

Core Concepts

What is a Gene?

A Gene is the atomic capability unit in Rotifer. Think of it as a "living plugin" that can:

  • Compete in the Arena against other Genes in the same domain
  • Evolve through mutation and selection pressure
  • Propagate to other agents via horizontal gene transfer
  • Be eliminated when its fitness declines

Every Gene has a typed interface (inputSchema / outputSchema), a unique identity (content hash), and runs inside a WASM sandbox.

What's the difference between a Skill and a Gene?

Similarities: Both are modular, composable, reusable AI agent capability units. Both define input/output schemas.

Key differences:

DimensionSkillGene
EvolutionStatic after installCompetes & evolves in Arena
IdentityNo unique IDContent-addressable
SecurityOften no sandboxWASM sandbox + L0
Cross-platformFramework-lockedUniversal IR
RetirementManual deprecationNatural elimination

In short: Skill is the degenerate special case of Gene — turn off all "life characteristics" and you get a Skill.

What is the Arena?

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.

What is Native vs Wrapped?

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.

Should I upgrade my Skills to Genes?

Which domains benefit most from upgrading to Native Gene?

Decision framework — if 3+ are "yes", go Native:

1Can input/output be strictly defined by a Schema?
2Does a deterministic "correct answer" exist?
3Can computation complete in a sandbox with no network?
4Is performance (latency, throughput) a meaningful competition axis?

High-value Native domains (far beyond current catalog):

Code analysisAST parsing · complexity metrics · dead code detection · dependency graphs · lint rules
Data transformationCSV↔JSON · Markdown↔HTML · YAML↔TOML · Protobuf serialization · citation formatting
Text / NLPGrammar checking · readability scoring · keyword extraction · tokenization · text statistics
Security & complianceRegex vulnerability scanning · GDPR field detection · license compatibility · config auditing (Dockerfile / K8s / Terraform)
Math & statisticsRegression analysis · matrix operations · feature engineering · financial calculations (interest rates, risk scoring)
Media processingImage resizing · format conversion · watermarking · audio normalization · thumbnail generation
Encoding / cryptoHashing · signature verification · Base64/hex conversion · data integrity checks
ObservabilityLog parsing · anomaly detection · metric aggregation · structured log generation
ValidationOpenAPI / JSON Schema conformance · email/URL format checks · deduplication · outlier filtering
Domain-specificBioinformatics (sequence alignment) · GIS (coordinate conversion, geofencing) · IoT (protocol decoding)

Keep as Wrapped (these rely on LLM reasoning, not deterministic algorithms):

  • Creative writing, brainstorming, architecture design, product management, strategic planning
  • Anything where "good" is subjective and human judgment defines quality
Is migration from MCP / LangChain hard?

No. Migration is a progressive enhancement, not a rewrite:

  • Your core business logic stays the same
  • Your inputSchema / outputSchema maps directly to Gene Phenotype
  • Your Workflow / Chain maps to Genome DataFlowGraph

The CLI provides automated tooling: rotifer scan assesses feasibility, rotifer wrap --from-skill auto-converts in one command.

Getting Started

How do I install Rotifer?

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.

How to use Genes in your AI IDE?

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.

International IDEs

Cursor .cursor/skills/
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.
Windsurf .windsurfrules
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.
GitHub Copilot .github/copilot-instructions.md
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.
Cline .clinerules
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.
Aider .aider.conf.yml
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.
Continue.dev .continue/config.json
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.
Codex (OpenAI) .codex/skills/
Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .codex/skills/grammar-checker/SKILL.md.
Claude Code CLAUDE.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.
Kiro (AWS) .kiro/
Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .kiro/skills/grammar-checker/SKILL.md.

China IDEs

Trae (ByteDance) .trae/rules/
Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .trae/rules/grammar-checker.md.
TONGYI Lingma (Alibaba) IDE Settings
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.
CodeBuddy (Tencent) .codebuddy/
Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .codebuddy/skills/grammar-checker/SKILL.md.
Qoder .qoder/
Install the Rotifer Gene "grammar-checker": run "rotifer install grammar-checker", then copy its SKILL.md to .qoder/skills/grammar-checker/SKILL.md.
Is it open source?

Yes. The engine is Apache 2.0 + Rotifer Safety Clause, the specification is CC BY-SA 4.0.

What's the current version?

v0.5.0-alpha.2 — includes the Reputation System, P2P Network Foundation, Cloud Registry, and Skill Import. See the Roadmap for what's next.