multimodel-dev-os 2.6.0 → 2.8.1

package/.ai/plugins/README.md

@@ -0,0 +1,30 @@
+# MultiModel Dev OS Plugins
+
+This directory holds declarative MultiModel Dev OS plugin configurations.
+
+## Overview
+
+Plugins are **strictly declarative** YAML files that conform to the JSON schema defined in [.ai/schema/plugin.schema.json](../schema/plugin.schema.json). They allow teams and the community to package and distribute custom configurations without executing unverified third-party code.
+
+### Safe Containment Rules
+To protect your repositories from supply-chain threats, the plugin system enforces strict containment rules:
+1. **No Code Execution:** Plugins cannot execute JavaScript, binary files, post-install scripts, or terminal shells.
+2. **No Package Installs:** Plugins cannot trigger npm/yarn package downloads or modifications to `package.json`.
+3. **No Network Activity:** Operations are fully offline-safe.
+4. **Write Containment:** Installation can only write rule, template, and workflow definitions to the `.ai/` and `adapters/` folders. Modifying app source code, `.env`, `.git/`, or `.npmrc` is hard-blocked.
+
+## Creating a Plugin
+
+1. Create a YAML file following the layout in [plugin.example.yaml](plugin.example.yaml).
+2. Define the metadata fields (`name`, `slug`, `version`, `description`, `author`).
+3. Set path permissions using `allowed_file_patterns`.
+4. Validate your file using the CLI tool:
+   ```bash
+   npx multimodel-dev-os@latest plugin validate path/to/your-plugin.yaml
+   ```
+5. Install your plugin:
+   ```bash
+   npx multimodel-dev-os@latest plugin install path/to/your-plugin.yaml --approved
+   ```
+
+For detailed documentation, see the **[Plugin Authoring Guide](../../docs/plugin-authoring)** and **[TUI & Plugin Safety](../../docs/tui-safety)**.

package/.ai/plugins/plugin.example.yaml

@@ -0,0 +1,32 @@
+name: "Example Git Integration Plugin"
+slug: "git-integration"
+version: "1.0.0"
+description: "Declarative plugin extending MultiModel Dev OS with custom git workflows and rules"
+author: "MultiModel Dev OS Team"
+allowed_file_patterns:
+  - ".ai/skills/git-operations.md"
+  - ".ai/checks/pre-push-audit.md"
+denied_file_patterns:
+  - "src/**"
+  - ".env"
+  - "node_modules/**"
+templates:
+  git-commit-helper:
+    name: "Git Commit Message Assistant"
+    description: "Generates semantic commit messages based on staged diffs"
+workflows:
+  git-audit:
+    name: "Pre-Push Git Audit"
+    description: "Scan branch status and verify all local commits pass verification before pushing code"
+    steps:
+      - name: "Status Check"
+        command: "status"
+      - name: "Doctor Pre-flight Audit"
+        command: "doctor"
+      - name: "Integrity Verify"
+        command: "verify"
+adapters:
+  git-rules:
+    name: "Git Rules Configuration"
+    targetFile: ".gitattributes"
+safety_notes: "This plugin only writes configurations to .ai/skills/ and .ai/checks/ to aid developer git workflows. No binary code is executed."

package/.ai/schema/plugin.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MultiModel Dev OS Plugin Schema",
+  "description": "JSON schema reference detailing declarative plugin metadata and permitted directories configuration",
+  "type": "OBJECT",
+  "required": ["name", "slug", "version", "description", "author"],
+  "properties": {
+    "name": {
+      "type": "STRING",
+      "description": "Human-readable name of the plugin"
+    },
+    "slug": {
+      "type": "STRING",
+      "description": "Unique URL-friendly slug representing the plugin"
+    },
+    "version": {
+      "type": "STRING",
+      "description": "Semantic versioning number of the plugin (e.g. 1.0.0)"
+    },
+    "description": {
+      "type": "STRING",
+      "description": "Brief summary of what capabilities and templates this plugin introduces"
+    },
+    "author": {
+      "type": "STRING",
+      "description": "Name of the developer or team who created the plugin"
+    },
+    "allowed_file_patterns": {
+      "type": "ARRAY",
+      "items": { "type": "STRING" },
+      "description": "Target paths inside .ai/ or adapters/ this plugin is permitted to write to"
+    },
+    "denied_file_patterns": {
+      "type": "ARRAY",
+      "items": { "type": "STRING" },
+      "description": "Explicit blacklisted paths this plugin is blocked from writing to"
+    },
+    "templates": {
+      "type": "OBJECT",
+      "description": "Custom templates mapped by the plugin configuration"
+    },
+    "workflows": {
+      "type": "OBJECT",
+      "description": "Custom workflows mapped by the plugin configuration"
+    },
+    "adapters": {
+      "type": "OBJECT",
+      "description": "Custom adapter settings mapped by the plugin configuration"
+    },
+    "safety_notes": {
+      "type": "STRING",
+      "description": "Explicit security notices displayed to the user during installation"
+    }
+  },
+  "additionalProperties": false
+}

package/README.md

@@ -5,8 +5,8 @@
 </p>
 
 <p align="center">
-  <b>The portable AI Dev OS for every model, every tool, every workflow.</b><br>
-  <sub>One workspace. Zero lock-in. Ship faster with Codex, Gemini, Claude, Cursor, Antigravity, VS Code, and more.</sub>
+  <b>One workspace config. Every AI coding tool. Zero lock-in.</b><br>
+  <sub>Stop copy-pasting AI rules between Cursor, Claude, Gemini, Codex, and VS Code. Start shipping.</sub>
 </p>
 
 <p align="center">
@@ -20,56 +20,35 @@
 
 ---
 
-## Get started in 30 seconds
+## The Problem
+
+You use **Cursor** for autocomplete, **Claude Code** for terminal ops, **Gemini** for deep audits. Every tool switch loses your context. Every `.cursorrules` / `CLAUDE.md` / `.vscode/settings.json` change drifts out of sync with the others. Prompts bloat, tokens waste, onboarding breaks.
+
+## The Fix: 30 Seconds
 
 ```bash
 npx multimodel-dev-os@latest init
 ```
 
-That's it. Your workspace now has a unified AI context layer that works across **every major AI coding tool** — no config duplication, no context loss, no vendor lock-in.
+Your workspace now has a **single source of truth** that every AI coding tool reads automatically — no config duplication, no context loss, no vendor lock-in.
 
-<p align="center">
-  <img src="assets/social-preview.svg" alt="MultiModel Dev OS Banner" width="100%">
-</p>
+> Already have a project? Onboard it safely:
+> ```bash
+> npx multimodel-dev-os@latest onboard analyze
+> ```
 
 ---
 
-## The Problem
-
-AI pair programmers are powerful individually, but switching between them creates real friction:
-
-| Pain Point | What Happens |
-|:---|:---|
-| **Context Fragmentation** | You use Cursor for autocomplete, Claude Code for terminal ops, Gemini for deep audits. Every switch forces a full context rebuild. |
-| **Instruction Drift** | `.cursorrules`, `CLAUDE.md`, `.vscode/settings.json`, `.gemini/settings.json` — change one, the rest go stale. |
-| **Token Waste** | Without context budgets, prompts bloat and API bills spike. |
-| **Onboarding Friction** | New team members start from scratch with every tool. |
-
-## The Solution
-
-**MultiModel Dev OS** creates a single source of truth — four root contracts and a `.ai/` directory that bridges every tool dynamically:
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  LAYER 1: Root Contracts (Single Source of Truth)           │
-│  AGENTS.md  •  MEMORY.md  •  TASKS.md  •  RUNBOOK.md      │
-└─────────────────────────┬───────────────────────────────────┘
-                          │
-┌─────────────────────────▼───────────────────────────────────┐
-│  LAYER 2: Configuration Engine (.ai/)                       │
-│  context/  agents/  skills/  prompts/  checks/  models/    │
-│  registries/  intelligence/  policies/                      │
-└─────────────────────────┬───────────────────────────────────┘
-                          │
-┌─────────────────────────▼───────────────────────────────────┐
-│  LAYER 3: Tool & IDE Adapters                               │
-│  .cursorrules  CLAUDE.md  .vscode/  .gemini/  GEMINI.md    │
-└─────────────────────────────────────────────────────────────┘
-```
+## Key Features
 
-<p align="center">
-  <img src="assets/architecture-preview.svg" alt="Architecture Diagram" width="100%">
-</p>
+| | Feature | What It Does |
+|:---|:---|:---|
+| 🔄 | **Universal Adapter Sync** | Write rules once → auto-syncs to `.cursorrules`, `CLAUDE.md`, `.vscode/`, `.gemini/`, and more |
+| ⚡ | **Caveman Mode** | Slash prompt token overhead by **~79%** for tight API budgets |
+| 🧠 | **Intelligence Engine** | Hash-compressed memory, feedback learning, self-improvement proposals with HITL safety gates |
+| 📁 | **Repo Onboarding** | Analyze existing projects, recommend templates, and bootstrap configs without breaking anything |
+| 🔧 | **Zero Dependencies** | Pure Node.js CLI — no runtime, no build step, no package manager lock-in |
+| 🛡️ | **214+ Quality Gates** | Built-in `validate`, `doctor`, and `verify` commands with strict structural assertions |
 
 ---
 
@@ -91,131 +70,53 @@ AI pair programmers are powerful individually, but switching between them create
 
 ---
 
-## CLI Commands
+## How It Works
 
-MultiModel Dev OS ships a pure Node.js CLI with **zero runtime dependencies**.
+```
+┌─────────────────────────────────────────────────────────────┐
+│  LAYER 1: Central Root Contracts (Single Source of Truth)   │
+│  AGENTS.md  •  MEMORY.md  •  TASKS.md  •  RUNBOOK.md      │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+┌─────────────────────────▼───────────────────────────────────┐
+│  LAYER 2: Configuration & Intelligence (.ai/)                │
+│  context/  agents/  skills/  prompts/  checks/  session/    │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+┌─────────────────────────▼───────────────────────────────────┐
+│  LAYER 3: Engine Workflows & Safety Gates                   │
+│  onboard analyze  •  adapter sync  •  improve apply         │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+┌─────────────────────────▼───────────────────────────────────┐
+│  LAYER 4: Tool & IDE Adapters                               │
+│  .cursorrules  •  CLAUDE.md  •  .vscode/  •  .gemini/      │
+└─────────────────────────────────────────────────────────────┘
+```
 
-<p align="center">
-  <img src="assets/terminal-demo.svg" alt="Terminal Demo Sequence" width="100%">
-</p>
+---
 
-### Initialize a Workspace
+## Essential Commands
 
 ```bash
-# Default workspace
-npx multimodel-dev-os@latest init
-
-# Pick a template
+# Initialize & Onboard
 npx multimodel-dev-os@latest init --template nextjs-saas
-npx multimodel-dev-os@latest init --template wordpress-site
-npx multimodel-dev-os@latest init --template ecommerce-store
-npx multimodel-dev-os@latest init --template seo-landing-page
-npx multimodel-dev-os@latest init --template expo-react-native-android
-npx multimodel-dev-os@latest init --template general-app
-
-# Inject a specific adapter
-npx multimodel-dev-os@latest init --adapter cursor
-npx multimodel-dev-os@latest init --adapter claude
-```
-
-### Codebase Scanning & Memory
+npx multimodel-dev-os@latest onboard analyze
 
-```bash
-# Scan target repository structure and framework signals
+# Scan, Status & Memory
 npx multimodel-dev-os@latest scan
-
-# Show compact repository intelligence state status
 npx multimodel-dev-os@latest status
-
-# Compile hash-compressed codebase state memory
 npx multimodel-dev-os@latest memory build
 
-# Incremental update of codebase state memory
-npx multimodel-dev-os@latest memory refresh
-
-# Diff current codebase state against memory files
-npx multimodel-dev-os@latest memory diff
-```
-
-### Feedback Learning & Proposals
-
-```bash
-# Log developer preference or instruction feedback
-npx multimodel-dev-os@latest feedback add "Avoid Tailwind CSS" --type preference
-
-# View logged feedback entries
-npx multimodel-dev-os@latest feedback list
-
-# Compile raw feedback logs into active rules
-npx multimodel-dev-os@latest feedback summarize
-
-# Generate structured codebase improvement proposal
-npx multimodel-dev-os@latest improve propose --title "Fix config issues"
-
-# Review active proposals and statuses
-npx multimodel-dev-os@latest improve review
-
-# View improvement engine status
-npx multimodel-dev-os@latest improve status
-
-# Validate proposal safety gates and operations
-npx multimodel-dev-os@latest improve validate .ai/proposals/proposal-xxxx.md
-
-# Preview proposed changes in unified diff format
-npx multimodel-dev-os@latest improve diff .ai/proposals/proposal-xxxx.md
-
-# Apply deterministic approved operations to codebase
-npx multimodel-dev-os@latest improve apply .ai/proposals/proposal-xxxx.md --approved
-
-# View applied proposals execution history audit log
-npx multimodel-dev-os@latest improve log
+# Sync IDE Adapters
+npx multimodel-dev-os@latest adapter sync all --approved
 
-# Orchestrate development workflow pipelines
+# Run Workflows & Handoffs
 npx multimodel-dev-os@latest workflow run repo-health
-npx multimodel-dev-os@latest workflow list
-
-# Compile or print token-compressed agent session handoff summaries
 npx multimodel-dev-os@latest handoff build
-npx multimodel-dev-os@latest handoff show
-
-# Onboard existing repositories safely
-npx multimodel-dev-os@latest onboard analyze
-npx multimodel-dev-os@latest onboard recommend
-npx multimodel-dev-os@latest onboard plan
-npx multimodel-dev-os@latest onboard apply --approved
-npx multimodel-dev-os@latest onboard status
-
-# Manage and sync IDE adapter configuration files
-npx multimodel-dev-os@latest adapter status
-npx multimodel-dev-os@latest adapter diff cursor
-npx multimodel-dev-os@latest adapter sync cursor --approved
-npx multimodel-dev-os@latest adapter sync all --approved
-```
-
-### Explore Registries
-
-```bash
-npx multimodel-dev-os@latest templates     # List all templates
-npx multimodel-dev-os@latest models        # View model registry
-npx multimodel-dev-os@latest adapters      # View adapter registry
-npx multimodel-dev-os@latest models --json # Machine-readable output
-```
-
-### Quality Gates
-
-```bash
-npx multimodel-dev-os@latest validate      # Strict schema validation
-npx multimodel-dev-os@latest doctor        # Advisory compatibility checks
-npx multimodel-dev-os@latest verify        # Full release audit
 ```
 
-### Caveman Mode
-
-Cut prompt token overhead by **~79%** with compressed shorthand declarations:
-
-```bash
-npx multimodel-dev-os@latest init --caveman
-```
+📖 **[Full CLI Reference →](https://rizvee.github.io/multimodel-dev-os/CLI)**
 
 ---
 
@@ -223,70 +124,23 @@ npx multimodel-dev-os@latest init --caveman
 
 | Capability | Manual Rules File | MultiModel Dev OS |
 |:---|:---|:---|
-| **Tool Sync** | Manual copy-paste across tools | Automated dynamic adapters |
-| **Context Budgets** | Bloats prompts, wastes tokens | Caveman Mode cuts **~79%** token overhead |
-| **Standards** | Easy to drift and corrupt | CLI `validate` + `doctor` + 193-assertion `verify` |
-| **Templates** | Start from scratch | 6 production-ready real-world templates |
-| **Model Registry** | Hardcoded model names | Dynamic capability-scored registry with routing presets |
-| **Safety** | No guardrails | Prepublish guards, schema validation, hygiene checks |
+| **Tool Sync** | Manual copy-paste across tools | ✅ Automated dynamic adapters |
+| **Context Budgets** | Bloats prompts, wastes tokens | ✅ Caveman Mode cuts **~79%** overhead |
+| **Standards** | Easy to drift and corrupt | ✅ CLI `validate` + `doctor` + 214-assertion `verify` |
+| **Templates** | Start from scratch | ✅ 6 production-ready real-world templates |
+| **Model Registry** | Hardcoded model names | ✅ Dynamic capability-scored routing presets |
+| **Self-Improvement** | None | ✅ Feedback → Proposals → Apply with safety gates |
+| **Onboarding** | Manual setup every time | ✅ `onboard analyze` bootstraps existing repos |
 
 ---
 
-## Cost & Context Optimization
+## What's New in v2.8
 
-Minimize prompt overhead and API billing with built-in context-reduction techniques:
-
-<p align="center">
-  <img src="assets/cost-optimization.svg" alt="Cost Optimization Funnel" width="100%">
-</p>
+- 🧠 **Interactive TUI Dashboard** — Launches an interactive menu wrapper (`dashboard` or `ui`) for keyboard-driven navigation across all MultiModel Dev OS commands with non-TTY automated fallbacks.
+- 🔌 **Declarative Plugin Hooks** — Fully offline, declarative system (`plugin`) to list, show, validate, and install plugin rules to whitelisted directories with overwrite backups.
+- 🛡️ **Zero-Dependency CLI** — Custom keypress menu handling built on Node.js's native `readline` module.
 
-Read the full playbook: **[Cost Optimization Guide](https://rizvee.github.io/multimodel-dev-os/cost-optimization)**
-
----
-
-## 5-Day Adoption Roadmap
-
-Deploy MultiModel Dev OS across your team in under a week:
-
-<p align="center">
-  <img src="assets/ai-dev-os-roadmap.svg" alt="5-Day Adoption Roadmap" width="100%">
-</p>
-
-Step-by-step timeline: **[5-Day Adoption Playbook](https://rizvee.github.io/multimodel-dev-os/5-day-roadmap)**
-
----
-
-## Real-World Case Studies
-
-- 📦 [Full-Stack Next.js SaaS: Database Schema Synchronization](https://rizvee.github.io/multimodel-dev-os/case-studies/nextjs-saas)
-- 🔌 [WordPress Theme Scaffolding: Folder Boundary Protections](https://rizvee.github.io/multimodel-dev-os/case-studies/wordpress-site)
-- 🛒 [E-Commerce Webhooks: State Verification Alignment](https://rizvee.github.io/multimodel-dev-os/case-studies/ecommerce-store)
-- 📈 [SEO Landing Pages: Core Web Vitals Linter Budgets](https://rizvee.github.io/multimodel-dev-os/case-studies/seo-landing-page)
-- 🚀 [Multi-Model Handoff: Sequential Session Logging](https://rizvee.github.io/multimodel-dev-os/case-studies/multimodel-handoff)
-
----
-
-## Intelligence Layer (v2.1.0 — Coming Next)
-
-The next major milestone introduces a **future-proof intelligence layer** — registry-driven, feedback-enabled, with strict human-in-the-loop safety gates:
-
-| Component | Description |
-|:---|:---|
-| **Capability Registry** | Score models across coding, reasoning, repo-scan, agentic-duration, MCP compliance — no hardcoded names |
-| **Tool Registry** | Define IDE, terminal, and MCP tool integrations dynamically |
-| **Hash-Compressed Memory** | Token-efficient codebase fingerprints, summaries, and dependency maps |
-| **Feedback Learning** | Convert developer corrections into reusable system rules |
-| **Self-Improvement Engine** | Proposal → Review → Apply cycles with mandatory HITL approval and automatic rollback |
-
-> [!NOTE]
-> The v2.1.0 schemas, registries, and policies are already committed and verified (193/193 assertions pass). CLI implementation is the next phase.
-
-Learn more:
-- [Future-Proof Architecture](https://rizvee.github.io/multimodel-dev-os/future-proof-architecture)
-- [Hash-Compressed Memory](https://rizvee.github.io/multimodel-dev-os/hash-compressed-memory)
-- [Feedback Learning](https://rizvee.github.io/multimodel-dev-os/feedback-learning)
-- [Capability Registry Guide](https://rizvee.github.io/multimodel-dev-os/capability-registry)
-- [v2 Roadmap (v2.1 → v3.0)](https://rizvee.github.io/multimodel-dev-os/v2-roadmap)
+**[Full Changelog →](CHANGELOG.md)**
 
 ---
 
@@ -295,16 +149,16 @@ Learn more:
 | Version | Focus | Status |
 |:---|:---|:---|
 | **v2.0.0** | Template Galaxy, Model Registry, Stable Protocol | ✅ Released |
-| **v2.0.1** | Post-release polish, docs cleanup, 193 verify assertions | ✅ Released |
-| **v2.1.0** | Intelligence Core — Registries, Memory Engine, Capability Routing | ✅ Released |
-| **v2.2.0** | Feedback Loops & MCP Tool Integrations | ✅ Released |
-| **v2.3.0** | Proposal Engine & Safety Controls | ✅ Released |
+| **v2.2.0** | Codebase Scanner & Hash-Compressed Memory Engine | ✅ Released |
+| **v2.3.0** | Feedback Learning & Proposal Engine | ✅ Released |
 | **v2.4.0** | Approved Proposal Application Engine | ✅ Released |
-| **v2.4.1** | Proposal Apply UX + Safety Patch | ✅ Released |
 | **v2.5.0** | Repository Intelligence Command Center | ✅ Released |
+| **v2.6.0** | Real-Repo Onboarding & Adapter Sync | ✅ Released |
+| **v2.7.0** | Website, Demo & Distribution System | ✅ Released |
+| **v2.8.0 / v2.8.1** | Interactive TUI Dashboard & Plugin Hooks | ✅ Released |
 | **v3.0.0** | Unified Autonomous Co-Pilot Ecosystem | 🔮 Future |
 
-Full details: **[v2 Roadmap](https://rizvee.github.io/multimodel-dev-os/v2-roadmap)**
+**[Full Roadmap →](https://rizvee.github.io/multimodel-dev-os/v2-roadmap)**
 
 ---
 
@@ -318,16 +172,19 @@ Full details: **[v2 Roadmap](https://rizvee.github.io/multimodel-dev-os/v2-roadm
 | 🤖 AI Discoverability | **[llms.txt](https://rizvee.github.io/multimodel-dev-os/llms.txt)** |
 | 🚀 Quick Start | **[Quickstart Guide](https://rizvee.github.io/multimodel-dev-os/quickstart)** |
 | 🏗️ Architecture | **[Architecture Deep Dive](https://rizvee.github.io/multimodel-dev-os/architecture)** |
-| 🔄 Migration Guide | **[Upgrade from v1.x](https://rizvee.github.io/multimodel-dev-os/migration-guide)** |
+| ⚔️ Comparison | **[vs Alternatives](https://rizvee.github.io/multimodel-dev-os/comparison)** |
 | 🛡️ Stable Protocol | **[Protocol Specification](https://rizvee.github.io/multimodel-dev-os/stable-protocol)** |
 
 ---
 
-## Contributing
+## Contributing & Community
 
 We welcome contributions! Propose new adapters, request templates, improve docs, or report issues.
 
-Read our **[Contributing Guidelines](CONTRIBUTING.md)** to get started.
+- 📖 **[Contributing Guidelines](CONTRIBUTING.md)**
+- 🐛 **[Report a Bug](https://github.com/rizvee/multimodel-dev-os/issues/new)**
+- 💡 **[Request a Feature](https://github.com/rizvee/multimodel-dev-os/issues/new)**
+- ⭐ **[Star us on GitHub](https://github.com/rizvee/multimodel-dev-os)** — it helps others discover this project
 
 ---
 

package/assets/adapter-sync-flow.svg

@@ -0,0 +1,84 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 320" width="100%" height="100%" style="font-family: 'Outfit', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#070a13" />
+      <stop offset="100%" stop-color="#0d111d" />
+    </linearGradient>
+    <linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#6366f1" />
+      <stop offset="100%" stop-color="#10b981" />
+    </linearGradient>
+    <linearGradient id="card" x1="0%" y1="0%" x2="0%" y2="100%">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.06" />
+      <stop offset="100%" stop-color="#ffffff" stop-opacity="0.02" />
+    </linearGradient>
+  </defs>
+
+  <!-- Background -->
+  <rect width="900" height="320" rx="16" fill="url(#bg)" />
+  <rect x="1" y="1" width="898" height="318" rx="15" fill="none" stroke="#1e293b" stroke-width="1" />
+
+  <!-- Title -->
+  <text x="450" y="38" text-anchor="middle" font-size="18" font-weight="800" fill="#e2e8f0" letter-spacing="0.5">ADAPTER SYNC FLOW</text>
+  <rect x="200" y="48" width="500" height="2" rx="1" fill="url(#accent)" opacity="0.4" />
+
+  <!-- Source: AGENTS.md -->
+  <rect x="30" y="75" width="180" height="90" rx="12" fill="url(#card)" stroke="#4f46e5" stroke-width="1.5" />
+  <text x="120" y="105" text-anchor="middle" font-size="15" font-weight="800" fill="#a78bfa">AGENTS.md</text>
+  <text x="120" y="125" text-anchor="middle" font-size="10" fill="#94a3b8">Single source of truth</text>
+  <text x="120" y="140" text-anchor="middle" font-size="10" fill="#94a3b8">for all AI coding rules</text>
+  <text x="120" y="155" text-anchor="middle" font-size="9" fill="#10b981" font-weight="600">YOUR RULES</text>
+
+  <!-- Arrow source → adapter sync -->
+  <line x1="215" y1="120" x2="275" y2="120" stroke="url(#accent)" stroke-width="2" />
+  <polygon points="275,115 285,120 275,125" fill="#10b981" />
+
+  <!-- Adapter Sync Engine -->
+  <rect x="290" y="70" width="160" height="100" rx="12" fill="url(#card)" stroke="#10b981" stroke-width="1.5" />
+  <text x="370" y="100" text-anchor="middle" font-size="28">🔄</text>
+  <text x="370" y="125" text-anchor="middle" font-size="13" font-weight="700" fill="#f8fafc">adapter sync</text>
+  <text x="370" y="143" text-anchor="middle" font-size="10" fill="#94a3b8">Diff + copy with</text>
+  <text x="370" y="156" text-anchor="middle" font-size="10" fill="#94a3b8">backup protection</text>
+
+  <!-- Arrows to targets -->
+  <line x1="455" y1="95" x2="540" y2="55" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="110" x2="540" y2="95" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="125" x2="540" y2="135" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="140" x2="540" y2="175" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="155" x2="540" y2="215" stroke="#6366f1" stroke-width="1.5" />
+  <line x1="455" y1="165" x2="540" y2="255" stroke="#6366f1" stroke-width="1.5" />
+
+  <!-- Target: Cursor -->
+  <rect x="545" y="35" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="58" font-size="14">🎯</text>
+  <text x="578" y="58" font-size="12" font-weight="600" fill="#f8fafc">.cursorrules</text>
+
+  <!-- Target: Claude -->
+  <rect x="545" y="78" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="101" font-size="14">⚡</text>
+  <text x="578" y="101" font-size="12" font-weight="600" fill="#f8fafc">CLAUDE.md</text>
+
+  <!-- Target: VS Code -->
+  <rect x="545" y="121" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="144" font-size="14">💻</text>
+  <text x="578" y="144" font-size="12" font-weight="600" fill="#f8fafc">.vscode/settings.json</text>
+
+  <!-- Target: Gemini -->
+  <rect x="545" y="164" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="187" font-size="14">🧠</text>
+  <text x="578" y="187" font-size="12" font-weight="600" fill="#f8fafc">GEMINI.md</text>
+
+  <!-- Target: Antigravity -->
+  <rect x="545" y="207" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="230" font-size="14">🪐</text>
+  <text x="578" y="230" font-size="12" font-weight="600" fill="#f8fafc">.gemini/settings.json</text>
+
+  <!-- Target: More -->
+  <rect x="545" y="250" width="160" height="36" rx="8" fill="url(#card)" stroke="#334155" stroke-width="1" />
+  <text x="555" y="273" font-size="14">🔌</text>
+  <text x="578" y="273" font-size="12" font-weight="600" fill="#94a3b8">+ Cline, Aider, ...</text>
+
+  <!-- Footer command -->
+  <rect x="30" y="280" width="500" height="30" rx="8" fill="#090d16" stroke="#1e293b" stroke-width="1" />
+  <text x="45" y="300" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="12" fill="#34d399">$ <tspan fill="#e2e8f0">npx multimodel-dev-os@latest adapter sync all --approved</tspan></text>
+</svg>