multimodel-dev-os 0.7.0 → 1.0.0

package/docs/launch-kit.md

@@ -1,88 +1,80 @@
 # Public Launch & Social Sharing Kit
 
-A curated collection of promotional templates and copy outlines to successfully announce `multimodel-dev-os` to global developer communities.
+A curated collection of ready-to-use sharing outlines focused on LLM cost savings, multi-agent context synchronization, and configuration reuse inside development teams.
 
 ---
 
-## 1. Product Hunt Style Launch Info
-- **Tagline:** Portable, vendor-neutral project context for all your AI coding tools.
-- **Elevator Pitch:** Stop manually copy-pasting system instructions when switching between Cursor, Claude Code, Antigravity, and VS Code. Run a single lightweight command to scaffold, sync, and optimize your repository's AI guidelines.
+## 1. Product Hunt Launch (Milestone v0.8.0)
+- **Product Tagline:** Portable workspace configuration layer and playbooks to sync AI coding agents.
+- **Pitch Focus:** Slash LLM API billing and context overhead by up to **~79%** with our native Caveman Mode. Enforce strict coding styles and boundaries across Cursor, Claude, Antigravity, and VS Code automatically using a singular root contract.
 
 ---
 
-## 2. GitHub Repository Metadata
-- **Short Description:** Portable, vendor-neutral project configuration and CLI tool for AI coding agents. Think `.editorconfig` but optimized for LLMs, Cursor, Claude Code, and VS Code.
-- **Topics/Keywords:** `ai-dev-os`, `multi-agent`, `ai-coding`, `developer-tools`, `cursorrules`, `claude-code`, `antigravity`, `gemini`
-
----
-
-## 3. X / Twitter Post (The Hook)
+## 2. X / Twitter Campaign (The Focus: Token Cost Savings)
 
 ```text
-Pair programming with AI is fast, until you switch tools. 💸
+AI coding is fast, but prompt token bills scale faster. 💸
 
-You design architecture in Claude Code, implement locally in Cursor, and audit with Gemini. Every switch drops context, and rules start to drift.
+Duplicating instructions in .cursorrules, CLAUDE.md, and system prompts drains your API token budget on every message turn.
 
-Stop copy-pasting. Say hello to MultiModel Dev OS! 🧠
+Say hello to MultiModel Dev OS v0.8.0! 🧠
 
 npx multimodel-dev-os@latest init
 
-👉 Single source of truth for all tools (Cursor, Claude, VS Code, Gemini, Codex)
-👉 Slashing token consumption by up to ~79% with Caveman Mode
-👉 Strict CLI validation commands to protect context health
-👉 Fully vendor-neutral and zero-dependency
+👉 Decoupled adapters sync Cursor, Claude, VS Code, and Gemini instantly
+👉 Slash rule overhead by up to ~79% with Caveman Mode
+👉 12 Cost Optimization plays mapped to Dev OS features
+👉 5-Day tool-neutral Adoption Roadmap for teams
 
-Check it out: https://github.com/rizvee/multimodel-dev-os
+Stop wasting context. Sync and reuse your workspace memory! 🚀
+👉 https://github.com/rizvee/multimodel-dev-os
 #AIDev #OpenSource #SoftwareEngineering #AItools
 ```
 
 ---
 
-## 4. LinkedIn Post (The Deep Dive)
+## 3. LinkedIn Campaign (The Focus: Enterprise Adoption)
 
 ```text
-The hidden developer tax when coding with AI: Context Drift. 💸
-
-When pair programming with AI agents, we often switch between platforms to leverage their unique strengths:
-- Claude Code for terminal actions and system layouts
-- Cursor for local autocomplete and quick edits
-- Gemini / Antigravity for large-scale security and performance audits
-
-But there's a problem: every tool has its own custom settings, systems, and instructions files. You modify a build command in one place, forget to update it in another, and the agent breaks on compile. 
+The hidden tax of scaling AI inside development teams: Context Fragmentation. 💸
 
-To solve this, we are launching multimodel-dev-os — a portable, vendor-neutral operating configuration layer for AI coding tools.
+When switching between tools:
+- Claude Code scaffolds terminal builds
+- Cursor suggests local autocompletions
+- Gemini/Antigravity performs codebase audits
 
-Think .editorconfig but designed for LLMs. 
+If each developer maintains distinct, custom configurations, your rules drift immediately. Models break, and you waste thousands of tokens repeating basic instructions.
 
-How it works:
-1. Initialize in seconds: npx multimodel-dev-os@latest init
-2. Configure your instructions in one root directory (AGENTS.md, MEMORY.md, TASKS.md)
-3. Zero-duplication adapters dynamically present these instructions to Cursor (.cursorrules), Claude (CLAUDE.md), VS Code, and Gemini.
-4. Slash token bills by up to ~79% using Caveman Mode for small-context turns.
+To solve this, we are releasing MultiModel Dev OS v0.8.0:
+1. One central brain (AGENTS.md and .ai/) routes instructions dynamically.
+2. Slashes API prompt overhead by ~79% via Caveman Mode.
+3. Maps 12 context optimization techniques ( RAG scoping, prompt caching, batching).
+4. Includes a 5-Day tool-neutral Adoption Roadmap to align your team in a business week.
 
-Fully open-source, zero-dependency, and built to keep your context aligned across every coding tool.
+Fully open-source, MIT licensed, and zero-dependency.
 
-GitHub: https://github.com/rizvee/multimodel-dev-os
-Let me know what you think in the comments! 👇
+Read the Case Studies Gallery & Playbook:
+👉 https://github.com/rizvee/multimodel-dev-os
+Let me know how your team manages prompt consistency in the comments! 👇
 ```
 
 ---
 
-## 5. Reddit-Style Post (/r/webdev, /r/LocalLLaMA)
+## 4. Reddit-Style Pitch (/r/LocalLLaMA, /r/webdev)
 
-- **Title:** Show HN / Show Reddit: MultiModel Dev OS — A vendor-neutral context management layer for Cursor, Claude Code, and VS Code.
+- **Title:** Show HN / Show Reddit: MultiModel Dev OS v0.8.0 — Prevent AI instruction drift and save ~79% token budget.
 - **Content:**
   Hey everyone,
   
-  If you pair program with multiple AI tools, you've probably noticed how fast rules drift. You edit a command in your system prompts, but forget to update Cursor's `.cursorrules`, causing the model to continuously fail.
+  If your team pair programs with multiple LLM agents, you know how fast rules drift. You edit a command in your terminal prompts, but Cursor's autocompletes are still reading outdated caching guidelines, causing compile crashes.
   
-  I built **multimodel-dev-os** to solve this. It's a simple, zero-dependency CLI that scaffolds a unified context layout and uses lightweight adapters to route a single source of truth to all your tools.
+  I built **multimodel-dev-os** to solve this. It's a lightweight, zero-dependency Node.js CLI that scaffolds a single repository brain and uses automated adapters to route a single source of truth to all your tools.
   
-  ### Key Features:
-  * **Primary Init:** Run `npx multimodel-dev-os@latest init` to bootstrap in 2 seconds.
-  * **Vendor-Neutral:** One config routes to Cursor (`.cursorrules`), Claude Code (`CLAUDE.md`), VS Code (`settings.json`), and Gemini/Antigravity (`settings.json`).
-  * **Caveman Mode:** Strips out examples and descriptions to save **~79% of tokens** when context budgets are tight.
-  * **Linter Guard:** Run `npx multimodel-dev-os@latest verify` to confirm structure health before pushing commits.
+  ### v0.8.0 Feature Highlights:
+  * **Cost Optimization Playbook:** Maps 12 techniques (prompt caching, RAG scoping, batching) directly to Dev OS directory modules.
+  * **Caveman Mode:** Strips out descriptions and examples to save **~79% of tokens** per prompt turn.
+  * **5-Day Adoption Timeline:** A tool-neutral business week adoption playbook.
+  * **Real-World Case Studies:** 5 generic but realistic guides covering full-stack SaaS schema synchronization, WordPress directory boundaries, and Claude/Gemini hand-off session logs.
   
   Open-source and MIT licensed. I'd love to hear your feedback on the layout structure!
   

package/docs/migration-guide.md

@@ -0,0 +1,54 @@
+# Migration Guide: Upgrading MultiModel Dev OS
+
+This guide assists engineering teams in upgrading their MultiModel Dev OS configurations across releases, preparing repositories for v1.0.0 compliance.
+
+---
+
+## 1. Upgrading from v0.1 to v0.5
+
+The `v0.5` release introduced the pure-Node local CLI and template scaffolding directories.
+
+### Upgrade Steps:
+1. **Directory Scaffolding:** Create the Lower-case subfolders under `.ai/` if they do not exist:
+   ```bash
+   mkdir -p .ai/context .ai/skills .ai/session-logs
+   ```
+2. **Move Custom Rules:** Scrape old system prompt snippets from `.cursorrules` and modularize them into isolated files inside `.ai/context/` (e.g. `project-brief.md`, `architecture.md`).
+3. **Configure Adapters Settings:** Create [.ai/config.yaml](file:///c:/Users/ADMIN/OneDrive/Desktop/multimodel-dev-os/.ai/config.yaml) and configure adapter mappings:
+   ```yaml
+   version: "0.5.0"
+   adapters:
+     cursor: true
+     claude: true
+   ```
+
+---
+
+## 2. Upgrading from v0.5 to v0.8
+
+The `v0.8` release focused on cost/context optimizations, adding the 12 playbook techniques and visual timelines.
+
+### Upgrade Steps:
+1. **Enable Caveman Mode:** Set up Caveman minimal-token files inside `.ai/templates/` to allow rapid chat turns under tight budgets.
+2. **Deploy Session Logs:** Confirm a `session-log-template.md` exists in `.ai/templates/` and create [.ai/session-logs/README.md](file:///c:/Users/ADMIN/OneDrive/Desktop/multimodel-dev-os/.ai/session-logs/README.md) to manage sequential handoffs.
+3. **Audit Workspace compliance:** Run the linter to diagnostic environment issues:
+   ```bash
+   npx multimodel-dev-os doctor
+   ```
+
+---
+
+## 3. Upgrading from v0.9.0 to v1.0.0 Stable
+
+The `v1.0.0` release completely freezes the public protocol and schemas.
+
+### Upgrade Steps:
+1. **Mount JSON Schemas:** Verify that config schemas under `.ai/schema/` are linked in your local configuration files.
+2. **Execute Strict Validations:** Enforce strict assertions inside your pull requests or pre-commit hooks:
+   ```bash
+   npx multimodel-dev-os validate
+   ```
+3. **Run Diagnostics Suite:** Execute the full verification and doctor suite to ensure absolute compliance:
+   ```bash
+   npx multimodel-dev-os doctor
+   ```

package/docs/protocol.md

@@ -0,0 +1,54 @@
+# MultiModel Dev OS Protocol Specification
+
+This document defines the official, stable architectural protocol and design contracts for `multimodel-dev-os`, preparing the codebase for the v1.0.0 freeze.
+
+---
+
+## 1. Protocol Architecture Layers
+
+The protocol is divided into three distinct decoupled layers to guarantee portability:
+
+```
+┌────────────────────────────────────────────────────────┐
+│ LAYER 1: Root Contracts (Single Source of Truth)       │
+│ AGENTS.md • MEMORY.md • TASKS.md • RUNBOOK.md          │
+└──────────────────────────┬─────────────────────────────┘
+                           │ Centralizes project context
+┌──────────────────────────▼─────────────────────────────┐
+│ LAYER 2: Configuration & Modules (.ai/)                │
+│ context/ • agents/ • skills/ • prompts/ • checks/      │
+└──────────────────────────┬─────────────────────────────┘
+                           │ routes files dynamically
+┌──────────────────────────▼─────────────────────────────┐
+│ LAYER 3: Tool & IDE Adapters                           │
+│ .cursorrules • CLAUDE.md • .vscode/ • .gemini/        │
+└────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 2. Stability Matrix (v1.0.0 Freeze)
+
+To prevent breaking changes, protocol definitions are designated as **Stable** or **Experimental**:
+
+### A. Stable Protocol Components
+These features are fully frozen. No breaking changes or renaming will occur in v1.0:
+- **Core Workspace Contracts:** The names and root directories of `AGENTS.md`, `MEMORY.md`, `TASKS.md`, and `RUNBOOK.md` are completely frozen.
+- **Scaffolding Subfolders:** Target folders `.ai/context/`, `.ai/skills/`, and `.ai/session-logs/` are strictly required by the sync CLI.
+- **Adapters Interface:** Mappings to Cursor (`.cursorrules`), Claude (`CLAUDE.md`), VS Code (`.vscode/settings.json`), and Gemini (`GEMINI.md`) are guaranteed.
+- **Core Commands:** Subcommands `init`, `verify`, `validate`, `doctor`, and `templates` will retain their signatures.
+
+### B. Experimental Components
+These components represent early specs and may undergo minor tweaks in future minor releases:
+- **Caveman Mode Custom Overrides:** Custom manual template modifications under `.ai/templates/`.
+- **Dynamic Context Routing:** Pre-implementation check validations inside `.ai/checks/context-budget.md`.
+
+---
+
+## 3. CLI Command Contracts
+
+All compliant MultiModel Dev OS CLIs must strictly support the following execution contracts:
+- **`init` Scaffolding:** Recursively writes root documents and links requested adapters.
+- **`validate` Quality Gate:** Asserts that required folders and enabled adapter rules exist on disk.
+- **`doctor` Diagnostic:** Advisory audit of `.gitignore` setups and folder compatibility.
+- **`templates` Inspector:** Displays available stack configurations.

package/docs/public/assets/ai-dev-os-roadmap.svg

@@ -0,0 +1,66 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 250" width="100%" height="100%" style="border-radius: 12px; font-family: 'Outfit', 'Inter', -apple-system, sans-serif; box-shadow: 0 20px 50px rgba(0,0,0,0.4);">
+  <defs>
+    <!-- Background Gradient -->
+    <linearGradient id="roadmapBg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#070a13" />
+      <stop offset="100%" stop-color="#0c101b" />
+    </linearGradient>
+
+    <!-- Roadmap Accent Line -->
+    <linearGradient id="lineGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#6366f1" />
+      <stop offset="50%" stop-color="#8b5cf6" />
+      <stop offset="100%" stop-color="#10b981" />
+    </linearGradient>
+  </defs>
+
+  <!-- Frame Background -->
+  <rect width="800" height="250" rx="12" fill="url(#roadmapBg)" stroke="#1e293b" stroke-width="1.5"/>
+
+  <!-- Title -->
+  <text x="400" y="45" font-size="20" font-weight="800" fill="#ffffff" text-anchor="middle" letter-spacing="1">5-DAY AI DEV OS ADOPTION ROADMAP</text>
+  <text x="400" y="68" font-size="13" font-weight="500" fill="#94a3b8" text-anchor="middle">Milestones to achieve structured multi-agent workflow reuse inside teams</text>
+
+  <!-- Connection Line -->
+  <line x1="80" y1="140" x2="720" y2="140" stroke="url(#lineGrad)" stroke-width="4"/>
+
+  <!-- Day 1 Node -->
+  <g transform="translate(100, 140)">
+    <circle cx="0" cy="0" r="14" fill="#6366f1" stroke="#ffffff" stroke-width="2"/>
+    <text x="0" y="30" font-size="12" font-weight="800" fill="#a5b4fc" text-anchor="middle">DAY 1</text>
+    <text x="0" y="45" font-size="11" font-weight="700" fill="#ffffff" text-anchor="middle">Scaffold CLI</text>
+    <text x="0" y="58" font-size="9" fill="#94a3b8" text-anchor="middle">npx init</text>
+  </g>
+
+  <!-- Day 2 Node -->
+  <g transform="translate(250, 140)">
+    <circle cx="0" cy="0" r="14" fill="#4f46e5" stroke="#ffffff" stroke-width="2"/>
+    <text x="0" y="30" font-size="12" font-weight="800" fill="#a5b4fc" text-anchor="middle">DAY 2</text>
+    <text x="0" y="45" font-size="11" font-weight="700" fill="#ffffff" text-anchor="middle">Project Memory</text>
+    <text x="0" y="58" font-size="9" fill="#94a3b8" text-anchor="middle">AGENTS.md core</text>
+  </g>
+
+  <!-- Day 3 Node -->
+  <g transform="translate(400, 140)">
+    <circle cx="0" cy="0" r="14" fill="#8b5cf6" stroke="#ffffff" stroke-width="2"/>
+    <text x="0" y="30" font-size="12" font-weight="800" fill="#d8b4fe" text-anchor="middle">DAY 3</text>
+    <text x="0" y="45" font-size="11" font-weight="700" fill="#ffffff" text-anchor="middle">Skills &amp; Checks</text>
+    <text x="0" y="58" font-size="9" fill="#94a3b8" text-anchor="middle">Custom prompt packs</text>
+  </g>
+
+  <!-- Day 4 Node -->
+  <g transform="translate(550, 140)">
+    <circle cx="0" cy="0" r="14" fill="#a855f7" stroke="#ffffff" stroke-width="2"/>
+    <text x="0" y="30" font-size="12" font-weight="800" fill="#d8b4fe" text-anchor="middle">DAY 4</text>
+    <text x="0" y="45" font-size="11" font-weight="700" fill="#ffffff" text-anchor="middle">Mount Adapters</text>
+    <text x="0" y="58" font-size="9" fill="#94a3b8" text-anchor="middle">Claude/Cursor sync</text>
+  </g>
+
+  <!-- Day 5 Node -->
+  <g transform="translate(700, 140)">
+    <circle cx="0" cy="0" r="14" fill="#10b981" stroke="#ffffff" stroke-width="2"/>
+    <text x="0" y="30" font-size="12" font-weight="800" fill="#34d399" text-anchor="middle">DAY 5</text>
+    <text x="0" y="45" font-size="11" font-weight="700" fill="#ffffff" text-anchor="middle">Audit &amp; Verify</text>
+    <text x="0" y="58" font-size="9" fill="#94a3b8" text-anchor="middle">Linter in CI/CD</text>
+  </g>
+</svg>

package/docs/public/assets/cost-optimization.svg

@@ -0,0 +1,155 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 950 550" width="100%" height="100%" style="border-radius: 12px; font-family: 'Outfit', 'Inter', -apple-system, sans-serif; box-shadow: 0 20px 50px rgba(0,0,0,0.45);">
+  <defs>
+    <!-- Background Gradient -->
+    <linearGradient id="chartBg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#0a0e17" />
+      <stop offset="100%" stop-color="#0f1626" />
+    </linearGradient>
+
+    <!-- Card Backgrounds -->
+    <linearGradient id="cardGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#ffffff" stop-opacity="0.06" />
+      <stop offset="100%" stop-color="#ffffff" stop-opacity="0.01" />
+    </linearGradient>
+    
+    <!-- Accent line -->
+    <linearGradient id="glowG" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#6366f1" />
+      <stop offset="50%" stop-color="#8b5cf6" />
+      <stop offset="100%" stop-color="#10b981" />
+    </linearGradient>
+  </defs>
+
+  <!-- Frame Background -->
+  <rect width="950" height="550" rx="12" fill="url(#chartBg)" stroke="#1e293b" stroke-width="1.5"/>
+  <rect x="0" y="0" width="950" height="2.5" fill="url(#glowG)"/>
+
+  <!-- Title Section -->
+  <text x="475" y="40" font-size="22" font-weight="900" fill="#ffffff" text-anchor="middle" letter-spacing="1">12 LLM COST &amp; CONTEXT OPTIMIZATION STRATEGIES</text>
+  <text x="475" y="60" font-size="12" font-weight="500" fill="#94a3b8" text-anchor="middle">Pragmatic mappings directly integrated into the MultiModel Dev OS workspace layer</text>
+
+  <!-- 12-Card Grid Layout (4 columns x 3 rows) -->
+  <!-- Column width = 205, Row height = 110. Spacing X = 15, Spacing Y = 15. Start X = 40, Start Y = 80 -->
+
+  <!-- ROW 1 -->
+  <!-- Card 1: Right Model -->
+  <g transform="translate(40, 80)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#818cf8">1. CHOOSE RIGHT MODEL</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: model-map.md</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Matches task complexity to</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">the ideal cost-efficient LLM.</text>
+  </g>
+
+  <!-- Card 2: Reduce Input -->
+  <g transform="translate(260, 80)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#a78bfa">2. REDUCE INPUT TOKENS</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: Caveman Mode</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Strips descriptors to save</text>
+    <text x="15" y="85" font-size="9.5" fill="#34d399" font-weight="700">~79% token context footprint.</text>
+  </g>
+
+  <!-- Card 3: Limit Output -->
+  <g transform="translate(480, 80)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#f472b6">3. LIMIT OUTPUT TOKENS</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: Output contracts</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Enforces concise formatting</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">rules inside prompts folder.</text>
+  </g>
+
+  <!-- Card 4: Reusable Prompts -->
+  <g transform="translate(700, 80)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#38bdf8">4. REUSABLE PROMPTS</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: .ai/prompts/</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Deploy plug-and-play</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">system instruction templates.</text>
+  </g>
+
+  <!-- ROW 2 -->
+  <!-- Card 5: Scoped Context -->
+  <g transform="translate(40, 205)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#fb7185">5. SCOPED CONTEXT (RAG)</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: .ai/context/</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Segments files into isolated</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">scoped project briefs.</text>
+  </g>
+
+  <!-- Card 6: Batch Requests -->
+  <g transform="translate(260, 205)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#34d399">6. BATCH REQUESTS</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: TASKS.md</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Groups simple subtasks so</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">agents build in single turns.</text>
+  </g>
+
+  <!-- Card 7: Structured Outputs -->
+  <g transform="translate(480, 205)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#fbbf24">7. STRUCTURED OUTPUTS</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: .ai/templates/</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Strict markdown structures</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">prevent repetitive regenerations.</text>
+  </g>
+
+  <!-- Card 8: Templates & Skills -->
+  <g transform="translate(700, 205)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#a78bfa">8. REUSE SKILLS</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: .ai/skills/</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Reusable commands packs</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">standardize developer steps.</text>
+  </g>
+
+  <!-- ROW 3 -->
+  <!-- Card 9: Two-Step Workflows -->
+  <g transform="translate(40, 330)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#34d399">9. TWO-STEP AGENTS</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: Planner/Coder</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Decouples layout design from</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">low-cost iterative code write.</text>
+  </g>
+
+  <!-- Card 10: Monitor Token Sinks -->
+  <g transform="translate(260, 330)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#fb7185">10. MONITOR TOKENS</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: doctor / validate</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">CLI linter assertions check</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">and warn on bloated rule lists.</text>
+  </g>
+
+  <!-- Card 11: Task Strength -->
+  <g transform="translate(480, 330)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#818cf8">11. STRENGTH ROUTING</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: model-map.md</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Matches auditor tasks to</text>
+    <text x="15" y="85" font-size="9.5" fill="#94a3b8">specific specialized LLMs.</text>
+  </g>
+
+  <!-- Card 12: Compact Summaries -->
+  <g transform="translate(700, 330)">
+    <rect width="205" height="110" rx="8" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" />
+    <text x="15" y="25" font-size="12" font-weight="800" fill="#c084fc">12. COMPACT SUMMARIES</text>
+    <text x="15" y="48" font-size="11" font-weight="700" fill="#ffffff">Mapped: Handoff templates</text>
+    <text x="15" y="70" font-size="9.5" fill="#94a3b8">Structured session logs pass</text>
+    <text x="15" y="85" font-size="9.5" fill="#34d399" font-weight="700">clean state, reducing drift.</text>
+  </g>
+
+  <!-- Footer Shell Area -->
+  <g transform="translate(40, 465)">
+    <rect width="870" height="50" rx="10" fill="#090d16" stroke="#334155" stroke-width="1" />
+    <!-- Window controls Mac-style inside footer -->
+    <circle cx="20" cy="25" r="4.5" fill="#ff5f56" />
+    <circle cx="32" cy="25" r="4.5" fill="#ffbd2e" />
+    <circle cx="44" cy="25" r="4.5" fill="#27c93f" />
+    <!-- Command text -->
+    <text x="70" y="30" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="14" fill="#34d399" font-weight="bold">$ <tspan fill="#e2e8f0">npx multimodel-dev-os@latest validate --target ./my-app</tspan></text>
+  </g>
+</svg>

package/docs/release-policy.md

@@ -0,0 +1,33 @@
+# Release Policy
+
+This document defines the versioning guidelines and standard practices for public releases of the MultiModel Dev OS protocol and CLI tool.
+
+---
+
+## 1. Semantic Versioning Commitments
+
+MultiModel Dev OS strictly adheres to **Semantic Versioning 2.0.0 (SemVer)**:
+- **Major Releases (X.y.z)**: Incremented when backward-incompatible changes are made to the Layer 1-3 protocol or CLI signatures.
+- **Minor Releases (x.Y.z)**: Incremented when new features, optional templates, or backward-compatible adapters are added.
+- **Patch Releases (x.y.Z)**: Incremented for backward-compatible bug fixes, docs corrections, or verification improvements.
+
+---
+
+## 2. Breaking Changes Definition
+
+A modification is defined as a **breaking change** if it:
+1. Renames or deletes any of the frozen Layer 1 root contracts (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`).
+2. Alters standard directory structures (`.ai/context/`, `.ai/skills/`).
+3. Breaks existing CLI command signatures or required inputs.
+
+Any such changes are prohibited outside of new major version releases (e.g., `2.0.0`).
+
+---
+
+## 3. Pre-Flight Verification Gates
+
+No package shall be merged or released without:
+- Passing all checks inside the `scripts/verify.js` release verification suite.
+- Building the documentation site without dead links (`npm run docs:build`).
+- Running packaging validation (`npm pack --dry-run`).
+- Executing smoke tests on all templates.

package/docs/stable-protocol.md

@@ -0,0 +1,66 @@
+# Stable Protocol Specification (v1.0.0 Freeze)
+
+This document formalizes the official, frozen architectural layers and design contracts for the MultiModel Dev OS protocol, guaranteeing portability and long-term stability.
+
+---
+
+## 1. Frozen Layers Architecture
+
+MultiModel Dev OS enforces a three-tier design to decouple core workspace context from individual IDE adapters:
+
+```
+┌────────────────────────────────────────────────────────┐
+│ LAYER 1: Root Contracts (Single Source of Truth)       │
+│ AGENTS.md • MEMORY.md • TASKS.md • RUNBOOK.md          │
+│ Status: FROZEN                                         │
+└──────────────────────────┬─────────────────────────────┘
+                           │ Centralizes project context
+┌──────────────────────────▼─────────────────────────────┐
+│ LAYER 2: Configuration & Modules (.ai/)                │
+│ context/ • agents/ • skills/ • prompts/ • checks/      │
+│ Status: FROZEN                                         │
+└──────────────────────────┬─────────────────────────────┘
+                           │ Routes files dynamically
+┌──────────────────────────▼─────────────────────────────┐
+│ LAYER 3: Tool & IDE Adapters                           │
+│ .cursorrules • CLAUDE.md • .vscode/ • .gemini/        │
+│ Status: FROZEN                                         │
+└────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 2. Layer 1: Root Contracts
+
+The following root files serve as the workspace single source of truth and are completely frozen:
+- **`AGENTS.md`**: Defines team structures, boundaries, and model configurations.
+- **`MEMORY.md`**: Preserves key context decisions, codebase state, and repository milestones.
+- **`TASKS.md`**: Tracks current active goals and backlog.
+- **`RUNBOOK.md`**: Operational scripts and workspace verify procedures.
+
+---
+
+## 3. Layer 2: Scaffolding Layout
+
+The following directories and files under `.ai/` are strictly locked:
+- **`.ai/config.yaml`**: Standard configuration file mapping templates and active adapters.
+- **`.ai/context/`**: Standard markdown files containing architecture guidelines, briefs, and SEO rules.
+- **`.ai/skills/`**: High-frequency modular instructions for agent workflows.
+- **`.ai/session-logs/`**: Standard directory for tracking agent workspace operations.
+
+---
+
+## 4. Layer 3: Adapters Setup
+
+IDE adapters translate centralized rules to tool-specific paths:
+- **Cursor**: Linked via root `.cursorrules`
+- **Claude**: Linked via root `CLAUDE.md`
+- **Gemini**: Linked via `.gemini/settings.json`
+- **VS Code**: Linked via `.vscode/settings.json`
+
+---
+
+## 5. Experimental vs. Stable Scope
+
+- **Stable**: Root files, scaffolding directories, CLI subcommand signatures, and standard config structures.
+- **Experimental**: Custom check overrides under `.ai/checks/` and stack-specific context routing.

package/docs/support-policy.md

@@ -0,0 +1,26 @@
+# Support Policy
+
+This document defines the lifecycle, support channels, and bug-triaging guidelines for the MultiModel Dev OS.
+
+---
+
+## 1. Support Lifecycle
+
+We are committed to maintaining a stable experience for developers:
+- **Long-Term Support (LTS)**: The frozen `v1.0.0` protocol and CLI will receive security updates and critical bug fixes for at least 12 months post-release.
+- **Backward Compatibility Guarantee**: All `1.x` minor releases will remain fully backward compatible with configurations created under `v1.0.0`.
+
+---
+
+## 2. Issue Triage and Bug Reports
+
+If you encounter issues with the scaffolding or validation commands:
+1. Run `multimodel-dev-os doctor` to run advisory diagnostics.
+2. Ensure your local folder structure complies with the specifications defined in `docs/stable-protocol.md`.
+3. Submit bug reports using our GitHub Issue templates under the `.github/ISSUE_TEMPLATE/` directory.
+
+---
+
+## 3. Security Vulnerability Disclosures
+
+Please do not open public issues for security bugs. Report vulnerabilities directly to the maintainers as described in the `SECURITY.md` file in the repository root.