multimodel-dev-os 0.7.0 → 1.0.0

package/.ai/schema/adapter.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MultiModel Dev OS Adapter Schema",
+  "description": "JSON schema reference detailing tool/IDE adapter expected boundaries and setup layouts",
+  "type": "OBJECT",
+  "required": ["adapterName", "targetFile", "setupDocs"],
+  "properties": {
+    "adapterName": {
+      "type": "STRING",
+      "description": "Unique identifier of the target programming tool (e.g. cursor, claude)"
+    },
+    "targetFile": {
+      "type": "STRING",
+      "description": "The rule configuration file mapped by the adapter"
+    },
+    "setupDocs": {
+      "type": "STRING",
+      "description": "Relative reference to the adapter setup markdown instructions"
+    },
+    "requiredRootFiles": {
+      "type": "ARRAY",
+      "items": { "type": "STRING" },
+      "description": "Root workspace contracts verified by the adapter schema"
+    }
+  },
+  "additionalProperties": false
+}

package/.ai/schema/config.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MultiModel Dev OS Config Schema",
+  "description": "JSON schema reference validating standard .ai/config.yaml workspace settings",
+  "type": "OBJECT",
+  "required": ["version", "adapters"],
+  "properties": {
+    "version": {
+      "type": "STRING",
+      "description": "The configuration protocol version matching semantic limits"
+    },
+    "adapters": {
+      "type": "OBJECT",
+      "description": "Enabled state of target IDE and terminal programming adapters",
+      "properties": {
+        "codex": { "type": "BOOLEAN" },
+        "antigravity": { "type": "BOOLEAN" },
+        "cursor": { "type": "BOOLEAN" },
+        "claude": { "type": "BOOLEAN" },
+        "gemini": { "type": "BOOLEAN" },
+        "vscode": { "type": "BOOLEAN" }
+      },
+      "additionalProperties": false
+    },
+    "caveman": {
+      "type": "BOOLEAN",
+      "description": "Toggled state of minimal-token prompt rules"
+    },
+    "template": {
+      "type": "STRING",
+      "description": "Selected baseline technology stack template name"
+    }
+  },
+  "additionalProperties": false
+}

package/.ai/schema/template.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MultiModel Dev OS Template Schema",
+  "description": "JSON schema reference defining expectations for pre-configured stack templates",
+  "type": "OBJECT",
+  "required": ["name", "requiredFiles"],
+  "properties": {
+    "name": {
+      "type": "STRING",
+      "description": "The unique identifying template name"
+    },
+    "description": {
+      "type": "STRING",
+      "description": "A description of the technology stack profile"
+    },
+    "requiredFiles": {
+      "type": "ARRAY",
+      "items": { "type": "STRING" },
+      "description": "Baseline contracts and subfolders required to scaffold"
+    },
+    "optionalFiles": {
+      "type": "ARRAY",
+      "items": { "type": "STRING" },
+      "description": "Optional overrides or specific skill prompts files"
+    },
+    "supportedAdapters": {
+      "type": "ARRAY",
+      "items": { "type": "STRING" },
+      "description": "IDE and terminal adapters validated for the template"
+    }
+  },
+  "additionalProperties": false
+}

package/README.md

@@ -1,69 +1,189 @@
 # MultiModel Dev OS
 
-Portable, vendor-neutral workspace configuration layer for multi-agent coding loops.
+[![NPM Version](https://img.shields.io/npm/v/multimodel-dev-os.svg?color=blue&style=flat-square)](https://www.npmjs.com/package/multimodel-dev-os)
+[![License](https://img.shields.io/npm/l/multimodel-dev-os.svg?color=green&style=flat-square)](https://github.com/rizvee/multimodel-dev-os/blob/main/LICENSE)
+[![GitHub Release](https://img.shields.io/github/v/release/rizvee/multimodel-dev-os?color=indigo&style=flat-square)](https://github.com/rizvee/multimodel-dev-os/releases)
+[![Build Verification](https://img.shields.io/github/actions/workflow/status/rizvee/multimodel-dev-os/verify.yml?branch=main&style=flat-square&label=verification)](https://github.com/rizvee/multimodel-dev-os/actions)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-emerald.svg?style=flat-square)](https://github.com/rizvee/multimodel-dev-os/blob/main/CONTRIBUTING.md)
+
+---
+
+## One portable AI Dev OS for Codex, Antigravity, Cursor, Claude, Gemini, VS Code, and multimodel coding workflows.
+
+Initialize a unified, tool-neutral AI developer workspace instantly:
+
+```bash
+npx multimodel-dev-os@latest init
+```
+
+> **Give every AI coding agent the same project brain.**
 
 ---
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/assets/social-preview.svg" alt="MultiModel Dev OS Banner" width="100%">
+  <img src="assets/social-preview.svg" alt="MultiModel Dev OS Banner" width="100%">
 </p>
 
 ---
 
-## Quickstart
+## Why This Exists
 
-Initialize a unified, tool-neutral AI developer workspace instantly:
+AI pair programmers are lightning-fast, but switching between them introduces context fragmentation:
+1. **Context Loss:** You use **Cursor** for autocomplete, **Claude Code** for command execution, and **Gemini/Antigravity** for deep audits. Every switch forces you to rebuild context.
+2. **Instruction Drift:** Different tools look for different config files (`.cursorrules`, `CLAUDE.md`, `.vscode/settings.json`, `.gemini/settings.json`). Modifying style rules or build parameters in one place leaves the others outdated.
+
+`multimodel-dev-os` solves this by establishing a single source of truth in your repository: four root contracts (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`) and a `.ai/` directory that bridges them to all major tools dynamically.
+
+---
+
+## What You Get
+
+A standard installation scaffolds a lightweight, zero-runtime-dependency workspace hierarchy:
 
-```bash
-npx multimodel-dev-os@latest init
 ```
+┌────────────────────────────────────────────────────────┐
+│ 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/        │
+└────────────────────────────────────────────────────────┘
+```
+
+<p align="center">
+  <img src="assets/architecture-preview.svg" alt="Architecture Diagram" width="100%">
+</p>
 
 ---
 
-## See It in Action
+## Supported Tools
+
+| Tool / Agent | Target Adapter File | Setup Instructions | Behavior Setup |
+| :--- | :--- | :--- | :--- |
+| **Cursor** | `.cursorrules` | `adapters/cursor/setup.md` | Inline autocomplete guidelines |
+| **Claude Code** | `CLAUDE.md` | `adapters/claude/setup.md` | Terminal build and run controls |
+| **VS Code** | `.vscode/settings.json` | `adapters/vscode/setup.md` | Editor layout and search limits |
+| **Gemini** | `GEMINI.md` | `adapters/gemini/setup.md` | Prompt system context logs |
+| **Antigravity** | `.gemini/settings.json` | `adapters/antigravity/setup.md` | Security and audit parameters |
+| **Codex** | `adapters/codex/AGENTS.md` | `adapters/codex/setup.md` | Automated code scaffolding |
+
+---
 
-`multimodel-dev-os` runs completely on native Node.js libraries, keeping execution speeds lightning-fast with **zero third-party NPM runtime dependencies**. Here is the clean interactive terminal sequence executing `init`, `validate`, and `doctor` commands:
+## Why Not Just a Manual AGENTS.md?
+
+While you can write a raw markdown file manually, `multimodel-dev-os` offers a standardized development workflow:
+
+| Feature | Manual Rules File | MultiModel Dev OS |
+| :--- | :--- | :--- |
+| **Tool Synchronization** | Manual copy-paste across tools | Automated dynamic adapters |
+| **Context Budgets** | Bloats prompts, wasting cost | **Caveman Mode** slashes tokens by **~79%** |
+| **Standards Enforcement**| Easy to drift and corrupt | Built-in CLI `validate` and `doctor` checks |
+| **Onboarding baseline**  | Start from scratch | 5 production-ready real-world templates |
+
+---
+
+## Interactive Command Line Interface (CLI)
+
+MultiModel Dev OS is powered by a pure Node.js CLI with **zero runtime external npm dependencies**.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/assets/terminal-demo.svg" alt="Terminal Demo Sequence" width="100%">
+  <img src="assets/terminal-demo.svg" alt="Terminal Demo Sequence" width="100%">
 </p>
 
+### 1. Scaffolding Templates
+Initialize customized stack specifications:
+- **Next.js SaaS:** `npx multimodel-dev-os@latest init --template nextjs-saas`
+- **WordPress Theme/Plugin:** `npx multimodel-dev-os@latest init --template wordpress-site`
+- **E-Commerce Store:** `npx multimodel-dev-os@latest init --template ecommerce-store`
+- **SEO Landing Page:** `npx multimodel-dev-os@latest init --template seo-landing-page`
+- **General Fallback:** `npx multimodel-dev-os@latest init --template general-app`
+
+### 2. Adapter Linking
+Inject rules specifically for a developer tool:
+```bash
+npx multimodel-dev-os@latest init --adapter cursor
+npx multimodel-dev-os@latest init --adapter claude
+```
+
+### 3. Caveman Mode (Token Optimizer)
+Cuts prompt rules overhead down by **~79%** using highly optimized short-hand declarations:
+```bash
+npx multimodel-dev-os@latest init --caveman
+```
+
+### 4. Quality Gates
+Run assertions and diagnostic checkups:
+- **`validate`** (Strict schema checkup): `npx multimodel-dev-os validate`
+- **`doctor`** (Advisory compatibility warning): `npx multimodel-dev-os doctor`
+
 ---
 
-## Before vs. After
+## Cost & Context Optimization
 
-### Before: Chaotic Prompting & Instruction Drift
-- Switching between agents (like Cursor, Claude Code, Gemini, Codex) requires maintaining duplicate instruction files (`.cursorrules`, `CLAUDE.md`, `.vscode/settings.json`, etc.).
-- Modifying guidelines in one place results in immediate **Instruction Drift**, where one agent operates on outdated conventions, causing compile crashes.
-- Duplicate instructions bloat prompts, wasting **1,500+ tokens** of model context budget on every single turn.
+Minimize prompt overhead and API billing by mapping key context-reduction techniques to MultiModel Dev OS features:
+
+<p align="center">
+  <img src="assets/cost-optimization.svg" alt="Cost Optimization Funnel" width="100%">
+</p>
 
-### After: Standardized Zero-Drift Sync
-- Rules are defined once in a central root document (`AGENTS.md` and `.ai/`).
-- MultiModel Dev OS dynamically routes the root contract directly to Cursor, Claude Code, Gemini, and VS Code. All agents operate on matching build specifications instantly.
-- Toggling **Caveman Mode** dynamically strips descriptions and examples, saving **~79% of token context** per chat turn.
+For a full deep dive, see our [Cost Optimization Playbook](https://rizvee.github.io/multimodel-dev-os/cost-optimization).
 
 ---
 
-## Sync Architecture
+## 5-Day Adoption Roadmap
 
-`multimodel-dev-os` decouples your instructions from specific IDE extensions and model APIs:
+Deploying MultiModel Dev OS across your team is straightforward and tool-neutral:
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/assets/architecture-preview.svg" alt="Sync Architecture" width="100%">
+  <img src="assets/ai-dev-os-roadmap.svg" alt="5-Day Adoption Roadmap" width="100%">
 </p>
 
+See our step-by-step timeline: [5-Day Adoption Roadmap Playbook](https://rizvee.github.io/multimodel-dev-os/5-day-roadmap).
+
+---
+
+## Real-World Case Studies
+
+Discover how engineering teams deploy MultiModel Dev OS:
+- 📦 [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)
+
+---
+
+## Stable Protocol Specification
+
+MultiModel Dev OS version `v1.0.0` officially freezes the Layer 1, Layer 2, and Layer 3 specifications:
+- 🛡️ [Stable Protocol Specification](https://rizvee.github.io/multimodel-dev-os/stable-protocol)
+- 🔌 [Multi-Agent Compatibility Guides](https://rizvee.github.io/multimodel-dev-os/compatibility)
+- 📈 [Upgrade & Migration Guide](https://rizvee.github.io/multimodel-dev-os/migration-guide)
+- 🏁 [v1.0.0 Release Quality Checklist](https://rizvee.github.io/multimodel-dev-os/v1-checklist)
+
+---
+
+## Contributing
+
+We love contributions! Propose new adapters, request built-in templates, or report issues safely.
+Read our [Contributing Onboarding Guidelines](CONTRIBUTING.md) to get started.
+
 ---
 
-## Core Navigation Guides
+## Docs Site
 
-Explore our detailed manuals directly:
-- 📖 [CLI Terminal Demo Guide](https://rizvee.github.io/multimodel-dev-os/demo)
-- 💡 [Before/After Workflow Case Studies](https://rizvee.github.io/multimodel-dev-os/workflow-examples)
-- 🛡️ [Public Release & Staging Checklist](https://rizvee.github.io/multimodel-dev-os/launch-checklist)
-- 📦 [Standard Template Gallery](https://rizvee.github.io/multimodel-dev-os/templates/)
+Explore detailed specifications, guides, and playbooks at the official docs portal:
+👉 **[https://rizvee.github.io/multimodel-dev-os/](https://rizvee.github.io/multimodel-dev-os/)**
 
 ---
 
 ## License
 
-MIT License.
+MIT License. Copyright (c) 2026-present MultiModel Dev OS team.

package/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/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/bin/multimodel-dev-os.js

@@ -202,6 +202,7 @@ function handleInit(options) {
   // Source path mapping for core files
   let templateDir = join(sourceRoot, 'examples', options.template);
   if (!existsSync(templateDir)) {
+    console.warn(`  \x1b[33m[WARNING] Template '${options.template}' not found. Falling back to 'general-app' profile.\x1b[0m`);
     templateDir = join(sourceRoot, 'examples', 'general-app');
   }
 

package/docs/.vitepress/config.js

@@ -21,6 +21,35 @@ export default {
           { text: 'FAQ', link: '/faq' }
         ]
       },
+      {
+        text: 'Protocol & QA Specifications',
+        items: [
+          { text: 'Protocol Specification', link: '/protocol' },
+          { text: 'Stable Protocol Specification', link: '/stable-protocol' },
+          { text: 'Adapter Compatibility', link: '/compatibility' },
+          { text: 'Upgrades & Migration', link: '/migration-guide' },
+          { text: 'Templates QA Blueprint', link: '/template-qa' },
+          { text: 'v1.0.0 Readiness Checklist', link: '/v1-readiness' }
+        ]
+      },
+      {
+        text: 'Case Studies & Playbooks',
+        items: [
+          { text: 'Case Studies Gallery', link: '/case-studies/' },
+          { text: 'Next.js SaaS Full-Stack', link: '/case-studies/nextjs-saas' },
+          { text: 'WordPress Theme & Plugins', link: '/case-studies/wordpress-site' },
+          { text: 'E-Commerce State webhooks', link: '/case-studies/ecommerce-store' },
+          { text: 'SEO Landing Page Performance', link: '/case-studies/seo-landing-page' },
+          { text: 'Multi-Model Handoff Protocols', link: '/case-studies/multimodel-handoff' }
+        ]
+      },
+      {
+        text: 'Adoption & Optimization',
+        items: [
+          { text: 'Cost Optimization Playbook', link: '/cost-optimization' },
+          { text: '5-Day Adoption Roadmap', link: '/5-day-roadmap' }
+        ]
+      },
       {
         text: 'Core Features',
         items: [
@@ -46,7 +75,11 @@ export default {
           { text: 'Release Playbook Template', link: '/release-template' },
           { text: 'CLI Roadmap', link: '/cli-roadmap' },
           { text: 'NPM Publishing Runbook', link: '/npm-publishing' },
-          { text: 'Pre-flight Release Testing', link: '/testing-v0.2' }
+          { text: 'Pre-flight Release Testing', link: '/testing-v0.2' },
+          { text: 'Release Policy', link: '/release-policy' },
+          { text: 'Support Policy', link: '/support-policy' },
+          { text: 'Final Launch Guidelines', link: '/final-launch' },
+          { text: 'v1.0.0 Release Checklist', link: '/v1-checklist' }
         ]
       }
     ],