multimodel-dev-os 0.5.1 → 0.6.0

package/docs/.vitepress/config.js

@@ -0,0 +1,57 @@
+export default {
+  base: '/multimodel-dev-os/',
+  title: 'MultiModel Dev OS',
+  description: 'Portable, vendor-neutral AI Developer OS for multi-agent coding workflows.',
+  ignoreDeadLinks: true,
+  themeConfig: {
+    logo: '/logo.png',
+    nav: [
+      { text: 'Home', link: '/' },
+      { text: 'Quickstart', link: '/quickstart' },
+      { text: 'Templates', link: '/templates/' },
+      { text: 'GitHub', link: 'https://github.com/rizvee/multimodel-dev-os' }
+    ],
+    sidebar: [
+      {
+        text: 'Getting Started',
+        items: [
+          { text: 'Introduction', link: '/' },
+          { text: 'Quickstart', link: '/quickstart' },
+          { text: 'FAQ', link: '/faq' }
+        ]
+      },
+      {
+        text: 'Core Features',
+        items: [
+          { text: 'Command Line Reference', link: '/CLI' },
+          { text: 'Architecture Specifications', link: '/architecture' },
+          { text: 'Adapters Setup Guide', link: '/adapters' },
+          { text: 'Caveman Mode Specifications', link: '/caveman-mode' }
+        ]
+      },
+      {
+        text: 'Templates & Use Cases',
+        items: [
+          { text: 'Template Gallery', link: '/templates/' },
+          { text: 'Use Cases Guide', link: '/use-cases' },
+          { text: 'Templates Architecture', link: '/templates-guide' }
+        ]
+      },
+      {
+        text: 'Operations & Publishing',
+        items: [
+          { text: 'CLI Roadmap', link: '/cli-roadmap' },
+          { text: 'NPM Publishing Runbook', link: '/npm-publishing' },
+          { text: 'Pre-flight Release Testing', link: '/testing-v0.2' }
+        ]
+      }
+    ],
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/rizvee/multimodel-dev-os' }
+    ],
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © 2026-present MultiModel Dev OS team.'
+    }
+  }
+}

package/docs/CLI.md

@@ -0,0 +1,50 @@
+# CLI Command Reference
+
+`multimodel-dev-os` features a lightweight, dependency-free local CLI utility. It allows standard bootstraps, structural integrity checks, and rule validations natively.
+
+## Execution
+
+Execute the CLI globally or inside target folder contexts using `npx`:
+
+```bash
+npx multimodel-dev-os@latest <command> [options]
+```
+
+Or execute locally within a cloned workspace:
+
+```bash
+node bin/multimodel-dev-os.js <command> [options]
+```
+
+---
+
+## Commands
+
+### 1. `init`
+Scaffold `multimodel-dev-os` files and adapters cleanly.
+* **Usage:** `node bin/multimodel-dev-os.js init [options]`
+* **Options:**
+  - `-t, --target <path>`: Specifies target destination (default: current working directory).
+  - `--template <name>`: Stack blueprint: `nextjs-saas`, `wordpress-site`, `ecommerce-store`, `seo-landing-page`, `general-app`.
+  - `-a, --adapter <name>`: Inject rules file directly (`cursor`, `claude`, `vscode`, `gemini`, `antigravity`, `codex`).
+  - `--caveman`: Installs ultra-lightweight variant profiles.
+  - `-d, --dry-run`: Previews actions without mutated files.
+  - `-f, --force`: Overwrites conflicts.
+
+### 2. `validate`
+Strict directory schema compliance gate checks.
+* **Usage:** `node bin/multimodel-dev-os.js validate [options]`
+* **Assertions:** Checks for the presence of crucial root files and enabled adapters' rule targets. If assertions fail, exits with status 1.
+
+### 3. `doctor`
+Advisory checkups for gitignores and large token-sinks.
+* **Usage:** `node bin/multimodel-dev-os.js doctor [options]`
+* **Audits:** Missing `.env` gates in gitignores, missing build steps inside `AGENTS.md`, and large unignored directories (e.g. `node_modules`, `.next`). Reports warnings without blocking execution.
+
+### 4. `templates` / `list-templates`
+Inspection map of all built-in stacks.
+* **Usage:** `node bin/multimodel-dev-os.js templates`
+
+### 5. `show-template <name>`
+Detailed layout specifications and skill blueprints audit.
+* **Usage:** `node bin/multimodel-dev-os.js show-template nextjs-saas`

package/docs/index.md

@@ -0,0 +1,55 @@
+---
+layout: home
+
+hero:
+  name: "MultiModel Dev OS"
+  text: "Standardize your AI pair-programmers"
+  tagline: "Portable, vendor-neutral workspace configurations for multi-agent coding loops."
+  image:
+    src: /logo.png
+    alt: MultiModel Dev OS Logo
+  actions:
+    - theme: brand
+      text: Get Started Quick
+      link: /quickstart
+    - theme: alt
+      text: View Template Gallery
+      link: /templates/
+    - theme: alt
+      text: View on GitHub
+      link: https://github.com/rizvee/multimodel-dev-os
+
+features:
+  - icon: 🧠
+    title: Universal Portability
+    details: Supports Codex, Antigravity, Cursor, Claude Code, Gemini, and VS Code with dynamic adapters sync.
+  - icon: ⚡
+    title: Ultra-Low Token Footprint
+    details: Includes Caveman Mode to slash model context footprint by ~79%, saving massive API bill budgets.
+  - icon: 🛡️
+    title: Local Quality Gates
+    details: Build-in zero-dependency validate and doctor checkups ensure pristine workspace rules layout.
+---
+
+<style>
+:root {
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: linear-gradient(135deg, #646cff 0%, #42b883 100%);
+}
+</style>
+
+## 10-Second Quickstart
+
+Bootstrap your project instantly via `npx`:
+
+```bash
+npx multimodel-dev-os@latest init
+```
+
+## Why MultiModel Dev OS?
+
+AI coding tools are incredibly fast, but switching between them introduces context fragmentation:
+1. **Context Loss:** You use **Cursor** for quick code completions, **Claude Code** for command-line implementations, and **Gemini/Antigravity** for auditing large code volumes. Every context switch drops your operational parameters.
+2. **Instruction Drift:** Different tools look for different files (`.cursorrules`, `CLAUDE.md`, `.vscode/settings.json`, `.gemini/settings.json`). If you modify build scripts or styling rules in one place, they quickly drift across others, causing confusing compile failures.
+
+`multimodel-dev-os` establishes a single source of truth inside your repository using a standardized root structure (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`) and a `.ai/` context configuration directory.

package/docs/templates/index.md

@@ -0,0 +1,30 @@
+# Scaffolding Template Gallery
+
+`multimodel-dev-os` provides high-fidelity, real-world scaffolding profiles for common architectural targets.
+
+## Stacks Blueprints
+
+### [Next.js SaaS Stack](/use-cases.html#_1-next-js-saas-stack)
+- **Tech Stack:** Next.js 14 App Router, TypeScript, React Server Actions, Prisma, Stripe.
+- **Skill File:** `.ai/skills/nextjs-action-build.md` (form parameters validation and isolation conventions).
+- **Audit Target:** `npx multimodel-dev-os init --template nextjs-saas`
+
+### [WordPress Theme & Plugin Custom Site](/use-cases.html#_4-wordpress-custom-site)
+- **Tech Stack:** WordPress Core, PHP 8.1+, Gutenberg custom blocks, MySQL.
+- **Skill File:** `.ai/skills/plugin-boilerplate.md` (database escape statements and esc_html gates).
+- **Audit Target:** `npx multimodel-dev-os init --template wordpress-site`
+
+### [Headless E-commerce Cart](/use-cases.html#_2-headless-e-commerce-store)
+- **Tech Stack:** MedusaJS, Stripe API, cart session structures.
+- **Skill File:** `.ai/skills/webhook-handler.md` (Checkout validation loops and webhook signatures auditing).
+- **Audit Target:** `npx multimodel-dev-os init --template ecommerce-store`
+
+### [SEO Astro Landing Layout](/use-cases.html#_3-seo-landing-page)
+- **Tech Stack:** Astro, Tailwind, HTML5, structured JSON-LD schemas.
+- **Skill File:** `.ai/skills/seo-audit.md` (Image compression parameters and meta validations).
+- **Audit Target:** `npx multimodel-dev-os init --template seo-landing-page`
+
+### [General Universal App API](/use-cases.html#_5-general-application-scaffolding)
+- **Tech Stack:** Node, Express, PostgreSQL, Jest.
+- **Skill File:** `.ai/skills/example-skill.md` (Standardized environment variables and validation middleware).
+- **Audit Target:** `npx multimodel-dev-os init --template general-app`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multimodel-dev-os",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "bin": {
     "multimodel-dev-os": "bin/multimodel-dev-os.js"
   },
@@ -31,6 +31,8 @@
     "adapters/",
     "scripts/",
     "docs/",
+    "!docs/.vitepress/dist/",
+    "!docs/.vitepress/cache/",
     "examples/",
     "bin/"
   ],
@@ -39,6 +41,12 @@
     "verify:bash": "bash scripts/verify.sh",
     "test:cli": "node bin/multimodel-dev-os.js verify",
     "pack:template": "bash scripts/pack-template.sh",
-    "pack": "bash scripts/pack-template.sh"
+    "pack": "bash scripts/pack-template.sh",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "devDependencies": {
+    "vitepress": "^1.6.4"
   }
 }