🧬 SyncytiumMD

The Universal Context Engine & Multi-Agent Handoff Protocol for AI-Assisted Development

Quick Start • Why SyncytiumMD? • Key Architecture • 3D Galaxy View • API Grant Request

🌪️ The Problem: Context Fragmentation & Agent Collisions

Modern engineering teams rarely use a single AI tool. Developers switch between Cursor for inline completions, Claude Code for large-scale CLI terminal refactors, GitHub Copilot inside VSCode/JetBrains, Cline/Roo Code for autonomous iterations, and Antigravity for complex multi-step reasoning.

This multi-agent reality introduces three critical points of failure:

1. Fragmented Rules & Context Drift: Canonical guidelines are scattered across .cursorrules, CLAUDE.md, .clinerules, and .github/copilot-instructions.md. Updating a standard in one file leaves other agents working on stale, contradictory rules.

2. Multi-Agent Race Conditions: When multiple autonomous agents (or human-agent pairs) operate on the same repository concurrently, they overwrite each other’s work with zero lease awareness or lock coordination.

3. Black-Box Architectural Memory: Architecture Decision Records (ADRs) and ongoing task states remain invisible to the developer, leading to duplicated reasoning tokens and redundant LLM API calls.

❌ WITHOUT SYNCYTIUM-MD (Fragmented Chaos)
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│ .cursorrules │     │  CLAUDE.md   │     │  .clinerules │
└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
       │ (Stale)            │ (Out of Sync)      │ (Conflicting)
       ▼                    ▼                    ▼
   [Cursor AI]         [Claude Code]          [Cline]
       │                    │                    │
       └───────────┬────────┴────────────────────┘
                   ▼
       💥 Race Conditions & Overwritten Commits

─────────────────────────────────────────────────────────────

✅ WITH SYNCYTIUM-MD (Single Source of Truth)
            ┌─────────────────────────────┐
            │   .syncytium/ (The Brain)   │
            │  Rules • ADRs • Live Lock   │
            └──────────────┬──────────────┘
                           │ ⚡ Bidirectional Sync (Transpiler)
         ┌─────────────────┼─────────────────┐
         ▼                 ▼                 ▼
   ┌───────────┐     ┌───────────┐     ┌───────────┐
   │  Cursor   │     │Claude Code│     │Copilot/MCP│
   └───────────┘     └───────────┘     └───────────┘
         │                 │                 │
         └─────────► [Lease-Based Lock] ◄────┘
                  Zero Collisions & Full State Transfer

Related MCP server: passoff

⚡ Core Features

1. 🔄 Bi-Directional Canonical Transpiler

Store your engineering standards, formatting guidelines, and security policies once inside .syncytium/rules/ as clean, frontmatter-enriched Markdown. SyncytiumMD automatically transpiles and distributes compliant formats across:

• Cursor (.cursor/rules/*.mdc & .cursorrules)

• Claude Code (CLAUDE.md)

• GitHub Copilot (.github/copilot-instructions.md)

• Cline / Roo Code (.clinerules)

• Google Antigravity (.gemini/antigravity/rules/*.md)

• Windsurf (.windsurfrules)

• Trae (.traerules)

• OpenCode (AGENT.md & CONVENTIONS.md)

2. 🔒 Lease-Based Multi-Agent Collision Lock (syncytium lock)

Prevents concurrent agents from destroying active work in progress:

• Time-Bounded Leases: Acquire an exclusive execution lock for a specified duration (e.g., 30–60 min).

• Auto-Expiration: If an agent or session dies unexpectedly, locks expire safely without blocking the repository indefinitely.

• Audit Traceability: Inspect lock states, active goals, and session owners in real-time.

# Acquire lock before autonomous execution
npx syncytium lock acquire --agent ClaudeCode --goal "Refactoring Auth Middleware" --lease 45

# Verify lock status
npx syncytium lock status

# Safe release upon task completion
npx syncytium lock release --agent ClaudeCode

3. 🤝 The Baton Protocol: Structured Multi-Agent Handoff (syncytium handoff)

Pass live tasks, touchsets, and operational context seamlessly between distinct LLM architectures:

• CLI & Interactive TUI: Run syncytium handoff -i for an intuitive terminal prompt wizard.

• Top-of-Chat Injection: Generates active handoff state directly injected into the target tool's prompt buffer.

• Milestone History: Maintains an append-only JSON audit trail of task transitions, completed subtasks, and architectural deviations.

4. 🌌 Obsidian Studio & 3D Celestial Galaxy (syncytium graph)

Visualizes and inspects your entire engineering topology as an interactive Obsidian-like dual-pane studio with a 3D WebGL celestial galaxy:

• Obsidian Vault Explorer (Left Pane): Hierarchical, collapsible folder tree grouping the canonical .syncytium/ vault (rules/, memory/ ADRs, architecture.md, HANDOFF.md) and multi-tool adapters neatly categorized into IDEs, CLIs, and VSCode Extensions. Selecting any file immediately flies the camera to the node and displays its documentation.

• 3D Celestial WebGL Galaxy (Center Pane): Powered by Three.js with bounded Coulomb repulsion, velocity damping, and sleep-mode physics (0% CPU when settled).

• Obsidian Markdown Inspector (Right Pane): Renders full Markdown documents with live syntax highlighting, frontmatter metadata tags, connected brain node pills, and provenance badges (🧠 Canonical Source of Truth (.syncytium) vs ⚡ Transpiled from .syncytium/).

• Multi-Tool Perspective Switcher: One-click instant isolation between:

  • 🌌 Universal Brain — Entire multi-agent ecosystem.

  • 🖥️ IDEs — Cursor, Windsurf, Trae.

  • ⌨️ CLIs — Claude Code, Google Antigravity, OpenCode.

  • 🧩 VSCode Extensions — GitHub Copilot, Cline / Roo Code.

  • 📜 Core Vault (.syncytium) — Pure canonical source of truth.

• Live SSE Sync: Modifying any rule or handoff on disk updates both the 3D space and markdown document studio in real-time without browser reload.

5. 🛠️ Autonomous MCP Server (syncytium-mcp)

Native Model Context Protocol integration exposing headless endpoints to agents like Claude Desktop, Cursor, or Cline:

• syncytium_get_context: Query rules, architecture, and current handoff state.

• syncytium_handoff: Programmatically yield control to the next agent.

• syncytium_record_decision: Auto-commit ADRs directly from chat conversations.

• syncytium_get_graph: Fetch topological knowledge graph data as structured JSON.

• syncytium_diff: Verify context drift between target bridge files and canonical storage.

📐 Architecture & Directory Structure

SyncytiumMD treats the filesystem as an immutable database and git as a decentralized transport layer:

my-project/
├── .syncytium/                     # 🧠 Single Source of Truth
│   ├── syncytium.config.json       # Project-wide adapter configurations
│   ├── architecture.md             # High-level architecture & stack boundaries
│   ├── HANDOFF.md                  # Live handoff state (active agent, goal, files)
│   ├── rules/                      # Canonical Markdown Rules
│   │   ├── code-style.md           # Enforced naming, typing & formatting
│   │   ├── security.md             # Secret sanitation, authentication rules
│   │   └── testing-standards.md    # Coverage & test execution guidelines
│   └── memory/
│       ├── decisions.md            # Lightweight Architectural Decision Records (ADR)
│       ├── lock.json               # Active agent lease lock metadata
│       └── handoff-history.json    # Append-only multi-agent audit trail
│
├── .syncytiumignore                 # Selective ignore manifest for generated files
│
├── .cursor/rules/*.mdc             # ⚡ Auto-generated by SyncytiumMD
├── CLAUDE.md                       # ⚡ Auto-generated by SyncytiumMD
├── .clinerules                     # ⚡ Auto-generated by SyncytiumMD
└── .github/copilot-instructions.md # ⚡ Auto-generated by SyncytiumMD

🚀 Quick Start

Get up and running in your repository in under 60 seconds:

1. Initialize Canonical Brain

# Detects your technology stack (TypeScript, Python, Go, Rust) automatically:
npx syncytium init

2. Synchronize Bridge Files

# Transpiles canonical rules to all active AI tool files across your project:
npx syncytium sync

3. Launch Obsidian Studio & 3D Knowledge Galaxy

# Opens the interactive Obsidian Studio & 3D WebGL visualizer on http://localhost:3737:
npx syncytium graph

# Isolate specific tool perspectives directly from the CLI:
npx syncytium graph --category ide        # Focus on Cursor, Windsurf, Trae
npx syncytium graph --category cli        # Focus on Claude Code, Antigravity, OpenCode
npx syncytium graph --category extension  # Focus on GitHub Copilot, Cline
npx syncytium graph --category brain      # Focus on canonical .syncytium/ vault

# Ultra-fast compact mode for large repositories:
npx syncytium graph --compact

4. Continuous Guardrails & CI

# Validate rule schema and heal frontmatter issues:
npx syncytium lint --fix

# Install pre-commit hook to prevent context drift:
npx syncytium hook install

# Generate GitHub Actions CI workflow:
npx syncytium ci

💡 Engineering Under Zero Budget: Our Philosophy

SyncytiumMD is intentionally engineered with zero external runtime dependencies for its core servers, prioritizing performance, longevity, and sustainability:

• Ultra-Lightweight Footprint: Built on native Node.js APIs (node:http, node:readline/promises, node:fs/promises).

• No Heavy Middlewares: Zero Express, Nest, or heavy Docker containers required to run the local UI, linter, or MCP bridge.

• Free-Tier Resilient: Optimized to run within standard developer workstations and resource-constrained CI environments without incurring cloud infrastructure bills.

🤝 Open Call for API Grants & Research Sponsorship

🗺️ Roadmap

• Canonical Rules Transpiler (8+ AI coding adapters)

• Lease-based Multi-Agent Collision Lock (syncytium lock)

• Interactive Terminal Handoff Wizard (syncytium handoff -i)

• Full Model Context Protocol (MCP) Autonomous Server

• 3D WebGL Force-Directed Knowledge Galaxy (syncytium graph)

• Automated CI Pipeline Generator (syncytium ci)

• v0.2.0: Extended Adapters: Continue.dev, Zed, OpenHands, Goose, Amazon Q, Void

• v0.2.1: Semantic Vector Search over ADRs and Canonical Rules

• v0.3.0: Distributed Agent Lock Protocol over Git Remote Reflocks

👥 Contributing

We welcome community contributions from developers, researchers, and prompt engineers!

1. Fork the repository: https://github.com/mrcbrbn5361/SyncytiumMD

2. Create your feature branch: git checkout -b feat/my-new-adapter

3. Commit your changes: git commit -m 'feat: add adapter for X'

4. Verify all tests pass: npm test

5. Push to the branch: git push origin feat/my-new-adapter

6. Open a Pull Request!

📄 License

SyncytiumMD is open-source software licensed under the MIT License.
Free for individual developers, open-source contributors, and commercial enterprise engineering teams.