multimodel-dev-os 0.6.1 → 0.8.0

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/public/assets/social-preview.svg

@@ -0,0 +1,72 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 640" width="100%" height="100%" style="font-family: 'Outfit', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+  <defs>
+    <!-- Dark Background -->
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#070a13" />
+      <stop offset="50%" stop-color="#0d111d" />
+      <stop offset="100%" stop-color="#04060b" />
+    </linearGradient>
+    
+    <!-- Indigo/Purple Accent -->
+    <linearGradient id="brandGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#6366f1" />
+      <stop offset="50%" stop-color="#8b5cf6" />
+      <stop offset="100%" stop-color="#10b981" />
+    </linearGradient>
+
+    <!-- Glassmorphic Card -->
+    <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>
+
+    <!-- Glow Effect -->
+    <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="45" result="blur" />
+      <feComposite in="SourceGraphic" in2="blur" operator="over" />
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1280" height="640" fill="url(#bgGrad)" />
+  
+  <!-- Backlight Glows -->
+  <circle cx="1100" cy="150" r="220" fill="#8b5cf6" opacity="0.15" filter="url(#glow)" />
+  <circle cx="180" cy="480" r="250" fill="#10b981" opacity="0.1" filter="url(#glow)" />
+
+  <!-- Outer Frames -->
+  <rect x="25" y="25" width="1230" height="590" rx="20" fill="none" stroke="#1e293b" stroke-width="2" />
+  <rect x="35" y="35" width="1210" height="570" rx="16" fill="none" stroke="url(#brandGrad)" stroke-width="1.5" opacity="0.2" />
+
+  <!-- Glassmorphic Card Container -->
+  <rect x="80" y="80" width="1120" height="480" rx="24" fill="url(#cardGrad)" stroke="#334155" stroke-width="1" stroke-opacity="0.4" style="backdrop-filter: blur(12px);" />
+
+  <!-- Brand Mark -->
+  <g transform="translate(130, 140)">
+    <rect width="100" height="100" rx="22" fill="url(#brandGrad)" />
+    <path d="M 32,50 L 50,32 L 68,50 L 50,68 Z" fill="#ffffff" />
+    <circle cx="50" cy="50" r="8" fill="#070a13" />
+  </g>
+
+  <!-- Titles -->
+  <text x="260" y="205" font-size="68" font-weight="900" fill="#ffffff" letter-spacing="-1.5">MultiModel Dev OS</text>
+  <text x="260" y="252" font-size="28" font-weight="700" fill="#a78bfa" letter-spacing="-0.5">One project brain for every AI coding agent</text>
+
+  <!-- Scaffolding Highlight Commands -->
+  <g transform="translate(130, 320)">
+    <!-- Command box -->
+    <rect width="520" height="75" rx="16" fill="#090d16" stroke="#4f46e5" stroke-width="2" />
+    <text x="30" y="47" font-family="'Fira Code', 'JetBrains Mono', monospace" font-size="22" font-weight="bold" fill="#34d399">$ <tspan fill="#e2e8f0">npx multimodel-dev-os@latest init</tspan></text>
+  </g>
+
+  <!-- Tools Covered Footer Matrix -->
+  <g transform="translate(130, 435)">
+    <!-- Divider -->
+    <line x1="0" y1="0" x2="1020" y2="0" stroke="#334155" stroke-width="1.5" stroke-opacity="0.6" />
+    
+    <!-- Tools text -->
+    <text x="0" y="45" font-size="22" font-weight="600" fill="#94a3b8" letter-spacing="1">
+      SUPPORTED WORKFLOWS: <tspan fill="#f8fafc">Codex</tspan> • <tspan fill="#f8fafc">Antigravity</tspan> • <tspan fill="#f8fafc">Cursor</tspan> • <tspan fill="#f8fafc">Claude</tspan> • <tspan fill="#f8fafc">Gemini</tspan> • <tspan fill="#f8fafc">VS Code</tspan>
+    </text>
+  </g>
+</svg>

package/docs/public/assets/terminal-demo.svg

@@ -0,0 +1,72 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 500" width="100%" height="100%" style="border-radius: 12px; font-family: 'Fira Code', 'JetBrains Mono', Consolas, Monaco, monospace; box-shadow: 0 20px 50px rgba(0,0,0,0.45);">
+  <defs>
+    <!-- Dark Terminal Background Gradient -->
+    <linearGradient id="termBg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#0a0e17" />
+      <stop offset="100%" stop-color="#0f1626" />
+    </linearGradient>
+    
+    <!-- Decorative Title Accent -->
+    <linearGradient id="titleAccent" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#6366f1" />
+      <stop offset="50%" stop-color="#a855f7" />
+      <stop offset="100%" stop-color="#10b981" />
+    </linearGradient>
+  </defs>
+
+  <!-- Shell Frame and Background -->
+  <rect width="800" height="500" rx="12" fill="url(#termBg)" stroke="#1e293b" stroke-width="1.5"/>
+  <rect x="0" y="0" width="800" height="2" fill="url(#titleAccent)"/>
+  
+  <!-- Title Bar -->
+  <path d="M 1 12 A 11 11 0 0 1 12 2 h 776 a 11 11 0 0 1 11 11 v 28 H 1 Z" fill="#0f172a"/>
+  
+  <!-- Window Controls -->
+  <circle cx="25" cy="22" r="6" fill="#ff5f56"/>
+  <circle cx="45" cy="22" r="6" fill="#ffbd2e"/>
+  <circle cx="65" cy="22" r="6" fill="#27c93f"/>
+  
+  <!-- Window Title -->
+  <text x="400" y="26" fill="#94a3b8" font-size="13" font-weight="600" text-anchor="middle" letter-spacing="0.5">bash - MultiModel Dev OS CLI</text>
+  
+  <!-- Terminal Content Console -->
+  <g font-size="13.5" fill="#e2e8f0" xml:space="preserve">
+    <!-- COMMAND 1: init -->
+    <text x="30" y="70" font-weight="bold">
+      <tspan fill="#38bdf8">~</tspan> <tspan fill="#f43f5e">❯</tspan> <tspan fill="#818cf8">npx</tspan> <tspan fill="#f472b6">multimodel-dev-os@latest</tspan> <tspan fill="#34d399">init</tspan> <tspan fill="#94a3b8">--template nextjs-saas --adapter codex</tspan>
+    </text>
+    
+    <!-- Scaffolding Output -->
+    <text x="30" y="95" fill="#a78bfa" font-weight="600">🧠 Scaffolding MultiModel Dev OS environment...</text>
+    <text x="50" y="115" fill="#34d399">✓ <tspan fill="#e2e8f0">Scaffolded root files</tspan> <tspan fill="#64748b">(AGENTS.md, MEMORY.md, TASKS.md, RUNBOOK.md)</tspan></text>
+    <text x="50" y="132" fill="#34d399">✓ <tspan fill="#e2e8f0">Enabled adapter</tspan> <tspan fill="#fb7185">codex</tspan> <tspan fill="#64748b">(.ai/config.yaml status = true)</tspan></text>
+    
+    <!-- COMMAND 2: validate -->
+    <text x="30" y="175" font-weight="bold">
+      <tspan fill="#38bdf8">~</tspan> <tspan fill="#f43f5e">❯</tspan> <tspan fill="#818cf8">npx</tspan> <tspan fill="#f472b6">multimodel-dev-os@latest</tspan> <tspan fill="#34d399">validate</tspan> <tspan fill="#94a3b8">--target ./my-app</tspan>
+    </text>
+    
+    <!-- Validate Output -->
+    <text x="30" y="200" fill="#a78bfa" font-weight="600">🛡️ Validating workspace structure compliance...</text>
+    <text x="50" y="220" fill="#34d399">✓ <tspan fill="#e2e8f0">Checked primary contract documents: 4/4 exist</tspan></text>
+    <text x="50" y="237" fill="#34d399">✓ <tspan fill="#e2e8f0">Validated .ai/config.yaml adapter constraints</tspan></text>
+    <text x="50" y="254" fill="#34d399">✓ <tspan fill="#34d399">Success:</tspan> <tspan fill="#e2e8f0">Workspace structure conforms to specifications</tspan></text>
+
+    <!-- COMMAND 3: doctor -->
+    <text x="30" y="295" font-weight="bold">
+      <tspan fill="#38bdf8">~</tspan> <tspan fill="#f43f5e">❯</tspan> <tspan fill="#818cf8">npx</tspan> <tspan fill="#f472b6">multimodel-dev-os@latest</tspan> <tspan fill="#34d399">doctor</tspan> <tspan fill="#94a3b8">--target ./my-app</tspan>
+    </text>
+    
+    <!-- Doctor Output -->
+    <text x="30" y="320" fill="#a78bfa" font-weight="600">🩺 Executing advisory checkups...</text>
+    <text x="50" y="340" fill="#34d399">✓ <tspan fill="#e2e8f0">Gitignore audit: Ignored cache folders (.vitepress/dist)</tspan></text>
+    <text x="50" y="357" fill="#34d399">✓ <tspan fill="#e2e8f0">Active adapters verify: Physical rule files mapped</tspan></text>
+    <text x="50" y="374" fill="#38bdf8">ℹ <tspan fill="#e2e8f0">Advisory: 0 warnings, workspace is operating at 100% efficiency</tspan></text>
+
+    <!-- Success banner -->
+    <text x="30" y="415" fill="#34d399" font-weight="bold">🚀 All Dev OS pipeline checkups completed successfully!</text>
+    
+    <!-- Next Active Prompt Cursor -->
+    <text x="30" y="455" fill="#f43f5e">❯ <tspan fill="#e2e8f0">█</tspan></text>
+  </g>
+</svg>

package/docs/quickstart.md

@@ -1,13 +1,15 @@
 # Quickstart
 
-Get multimodel-dev-os into your project in under 2 minutes.
+Get `multimodel-dev-os` integrated into your codebase in under 2 minutes.
+
+---
 
 ## Option A: NPX Scaffolding (Recommended)
 
 Initialize any project immediately without local clones using our public npm registry:
 
 ```bash
-# Standard interactive initialization in current directory
+# Standard interactive initialization in the current directory
 npx multimodel-dev-os@latest init
 
 # Target specific stack templates and specific tool adapters
@@ -17,6 +19,8 @@ npx multimodel-dev-os@latest init --template nextjs-saas --adapter cursor --adap
 npx multimodel-dev-os@latest init --dry-run
 ```
 
+---
+
 ## Option B: Fallback One-Line Scripts
 
 If you choose to run installation scripts directly:
@@ -31,6 +35,8 @@ curl -fsSL https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scrip
 irm https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.ps1 | iex
 ```
 
+---
+
 ## Option C: Caveman Mode (Minimal Tokens)
 
 Reduce token footprint by **~79%** with our lightweight variants:
@@ -39,6 +45,8 @@ Reduce token footprint by **~79%** with our lightweight variants:
 curl -fsSL https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.sh | bash -s -- --caveman
 ```
 
+---
+
 ## Option D: Node.js Local Scaffolding CLI
 
 For offline execution or customized packaging within a cloned workspace:
@@ -51,48 +59,31 @@ For offline execution or customized packaging within a cloned workspace:
    node bin/multimodel-dev-os.js init --target /path/to/your-project --template nextjs-saas --adapter cursor
    ```
 
-## Option E: Manual Scaffolding
-
-If you prefer absolute manual control over copying files:
-
-```bash
-git clone https://github.com/rizvee/multimodel-dev-os.git /tmp/mmdos
-cp /tmp/mmdos/AGENTS.md    your-project/
-cp /tmp/mmdos/MEMORY.md    your-project/
-cp /tmp/mmdos/TASKS.md     your-project/
-cp /tmp/mmdos/RUNBOOK.md   your-project/
-cp /tmp/mmdos/.gitattributes your-project/
-cp -r /tmp/mmdos/.ai       your-project/
-```
+---
 
 ## After Install
 
-1. **Edit `AGENTS.md`** — fill in your project name, stack, and build commands
-2. **Edit `.ai/config.yaml`** — enable adapters for your tools
+1. **Edit `AGENTS.md`** — fill in your project name, stack, and build commands.
+2. **Edit `.ai/config.yaml`** — enable adapters for your tools.
 3. **Copy adapter files** to your project root:
    - Cursor: `cp adapters/cursor/.cursorrules .cursorrules`
    - Claude: `cp adapters/claude/CLAUDE.md CLAUDE.md`
    - VS Code: `cp -r adapters/vscode/.vscode/ .vscode/`
-4. **Start coding** — your AI tools will read the shared config
+4. **Start coding** — your AI tools will read the shared configuration instantly.
+
+---
 
 ## Verify & Diagnose
 
 You can run our strict validation check or advisory doctor checkup to validate structural health:
+
 ```bash
 # Strict directory schema validation
-node bin/multimodel-dev-os.js validate --target /path/to/your-project
+node bin/multimodel-dev-os.js validate
 
 # Advisory doctor workspace compatibility audit
-node bin/multimodel-dev-os.js doctor --target /path/to/your-project
+node bin/multimodel-dev-os.js doctor
 
-# Legacy verification script
-node bin/multimodel-dev-os.js verify --target /path/to/your-project
+# Verify repository structure checks
+npm run verify
 ```
-
-## Next Steps
-
-- [Architecture overview](architecture.md)
-- [Adapter setup](adapters.md)
-- [Multi-agent workflows](multimodel-workflow.md)
-- [Caveman Mode](caveman-mode.md)
-- [NPM Publishing Runbook](npm-publishing.md)

package/docs/release-template.md

@@ -0,0 +1,74 @@
+# Patch & Release Playbook Template
+
+Use this playbook to prepare, audit, and announce releases. This document contains reusable release notes templates tailored for patch, minor, and major milestones.
+
+---
+
+## 1. Reusable Release Notes Templates
+
+### A. Patch Release Template (e.g., `v0.7.1`)
+Use this when releasing hotfixes, structural compliance patches, or minor configuration adjustments.
+
+```markdown
+## [vX.Y.Z] - YYYY-MM-DD (Patch Release)
+
+### Fixed
+- **[Fix Category]:** Detailed explanation of the bug and how it was resolved.
+- **[Adapter Sync]:** Fixed minor pathing issue in [Adapter Name] setup rules.
+
+### Performance
+- Optimized local verifier execution times by removing redundant filesystem lookups.
+
+---
+**Technical Integrity:** All 100+ release audit compliance checks pass successfully.
+```
+
+---
+
+### B. Minor Release Template (e.g., `v0.8.0`)
+Use this when introducing backward-compatible new features, stack templates, or command additions.
+
+```markdown
+## [vX.Y.0] - YYYY-MM-DD (Minor Feature Release)
+
+### Added
+- **[New Feature]:** Introduced [Feature Name] supporting automated [Activity Name].
+- **[New Template]:** Added [Template Name] real-world stack template for [Stack Name].
+- **[CLI Command]:** Implemented `npx multimodel-dev-os [command-name]` to execute [description].
+
+### Changed
+- **[Adapter Refactor]:** Upgraded [Adapter Name] rules mapping to support [New version specs].
+
+### Fixed
+- **[Linter Adjustments]:** Adjusted linter guidelines to prevent false-positives under specific workspace boundaries.
+```
+
+---
+
+### C. Major Release Template (e.g., `v1.0.0`)
+Use this for major milestones, breaking changes, or sweeping architectural overhauls.
+
+```markdown
+## [vX.0.0] - YYYY-MM-DD (Major Milestone Release)
+
+### 🚨 Breaking Changes
+- **[Abstractions Overhaul]:** Central root contracts have been restructured. [Detail the exact changes and how to migrate].
+- **[CLI Commands Deprecation]:** The legacy subcommand `[legacy-command]` has been deprecated in favor of `[new-command]`.
+
+### Added
+- **[Core Architecture]:** Implemented the new [Architectural Block Name] mapping protocol.
+- **[Universal Adaptability]:** Full integration and native support for [List of new tools].
+
+### Migration Guide
+1. Run `npx multimodel-dev-os@latest migrate` inside your target repository.
+2. Update your root configuration `AGENTS.md` to reflect the new schemas.
+```
+
+---
+
+## 2. Dynamic Release Pipeline Checklist
+- [ ] Bump version tag inside `package.json`.
+- [ ] Prepend release notes to `CHANGELOG.md` following the Keep a Changelog convention.
+- [ ] Execute `npm run verify` to test structural compliance.
+- [ ] Execute `npm run docs:build` to confirm website compilation success.
+- [ ] Run `npm pack --dry-run` to audit tarball cleanliness.

package/docs/workflow-examples.md

@@ -0,0 +1,74 @@
+# Before/After Workflow Case Studies
+
+Explore how `multimodel-dev-os` eliminates instruction drift and saves token budgets across multiple AI programming agents.
+
+---
+
+## 1. Before: Chaotic AI Prompting (The Old Way)
+
+In a typical modern development pipeline, developers switch between multiple agents to leverage their distinct strengths (Cursor for inline autocomplete, Claude Code for CLI scaffolding, Gemini for repository audits). 
+
+Without context standardizations, this leads to **Chaotic AI Prompting**:
+- **Manual Translation:** Every time a build script, staging path, or coding convention changes, the developer must manually edit `.cursorrules`, `CLAUDE.md`, and custom system instruction files.
+- **Instruction Drift:** One IDE agent inevitably operates on an outdated convention. For example, Cursor suggests database patterns that Claude Code already replaced, causing immediate syntax and compiler crashes.
+- **Context Bloat:** Boilerplate guidelines are copy-pasted across all files. Models consume **1,500+ tokens** of duplicate context on every single prompt turn, inflating API bills.
+
+---
+
+## 2. After: MultiModel Dev OS Workflow (The Standard)
+
+`multimodel-dev-os` establishes a single source of truth inside your repository root, dynamically routing updates across all specialized tools.
+
+```
+                  ┌──────────────────────┐
+                  │ AGENTS.md (Root Truth)│
+                  └──────────┬───────────┘
+                             │
+                  ┌──────────▼───────────┐
+                  │ MultiModel Dev OS    │
+                  └────┬───────────┬─────┘
+                       │           │
+          ┌────────────▼───┐   ┌───▼────────────┐
+          │  IDE Adapters  │   │  CLI Adapters  │
+          │ (Cursor, VS)   │   │ (Claude, Codex)│
+          └────────────────┘   └────────────────┘
+```
+
+---
+
+## 3. Real-World Task Workflows
+
+Here is how different agents execute their tasks under the standardized system:
+
+### A. Codex Scaffolding Task
+When **Codex** bootstraps components:
+1. Codex parses the central `AGENTS.md` package specs and `/adapters/codex/AGENTS.md` instructions.
+2. It operates exactly under the defined build scripts, generating matching component schemas instantly.
+3. No instructions drift; Codex is aware of the exact package-lock constraints of the repository.
+
+### B. Antigravity Auditing Task
+When **Antigravity** executes security/performance review audits:
+1. It reads `AGENTS.md` and respects the strict directory boundary rules defined under `no-touch` blocks.
+2. Antigravity executes compliance assertions against the active task backlog tracked inside `TASKS.md`.
+3. It performs checks under the shared stack guidelines without polluting directories or editing ignored configurations.
+
+### C. Cursor Autocomplete Task
+When **Cursor** guides inline coding:
+1. Cursor reads the dynamically generated `.cursorrules` located in the workspace root.
+2. The rules are synchronized with the central repository brain.
+3. Cursor suggests matching code styles and variables without recommending legacy APIs or outdated database fields.
+
+---
+
+## 4. The Claude / Gemini Sequential Handoff Protocol
+
+When pair programming requires switching between terminal-based execution (**Claude Code**) and deep-file analysis (**Gemini / Antigravity**), `multimodel-dev-os` uses the **Structured Session Log Handoff**:
+
+1. **Step 1 (Claude Code):** After finishing the terminal build, Claude Code summarizes its progress in `.ai/session-logs/session-001.md` utilizing the standard template. It logs:
+   - What changed
+   - Verification status
+   - Next planned steps
+2. **Step 2 (Gemini Pick-Up):** When the developer launches Gemini, the system feeds the last session log. Gemini reads `session-001.md` and instantly knows exactly where Claude Code left off.
+3. **Outcome:** Zero context drop, zero redundant questions, and pristine, seamless model hand-offs!
+
+For a detailed, step-by-step walk of this protocol in action, see our [Multi-Model Handoff Case Study](/case-studies/multimodel-handoff).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multimodel-dev-os",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "bin": {
     "multimodel-dev-os": "bin/multimodel-dev-os.js"
   },
@@ -34,7 +34,8 @@
     "!docs/.vitepress/dist/",
     "!docs/.vitepress/cache/",
     "examples/",
-    "bin/"
+    "bin/",
+    "assets/"
   ],
   "scripts": {
     "verify": "node scripts/verify.js",