multimodel-dev-os 1.0.0 → 1.1.0

package/README.md

@@ -1,10 +1,21 @@
 # MultiModel Dev OS
 
-[![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)
+<p align="center">
+  <img src="assets/logo.png" alt="MultiModel Dev OS Logo" width="160">
+</p>
+
+<p align="center">
+  <b>One portable AI Dev OS for multimodel coding workflows.</b>
+</p>
+
+<p align="center">
+  [![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)
+  [![NPM Package](https://img.shields.io/badge/npm-package-cb3837.svg?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)
+</p>
 
 ---
 
@@ -16,7 +27,7 @@ Initialize a unified, tool-neutral AI developer workspace instantly:
 npx multimodel-dev-os@latest init
 ```
 
-> **Give every AI coding agent the same project brain.**
+> **Give Codex, Antigravity, Cursor, Claude, Gemini, VS Code, and other AI coding agents the same project brain.**
 
 ---
 
@@ -67,12 +78,12 @@ A standard installation scaffolds a lightweight, zero-runtime-dependency workspa
 
 | Tool / Agent | Target Adapter File | Setup Instructions | Behavior Setup |
 | :--- | :--- | :--- | :--- |
+| **Codex** | `adapters/codex/AGENTS.md` | `adapters/codex/setup.md` | Automated code scaffolding |
+| **Antigravity** | `.gemini/settings.json` | `adapters/antigravity/setup.md` | Security and audit parameters |
 | **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 |
+| **VS Code** | `.vscode/settings.json` | `adapters/vscode/setup.md` | Editor layout and search limits |
 
 ---
 
@@ -162,7 +173,7 @@ Discover how engineering teams deploy MultiModel Dev OS:
 
 ## Stable Protocol Specification
 
-MultiModel Dev OS version `v1.0.0` officially freezes the Layer 1, Layer 2, and Layer 3 specifications:
+MultiModel Dev OS version `v1.1.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)
@@ -177,10 +188,13 @@ Read our [Contributing Onboarding Guidelines](CONTRIBUTING.md) to get started.
 
 ---
 
-## Docs Site
+## Docs & Staging Links
 
 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/)**
+👉 **[Documentation site](https://rizvee.github.io/multimodel-dev-os/)**
+👉 **[GitHub repository](https://github.com/rizvee/multimodel-dev-os)**
+👉 **[NPM registry](https://www.npmjs.com/package/multimodel-dev-os)**
+👉 **[llms.txt discoverability guide](https://rizvee.github.io/multimodel-dev-os/llms.txt)**
 
 ---
 

package/docs/.vitepress/config.js

@@ -3,6 +3,40 @@ export default {
   title: 'MultiModel Dev OS',
   description: 'Portable, vendor-neutral AI Developer OS for multi-agent coding workflows.',
   ignoreDeadLinks: true,
+  head: [
+    ['link', { rel: 'icon', href: '/multimodel-dev-os/favicon.png', type: 'image/png' }],
+    ['link', { rel: 'canonical', href: 'https://rizvee.github.io/multimodel-dev-os/' }],
+    ['meta', { name: 'theme-color', content: '#6366f1' }],
+    ['meta', { name: 'robots', content: 'index, follow' }],
+    ['meta', { name: 'application-name', content: 'MultiModel Dev OS' }],
+    ['meta', { name: 'apple-mobile-web-app-title', content: 'MultiModel Dev OS' }],
+    ['meta', { property: 'og:title', content: 'MultiModel Dev OS' }],
+    ['meta', { property: 'og:description', content: 'Portable AI Dev OS for Codex, Antigravity, Cursor, Claude, Gemini, VS Code, and multimodel coding workflows.' }],
+    ['meta', { property: 'og:image', content: 'https://rizvee.github.io/multimodel-dev-os/assets/social-preview.svg' }],
+    ['meta', { property: 'og:url', content: 'https://rizvee.github.io/multimodel-dev-os/' }],
+    ['meta', { property: 'og:type', content: 'website' }],
+    ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
+    ['meta', { name: 'twitter:title', content: 'MultiModel Dev OS' }],
+    ['meta', { name: 'twitter:description', content: 'Portable AI Dev OS for Codex, Antigravity, Cursor, Claude, Gemini, VS Code, and multimodel coding workflows.' }],
+    ['meta', { name: 'twitter:image', content: 'https://rizvee.github.io/multimodel-dev-os/assets/social-preview.svg' }],
+    [
+      'script',
+      { type: 'application/ld+json' },
+      JSON.stringify({
+        '@context': 'https://schema.org',
+        '@type': 'SoftwareApplication',
+        'name': 'MultiModel Dev OS',
+        'applicationCategory': 'DeveloperApplication',
+        'operatingSystem': 'Windows, macOS, Linux',
+        'programmingLanguage': 'JavaScript',
+        'license': 'https://opensource.org/licenses/MIT',
+        'url': 'https://github.com/rizvee/multimodel-dev-os',
+        'downloadUrl': 'https://www.npmjs.com/package/multimodel-dev-os',
+        'softwareVersion': '1.1.0',
+        'description': 'Portable, vendor-neutral AI Developer OS for multi-agent coding workflows.'
+      })
+    ]
+  ],
   themeConfig: {
     logo: '/logo.png',
     nav: [

package/docs/case-studies/index.md

@@ -1,6 +1,8 @@
-# Real-World Case Studies
+# Real-World Case Studies: AI Dev OS Integrations
 
-Explore how engineering teams and developers leverage `multimodel-dev-os` to prevent instruction drift, secure workspace boundaries, and save significant LLM token context budgets.
+Explore how engineering teams and developers leverage MultiModel Dev OS to prevent instruction drift, secure workspace boundaries, and save significant LLM token context budgets.
+
+> **Use when**: Designing a workflow for a specific tech stack (like Next.js SaaS schema synchronization, WordPress themes, headless checkout loops, or multi-model handoffs).
 
 ---
 
@@ -9,16 +11,18 @@ Explore how engineering teams and developers leverage `multimodel-dev-os` to pre
 Select a case study to see specific problems, setups, commands, outcomes, and reusable design patterns:
 
 ### 1. [Full-Stack Next.js SaaS](nextjs-saas.md)
-*Solving schema sync and inline autocompletion shifts across full-stack applications.*
+*Solving schema sync and inline autocompletion shifts across full-stack applications (Nextjs SaaS template / database schema synchronization).*
 
 ### 2. [WordPress Theme & Plugin Development](wordpress-site.md)
-*Securing PHP coding style conventions and folder overrides during local scaffolding.*
+*Securing PHP coding style conventions and folder overrides during local scaffolding (WordPress theme folder boundaries).*
 
 ### 3. [E-Commerce Webhooks & State Tracking](ecommerce-store.md)
-*Keeping payment routes and database event states strictly aligned between terminal-based models and editors.*
+*Keeping payment routes and database event states strictly aligned between terminal-based models and editors (e-commerce state webhooks).*
 
 ### 4. [SEO Landing Page Audits](seo-landing-page.md)
-*Managing multiple automated performance linter audits and SEO checkups.*
+*Managing multiple automated performance linter audits and SEO checkups (SEO landing page performance Core Web Vitals).*
 
 ### 5. [Multi-Model Handoff Protocols](multimodel-handoff.md)
-*Structuring sequential session logs to pass context between Claude Code and Gemini with zero token drops.*
+*Structuring sequential session logs to pass context between Claude Code and Gemini with zero token drops (Claude Gemini handoff logs).*
+
+Explore our [Stable Protocol Specification](/stable-protocol) or [Upgrade & Migration Guide](/migration-guide) for details.

package/docs/compatibility.md

@@ -1,6 +1,8 @@
 # Compatibility & Customization Guide
 
-This document maps how `multimodel-dev-os` integrates across diverse IDEs and terminal utilities, detailing what parameters developers can customize without breaking the protocol.
+This document maps how MultiModel Dev OS integrates across diverse IDEs and terminal utilities, detailing what parameters developers can customize without breaking the protocol.
+
+> **Use when**: Setting up tool configurations (like Cursor project rules or Claude Code project instructions) or configuring the active adapter mappings in `.ai/config.yaml`.
 
 ---
 
@@ -37,6 +39,8 @@ To guarantee validation compliance:
 
 ---
 
-## 4. v1.0.0 Compatibility Guarantee
+## 4. v1.1.0 Compatibility Guarantee
+
+The supported tool matrix and custom specifications listed here represent the officially frozen contracts of MultiModel Dev OS `v1.1.0`. Any backward-compatible extensions introduced in subsequent `1.x` releases will build on top of these mappings without breaking current project integrations.
 
-The supported tool matrix and custom specifications listed here represent the officially frozen contracts of MultiModel Dev OS `v1.0.0`. Any backward-compatible extensions introduced in subsequent `1.x` releases will build on top of these mappings without breaking current project integrations.
+Explore our [Stable Protocol Specification](/stable-protocol) or [Upgrade & Migration Guide](/migration-guide) for details.

package/docs/cost-optimization.md

@@ -1,6 +1,8 @@
-# LLM Cost & Context Optimization Playbook
+# LLM Cost & Context Optimization Playbook (v1.1.0)
 
-Maximizing developer velocity while minimizing LLM prompt overhead and API billing budgets is a critical priority for engineering teams. This playbook maps 12 industry cost-reduction techniques directly to native `multimodel-dev-os` features.
+Maximizing developer velocity while minimizing LLM prompt overhead and API billing budgets is a critical priority for engineering teams. This playbook maps 12 industry cost-reduction techniques directly to native MultiModel Dev OS features.
+
+> **Use when**: Optimizing API token usage, configuring Caveman Mode settings, or designing modular prompt caching strategies.
 
 ---
 
@@ -59,3 +61,5 @@ Below is how the 12 core context optimization strategies are implemented inside
 ### 12. Embedding Hygiene
 - **The Strategy:** Ensure semantic search indexes only relevant source files instead of temporary distributions.
 - **Dev OS Implementation:** Strict routing specifications mapped inside `context-routing.md` and pre-configured `.gitignore` definitions protect search databases from index pollution.
+
+Explore our [Stable Protocol Specification](/stable-protocol) or [Upgrade & Migration Guide](/migration-guide) for details.

package/docs/faq.md

@@ -1,91 +1,67 @@
-# FAQ
+# FAQ: MultiModel Dev OS Questions & Answers
+
+Frequently asked questions regarding MultiModel Dev OS, AI coding agents compatibility, and prompt context optimization.
+
+> **Use when**: Resolving setup ambiguities, understanding comparative advantages over simple rules files, or auditing CLI validations.
+
+---
 
 ## General
 
-**What is multimodel-dev-os?**
-A set of markdown files and conventions that let multiple AI coding tools
-(Codex, Cursor, Claude, Gemini, Antigravity, VS Code) share the same
-project context. Not a runtime. Not an AI agent. Think `.editorconfig`
-but for AI tools.
+**What is MultiModel Dev OS?**
+A set of markdown templates and directory structures that allow multiple AI coding tools (Codex, Cursor, Claude Code, Gemini, Antigravity, VS Code) to share a single portable AI project context. It acts like `.editorconfig` but for AI assistants.
 
-**Is this an operating system?**
-No. "Dev OS" is a metaphor for the shared operating layer between tools.
-It's just markdown files in your repo.
+**Is this a runtime operating system?**
+No. It is a metaphorical "OS" providing standard files (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`) to coordinate multiple tools.
 
 **What does "multimodel" mean?**
-Multiple AI models/tools working on the same project.
-Not "multimodal" (multiple input types like text + image).
+Multiple distinct AI coding models/agents (such as Codex, Antigravity, Cursor, and Claude Code) operating sequentially on the exact same workspace branch.
+
+---
 
 ## Setup
 
 **Do I need Node.js?**
 It depends on your installation path:
-* **Yes:** If you run the primary, recommended `npx multimodel-dev-os@latest init` workflow, Node.js is required.
-* **No:** If you run the fallback automated shell installer scripts (`install.sh` or `install.ps1`), they run purely on native bash or PowerShell and download resources directly.
+* **Yes:** If you run the primary, recommended `npx multimodel-dev-os@latest init` workflow.
+* **No:** If you run the fallback bash (`install.sh`) or PowerShell (`install.ps1`) one-liners.
 
 **Why not just write a single manual AGENTS.md myself?**
-While you can write a raw markdown instruction file manually, `multimodel-dev-os` offers a standardized development environment:
-1. **Automated Bridging:** Rather than copying and pasting rules into `.cursorrules`, `CLAUDE.md`, `.vscode/settings.json`, and `.gemini/settings.json`, our adapters dynamically references your root source of truth.
-2. **Standardized Context Segregation:** Separates concerns cleanly (`MEMORY.md` for architectural context, `TASKS.md` for task state tracking, `RUNBOOK.md` for incident response, and `.ai/` for skills and prompts).
-3. **Structured Verification:** Pre-packaged CLI and verification scripts test and assert the structural completeness of your rules.
-4. **Token Savings:** Seamlessly switches into Caveman Mode to slash token footprints by **~79%** for smaller models.
-
-**Can I use just one AI tool?**
-Yes. Use a single adapter. The multi-agent features are optional.
+While you can write a raw markdown file, MultiModel Dev OS offers:
+1. **Automated Bridging:** Adapters dynamically map your root source to Cursor, Claude, and Gemini native rules.
+2. **Context Budgets:** Toggle **Caveman Mode** to slash prompt rules overhead by **~79%**.
+3. **Structured Verification:** Built-in CLI commands validate workspace specifications instantly.
 
-**Which files are required?**
-At minimum: `AGENTS.md`. Everything else is optional.
-The installer creates the full structure, but you can delete what you don't need.
+---
 
 ## Adapters
 
 **Do I copy adapter files to my project root?**
 Yes, for tools that auto-detect specific files:
-- Cursor → copy `.cursorrules` to root
-- Claude → copy `CLAUDE.md` to root
-- VS Code → copy `.vscode/` to root
+- Cursor → `.cursorrules`
+- Claude Code → `CLAUDE.md`
+- VS Code → `.vscode/settings.json`
 
-**My tool isn't listed. Can I add one?**
-Yes. See [docs/adapters.md](adapters.md) for the guide. PRs welcome.
-
-**Will adapters break if a tool changes its config format?**
-Possibly. Adapters are community-maintained. File an issue if you
-notice an adapter is outdated.
+---
 
 ## Caveman Mode
 
 **When should I use Caveman Mode?**
-When your context window is tight, your model is small, or you're
-optimizing for API cost. It cuts ~79% of tokens.
-
-**Can I mix standard and caveman files?**
-Yes. Each file is independent. You could have a standard `AGENTS.md`
-and a caveman `TASKS.md`.
-
-## Orchestrator
+**Best for**: Context optimization for AI coding when you are using compact context budget windows, smaller models, or want to save money on API bill parameters.
 
-**Does the orchestrator run agents automatically?**
-No, not in v0.1. It's a protocol spec — conventions for how agents
-should coordinate. Runtime orchestration is planned for v0.2+.
-
-**Do I need the orchestrator for single-agent workflows?**
-No. The orchestrator is only relevant when multiple agents work
-on the same codebase.
+---
 
 ## Diagnostics & Validation
 
 **What is the difference between `validate` and `doctor`?**
-* **`validate`** is strict and verifies that your workspace strictly complies with the multimodel-dev-os directory schema. It checks for the existence of core files/directories and ensures enabled adapter rule references are not broken. If any checks fail, it exits with an error status (exit code 1).
-* **`doctor`** is advisory. It inspects compatibility constraints, warning you about potential context bloat (e.g. missing `.gitignore` files or non-ignored build directories) or active rules missing matching files. It reports warnings without blocking execution.
+* **`validate`** is strict and verifies compliance with the directory schema.
+* **`doctor`** is advisory and warns you about large unignored directories or empty placeholders.
 
-**How do I view available scaffolding templates?**
-You can use `node bin/multimodel-dev-os.js templates` (or `list-templates`) to view all available tech stacks and detailed blueprints, or `show-template <name>` to inspect a specific template's specifications.
+---
 
 ## Protocol & Migration
 
 **Is the MultiModel Dev OS protocol stable?**
-Yes. As of version `v1.0.0`, the core specifications (Root Contracts Layer, `.ai/` settings configurations, and adapter file targets) are officially frozen and backward-compatible. This ensures that any codebase prepared using `v1.0.0` will operate seamlessly inside future `1.x` ecosystems.
-
-**How do I migrate my repository to v1.0.0?**
-Upgrading is straightforward. Refer to our [Upgrades & Migration Guide](migration-guide.md) to inspect directory shifts, execute strict validation checks (`npx multimodel-dev-os validate`), and audit compatibility issues.
+Yes. As of version `v1.1.0`, the core specifications are officially frozen and backward-compatible. This ensures that any codebase prepared using `v1.1.0` will operate seamlessly inside future `1.x` ecosystems.
 
+Explore our [Stable Protocol Specification](/stable-protocol) or [Upgrade & Migration Guide](/migration-guide) for details.

package/docs/final-launch.md

@@ -1,13 +1,15 @@
-# Final Launch Guidelines
+# Final Launch Guidelines (v1.1.0)
 
-This document details the final launch guidelines and distribution routines for the public `v1.0.0` release of MultiModel Dev OS.
+This document details the final launch guidelines and distribution routines for the public releases of MultiModel Dev OS.
+
+> **Use when**: Executing pre-flight local audits, managing release announcements, or verifying package integrity.
 
 ---
 
 ## 1. Local Pre-flight Verification
 
 Prior to pushing files to the remote repository, ensure that:
-- The exact target version `1.0.0` is configured in `package.json`.
+- The exact target version `1.1.0` is configured in `package.json`.
 - The cross-platform verify script completes cleanly:
   ```bash
   npm run verify
@@ -25,5 +27,8 @@ When publishing the stable release, communicate the key advantages clearly:
 - **Portability**: Write-once configurations working seamlessly across Cursor, Claude, Gemini, Antigravity, and VS Code.
 - **Context Economy**: Up to 79% reduction in prompt tokens through Caveman Mode configurations.
 - **Zero Dependencies**: A completely self-contained CLI for lightning-fast setups.
+- **AI Discoverability**: Ready-to-ingest discoverability guides (`llms.txt` / `llms-full.txt`) for LLM agents.
 
 Refer to `docs/launch-kit.md` for specific copy blocks ready for distribution on Twitter/X, LinkedIn, Hacker News, and Reddit.
+
+Explore our [Stable Protocol Specification](/stable-protocol) or [Upgrade & Migration Guide](/migration-guide) for details.

package/docs/index.md

@@ -71,6 +71,22 @@ features:
   font-size: 0.9rem;
   color: var(--vp-c-text-2);
 }
+.works-with-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+  gap: 1rem;
+  margin-top: 1.5rem;
+  margin-bottom: 2.5rem;
+}
+.works-with-item {
+  border: 1px solid var(--vp-c-bg-mute);
+  background-color: var(--vp-c-bg-soft);
+  border-radius: 6px;
+  padding: 1rem;
+  text-align: center;
+  font-weight: 500;
+  font-size: 0.95rem;
+}
 </style>
 
 ## Quick Start Setup
@@ -83,6 +99,21 @@ npx multimodel-dev-os@latest init
 
 ---
 
+## Works With
+
+MultiModel Dev OS maps repository context directly to all major developer tools and coding agents:
+
+<div class="works-with-grid">
+  <div class="works-with-item">🤖 Codex</div>
+  <div class="works-with-item">🪐 Antigravity</div>
+  <div class="works-with-item">🎯 Cursor</div>
+  <div class="works-with-item">⚡ Claude Code</div>
+  <div class="works-with-item">🧠 Gemini</div>
+  <div class="works-with-item">💻 VS Code</div>
+</div>
+
+---
+
 ## Core Specifications & Playbooks
 
 <div class="grid-container">
@@ -108,16 +139,28 @@ npx multimodel-dev-os@latest init
   </a>
   <a href="/migration-guide" class="card-item">
     <div class="card-title">📈 Migration Playbook</div>
-    <div class="card-desc">Upgrade older workspaces to v1.0.0 standards cleanly.</div>
+    <div class="card-desc">Upgrade older workspaces to v1.1.0 standards cleanly.</div>
   </a>
   <a href="/v1-checklist" class="card-item">
     <div class="card-title">🏁 Release Checklist</div>
     <div class="card-desc">Audit repository compliance with the strict release quality gates.</div>
   </a>
+  <a href="/llms.txt" class="card-item" target="_blank">
+    <div class="card-title">🤖 AI Discovery (llms.txt)</div>
+    <div class="card-desc">A highly concise, structured overview formatted specifically for AI context ingestion.</div>
+  </a>
 </div>
 
 ---
 
+## For AI Assistants and Coding Agents
+
+To support modern AI search, GEO discovery, and developer agents:
+- We provide [llms.txt](/llms.txt) and [llms-full.txt](/llms-full.txt) at the root of the hosted documentation to allow Large Language Models and AEO utilities to read full workspace specs in single, token-optimized files.
+- The officially frozen protocol guarantees that agents can read and write workspace rules without manual supervision or instruction drift.
+
+---
+
 ## Cost & Context Optimization
 
 Minimize prompt overhead and API billing by mapping key context-reduction techniques to MultiModel Dev OS features:

package/docs/protocol.md

@@ -1,6 +1,8 @@
-# MultiModel Dev OS Protocol Specification
+# MultiModel Dev OS Protocol Specification (v1.1.0)
 
-This document defines the official, stable architectural protocol and design contracts for `multimodel-dev-os`, preparing the codebase for the v1.0.0 freeze.
+This document defines the official, stable architectural protocol and design contracts for MultiModel Dev OS, establishing portable AI project context conventions.
+
+> **Use when**: Implementing a custom CLI client, creating private adapters, or auditing Layer 1-3 protocol compliance.
 
 ---
 
@@ -27,12 +29,12 @@ The protocol is divided into three distinct decoupled layers to guarantee portab
 
 ---
 
-## 2. Stability Matrix (v1.0.0 Freeze)
+## 2. Stability Matrix (v1.1.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:
+These features are fully frozen. No breaking changes or renaming will occur in `v1.x`:
 - **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.
@@ -52,3 +54,5 @@ All compliant MultiModel Dev OS CLIs must strictly support the following executi
 - **`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.
+
+Explore our [Stable Protocol Specification](/stable-protocol) or [Upgrade & Migration Guide](/migration-guide) for details.

package/docs/public/humans.txt

@@ -0,0 +1,13 @@
+/* TEAM */
+Maintainer: rizvee
+GitHub: https://github.com/rizvee
+
+/* THANKS */
+Special thanks to: All Open Source contributors, AI agents, and early adoptions teams!
+
+/* SITE */
+Canonical: https://rizvee.github.io/multimodel-dev-os/
+Codebase: https://github.com/rizvee/multimodel-dev-os
+License: MIT License
+Language: JavaScript
+Framework: VitePress

package/docs/public/llms-full.txt

@@ -0,0 +1,73 @@
+# MultiModel Dev OS — Comprehensive AI Assistant Discoverability Guide
+
+MultiModel Dev OS is a repository-level porting specification designed to align context and instructions across diverse developer tools and AI models.
+
+---
+
+## 1. Core Architecture Layers
+
+The protocol decouples the centralized workspace context from the individual tool rules:
+
+```
+┌────────────────────────────────────────────────────────┐
+│ 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/        │
+└────────────────────────────────────────────────────────┘
+```
+
+### Layer 1: Root Documents
+- **`AGENTS.md`**: Defines teams, capabilities, boundaries, and model instructions.
+- **`MEMORY.md`**: Holds architectural decisions, repository milestones, and tech stacks.
+- **`TASKS.md`**: Active backlog tracking items.
+- **`RUNBOOK.md`**: Operational verification commands and post-deployment routines.
+
+---
+
+## 2. CLI Command specifications
+
+All compliant MultiModel Dev OS CLIs strictly enforce the following command contracts:
+- **`init`**: Scaffolds the standard `.ai/` context configuration directories.
+- **`verify`**: Automated release script that checks structure integrity.
+- **`templates`**: Lists built-in stack specifications (`nextjs-saas`, `wordpress-site`, `ecommerce-store`, `seo-landing-page`, `general-app`).
+- **`validate`**: Strict Quality Gate checking the layout rules on disk.
+- **`doctor`**: Advisory checkup warning you about unignored compiler caches or large folder directories.
+
+---
+
+## 3. Adapters & Mappings
+
+Adapters read context directly from `AGENTS.md` and translate them into native configs:
+- **Cursor** targets root `.cursorrules`
+- **Claude Code** targets root `CLAUDE.md`
+- **VS Code** targets `.vscode/settings.json`
+- **Gemini** targets root `GEMINI.md`
+- **Antigravity** targets `.gemini/settings.json`
+
+---
+
+## 4. Key Context Optimization (Caveman Mode)
+
+Toggling **Caveman Mode** dynamically reduces system prompt instructions to highly-optimized shorthand symbols, reducing rule tokens footprint by **~79%** for low-cost token execution budgets:
+
+```bash
+npx multimodel-dev-os@latest init --caveman
+```
+
+---
+
+## 5. Canonical Links
+- **Documentation site**: https://rizvee.github.io/multimodel-dev-os/
+- **GitHub Codebase**: https://github.com/rizvee/multimodel-dev-os
+- **Release Policies**: https://rizvee.github.io/multimodel-dev-os/release-policy
+- **LTS Support Policies**: https://rizvee.github.io/multimodel-dev-os/support-policy
+- **Upgrade Playbook**: https://rizvee.github.io/multimodel-dev-os/migration-guide

package/docs/public/llms.txt

@@ -0,0 +1,34 @@
+# MultiModel Dev OS (v1.1.0)
+
+Portable, vendor-neutral workspace configuration standard for multi-agent AI pair-programming workflows. 
+
+## What It Does
+Provides a unified repository-level specification using root markdown files (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`) and bridges them dynamically to multiple developer tools, ensuring zero instruction drift and up to 79% token context savings.
+
+## Fast Setup
+```bash
+npx multimodel-dev-os@latest init
+```
+
+## Supported Tools
+- **Cursor** (`.cursorrules`)
+- **Claude Code** (`CLAUDE.md`)
+- **VS Code** (`.vscode/settings.json`)
+- **Gemini** (`GEMINI.md`)
+- **Antigravity** (`.gemini/settings.json`)
+- **Codex** (`adapters/codex/AGENTS.md`)
+
+## Core Resources
+- **Canonical Website**: https://rizvee.github.io/multimodel-dev-os/
+- **GitHub Repository**: https://github.com/rizvee/multimodel-dev-os
+- **NPM Registry Package**: https://www.npmjs.com/package/multimodel-dev-os
+- **Stable Protocol Specification**: https://rizvee.github.io/multimodel-dev-os/stable-protocol
+- **Cost/Context Optimization Playbook**: https://rizvee.github.io/multimodel-dev-os/cost-optimization
+- **5-Day Adoption Roadmap**: https://rizvee.github.io/multimodel-dev-os/5-day-roadmap
+
+## Standard Templates
+- `nextjs-saas` (App Router, Prisma ORM, Stripe)
+- `wordpress-site` (Custom Block Themes, secure PHP guidelines)
+- `ecommerce-store` (PCI checkout, Webhooks, card state)
+- `seo-landing-page` (Astro static builds, JSON-LD, optimal LCP)
+- `general-app` (Universal baseline configurations)

package/docs/public/robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://rizvee.github.io/multimodel-dev-os/sitemap.xml

package/docs/public/sitemap.xml

@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/</loc>
+    <changefreq>daily</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/quickstart</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/templates/</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/protocol</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/stable-protocol</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/compatibility</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/migration-guide</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/cost-optimization</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/5-day-roadmap</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.6</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/case-studies/</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/demo</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/faq</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.6</priority>
+  </url>
+  <url>
+    <loc>https://rizvee.github.io/multimodel-dev-os/v1-checklist</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.6</priority>
+  </url>
+</urlset>

package/docs/quickstart.md

@@ -1,6 +1,8 @@
-# Quickstart
+# Quickstart Guide: AI Dev OS Deployment
 
-Get `multimodel-dev-os` integrated into your codebase in under 2 minutes.
+Get the MultiModel Dev OS integrated into your codebase in under 2 minutes to synchronize your multi-agent developer workflows.
+
+> **Use when**: Setting up a new repository or aligning multiple AI tools (like Cursor, Claude Code, Gemini, Codex, and Antigravity) to prevent instruction drift and prompt token bloat.
 
 ---
 
@@ -39,7 +41,7 @@ irm https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/inst
 
 ## Option C: Caveman Mode (Minimal Tokens)
 
-Reduce token footprint by **~79%** with our lightweight variants:
+**Best for**: Context optimization for AI coding when using tight API budgets or smaller models. Reduces rules footprint by **~79%**.
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.sh | bash -s -- --caveman
@@ -63,13 +65,13 @@ For offline execution or customized packaging within a cloned workspace:
 
 ## After Install
 
-1. **Edit `AGENTS.md`** — fill in your project name, stack, and build commands.
+1. **Edit `AGENTS.md`** — fill in your project name, stack, and build commands (portable AI project context).
 2. **Edit `.ai/config.yaml`** — enable adapters for your tools.
-3. **Copy adapter files** to your project root:
+3. **Copy adapter files** to your project root (e.g., Cursor project rules, Claude Code project instructions):
    - 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 configuration instantly.
+4. **Start coding** — your AI coding agents will read the shared configuration instantly.
 
 ---
 
@@ -87,3 +89,5 @@ node bin/multimodel-dev-os.js doctor
 # Verify repository structure checks
 npm run verify
 ```
+
+Explore our canonical [Stable Protocol Specification](/stable-protocol) or [Upgrade & Migration Guide](/migration-guide) for details.

package/docs/stable-protocol.md

@@ -1,6 +1,8 @@
-# Stable Protocol Specification (v1.0.0 Freeze)
+# Stable Protocol Specification (v1.1.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.
+This document formalizes the official, frozen architectural layers and design contracts for the MultiModel Dev OS protocol, guaranteeing portability and long-term stability across diverse AI coding agents.
+
+> **Best for**: Third-party client integrations, tool adapter developers, and engineering teams establishing robust AI coding guidelines.
 
 ---
 
@@ -33,7 +35,7 @@ MultiModel Dev OS enforces a three-tier design to decouple core workspace contex
 ## 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.
+- **`AGENTS.md`**: Defines team structures, boundaries, and model configurations (Codex project memory / Antigravity AI workflow).
 - **`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.
@@ -52,7 +54,7 @@ The following directories and files under `.ai/` are strictly locked:
 
 ## 4. Layer 3: Adapters Setup
 
-IDE adapters translate centralized rules to tool-specific paths:
+IDE adapters translate centralized rules to tool-specific paths (Cursor project rules / Claude Code project instructions):
 - **Cursor**: Linked via root `.cursorrules`
 - **Claude**: Linked via root `CLAUDE.md`
 - **Gemini**: Linked via `.gemini/settings.json`
@@ -64,3 +66,5 @@ IDE adapters translate centralized rules to tool-specific paths:
 
 - **Stable**: Root files, scaffolding directories, CLI subcommand signatures, and standard config structures.
 - **Experimental**: Custom check overrides under `.ai/checks/` and stack-specific context routing.
+
+Explore our [Upgrades & Migration Guide](/migration-guide) or [Release Quality Checklist](/v1-checklist) for staging controls.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multimodel-dev-os",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "bin": {
     "multimodel-dev-os": "bin/multimodel-dev-os.js"
   },

package/scripts/verify.js

@@ -217,6 +217,20 @@ checkFile('tests/README.md');
 checkFile('tests/fixtures/README.md');
 checkFile('tests/smoke/README.md');
 
+// --- Visual & AI Discovery Assets ---
+console.log('\nVisual & AI Discovery Assets:');
+checkFile('assets/favicon.png');
+checkFile('assets/logo.png');
+checkFile('docs/public/favicon.png');
+checkFile('docs/public/logo.png');
+checkFile('docs/public/llms.txt');
+checkFile('docs/public/llms-full.txt');
+checkFile('docs/public/robots.txt');
+checkFile('docs/public/sitemap.xml');
+checkFile('docs/public/assets/social-preview.svg');
+checkFile('docs/public/assets/terminal-demo.svg');
+checkFile('docs/public/assets/architecture-preview.svg');
+
 // --- CLI & Packaging Pre-Flight Tests ---
 console.log('\nRunning CLI & Packaging Pre-Flight Tests...');