multimodel-dev-os 0.3.0

package/.ai/skills/context-routing.md

@@ -0,0 +1,8 @@
+# Context Routing & Token Optimization Skill
+
+> Instructions for actively selecting only necessary context files to pass to a model's prompt.
+
+## Protocol
+1. Calculate the active token budget.
+2. Select only relevant files (e.g., frontend task -> do not include database/devops context).
+3. Switch config to Caveman Mode if nearing target budget limit.

package/.ai/skills/cpanel-deploy.md

@@ -0,0 +1,9 @@
+# cPanel Deployment Skill
+
+> Workflow procedures for building, packaging, and deploying applications to cPanel shared hosting.
+
+## Protocol
+1. Compile the production bundle assets locally.
+2. Package compiled files into an archive (e.g. tar.gz).
+3. Upload to target `public_html` directory.
+4. Verify server permissions and node/php script status.

package/.ai/skills/example-skill.md

@@ -0,0 +1,38 @@
+# Skill: Example
+
+> Template for creating a new skill. Copy this file and customize.
+
+## Name
+example-skill
+
+## Description
+A template skill that demonstrates the skill format.
+
+## When to Use
+- When the user asks to "do the example thing"
+- When a task requires the example capability
+
+## Steps
+
+1. **Check prerequisites**
+   ```bash
+   # Verify required tools are installed
+   null --version
+   ```
+
+2. **Execute the skill**
+   ```bash
+   # Run the main command
+   null
+   ```
+
+3. **Verify success**
+   ```bash
+   # Check that it worked
+   null
+   ```
+
+## Notes
+- Replace all `null` values with actual commands
+- Keep skills under 50 lines for context efficiency
+- One skill = one capability

package/.ai/skills/landing-page-optimization.md

@@ -0,0 +1,8 @@
+# Landing Page Optimization Skill
+
+> Guidelines for refining landing pages for higher user engagement, speed, and conversion parameters.
+
+## Protocol
+1. Minify asset payloads and use modern image formats.
+2. Implement responsive styling micro-animations.
+3. Keep visual elements above-the-fold fast and clear.

package/.ai/skills/model-routing.md

@@ -0,0 +1,7 @@
+# Model Routing Skill
+
+> Instructions for dynamically assigning tasks to optimal models based on reasoning and token budgets.
+
+## Protocol
+1. Evaluate task complexity: Architecture design -> Reasoning model. Bugfix -> Fast model.
+2. Route step-by-step executions according to `.ai/context/model-map.md`.

package/.ai/skills/nextjs-feature-build.md

@@ -0,0 +1,9 @@
+# Next.js Feature Build Skill
+
+> Step-by-step workflow for implementing new features in a Next.js environment.
+
+## Protocol
+1. Map routing path and page layouts.
+2. Build reusable, client/server component boundaries properly.
+3. Integrate styling and runtime data-validation.
+4. Run standard build test and verify correctness.

package/.ai/skills/refactor.md

@@ -0,0 +1,9 @@
+# Code Refactoring Skill
+
+> Workflow for improving existing code architecture without changing external system behavior.
+
+## Protocol
+1. Map current dependencies and usage.
+2. Draft modular replacement components.
+3. Validate parity using automated tests.
+4. Clean up unused imports and obsolete files safely.

package/.ai/skills/seo-implementation.md

@@ -0,0 +1,8 @@
+# SEO Implementation Skill
+
+> Operational steps to implement metadata, JSON-LD schemas, and heading semantic hierarchies.
+
+## Protocol
+1. Place JSON-LD script schemas into specific layout headers.
+2. Structure page tags matching exactly `.ai/context/seo-rules.md`.
+3. Check loading speed parameters and element responsiveness.

package/.ai/templates/AGENTS.caveman.md

@@ -0,0 +1,12 @@
+# AGENTS
+project: null
+stack: null
+dev: null
+build: null
+test: null
+lint: null
+style: null
+no-touch: .env, node_modules, package-lock.json
+roles: default/any/all/rw
+deps: null
+context: MEMORY.md, TASKS.md, RUNBOOK.md

package/.ai/templates/MEMORY.caveman.md

@@ -0,0 +1,14 @@
+# MEMORY
+## Decisions
+| date | decision | why |
+|------|----------|-----|
+| null | null | null |
+## Patterns
+- null
+## Issues
+- null
+## Env
+os: null, ci: null, host: null
+## Sessions
+### null
+date: null, agent: null, summary: null

package/.ai/templates/RUNBOOK.caveman.md

@@ -0,0 +1,22 @@
+# RUNBOOK
+## Setup
+```
+git clone <url> && cd <dir>
+# deps: null
+# env: cp .env.example .env
+# dev: null
+```
+## Deploy
+| step | cmd | notes |
+|------|-----|-------|
+| 1 | null | null |
+## Rollback
+```
+null
+```
+## Incident
+1. logs: null
+2. notify: null
+3. rollback if needed
+4. fix root cause
+5. post-mortem → MEMORY.md

package/.ai/templates/TASKS.caveman.md

@@ -0,0 +1,7 @@
+# TASKS
+## Now
+- [ ] null
+## Next
+- [ ] null
+## Done
+- [x] null

package/.ai/templates/bug-report-template.md

@@ -0,0 +1,14 @@
+# Bug Report
+
+## Description
+Provide a clear description of the bug.
+
+## Steps to Reproduce
+1. `null`
+2. `null`
+
+## Expected Behavior
+What should have happened?
+
+## Actual Behavior
+What actually happened? Include stack trace if any.

package/.ai/templates/feature-spec-template.md

@@ -0,0 +1,14 @@
+# Feature Spec: [Feature Name]
+
+## Overview
+What is this feature and who is it for?
+
+## Architecture & Data Flow
+Describe components and integrations.
+
+## Database Schema (if any)
+`null`
+
+## Interface Guidelines
+- Responsive design
+- Micro-animations

package/.ai/templates/project-memory-template.md

@@ -0,0 +1,12 @@
+# Project Memory
+
+> Persistent memory file keeping track of architecture decisions, patterns, and session history.
+
+## Architecture Decisions
+- `null`
+
+## Key Patterns
+- `null`
+
+## Session Notes
+- `null`

package/.ai/templates/session-log-template.md

@@ -0,0 +1,16 @@
+# Session Log: [Current Agent] -> [Next Agent]
+
+**Timestamp:** [ISO 8601]
+**Agent:** [Tool Name] ([Role])
+
+## Action Summary
+Brief description of what was done.
+
+## Files Changed
+- `null`
+
+## Next Steps
+1. `null`
+
+## Blockers
+- None

package/.ai/templates/task-template.md

@@ -0,0 +1,16 @@
+# Task: [Title]
+
+## Status
+- [ ] Todo
+- [/] In Progress
+- [x] Done
+
+## Description
+Provide details about the task requirements.
+
+## Files to Modify
+- `null`
+
+## Verification Checklist
+- [ ] Unit tests pass
+- [ ] Changes verified locally

package/AGENTS.md

@@ -0,0 +1,79 @@
+# Agent Instructions
+
+> This file is the **source of truth** for all AI coding agents working on this project.
+> Tool-specific adapters in `adapters/` read from this file. Do not duplicate instructions there.
+
+## Project Overview
+
+<!-- Replace with your project description -->
+project: null
+stack: null
+description: null
+
+## Build Commands
+
+<!-- Replace with your actual commands -->
+```
+dev:   null
+build: null
+test:  null
+lint:  null
+```
+
+## Coding Conventions
+
+<!-- Define your style rules -->
+- Language: null
+- Framework: null
+- Style guide: null
+- Type checking: null
+- Formatting: null
+
+## File Structure Rules
+
+<!-- Which directories serve which purpose -->
+```
+src/       → Application source code
+lib/       → Shared libraries and utilities
+tests/     → Test files
+docs/      → Documentation
+```
+
+## Boundaries
+
+<!-- Files and directories agents must NOT modify -->
+```
+no-touch:
+  - .env
+  - .env.local
+  - node_modules/
+  - package-lock.json (do not manually edit)
+```
+
+## Agent Roles
+
+<!-- Define roles if using the multimodel orchestrator -->
+<!-- See .ai/agents/multimodel-orchestrator.md for full orchestration config -->
+
+| Role | Tool | Scope | Permissions |
+|------|------|-------|-------------|
+| default | any | all files | read + write |
+
+## Dependencies
+
+<!-- Key dependencies agents should be aware of -->
+- null
+
+## Testing Strategy
+
+<!-- How agents should approach testing -->
+- Unit tests: null
+- Integration tests: null
+- E2E tests: null
+
+## Additional Context
+
+<!-- Any other context agents need -->
+- See `MEMORY.md` for project history and decisions
+- See `TASKS.md` for current work items
+- See `RUNBOOK.md` for operational procedures

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 multimodel-dev-os contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MEMORY.md

@@ -0,0 +1,42 @@
+# Project Memory
+
+> Persistent context that AI agents carry across sessions.
+> Update this file as the project evolves. Keep it under 200 lines.
+
+## Architecture Decisions
+
+<!-- Record key decisions so agents don't re-debate them -->
+
+| Date | Decision | Rationale |
+|------|----------|-----------|
+| null | null | null |
+
+## Key Patterns
+
+<!-- Patterns agents should follow consistently -->
+
+- null
+
+## Known Issues
+
+<!-- Gotchas, workarounds, and technical debt -->
+
+- null
+
+## Environment Notes
+
+<!-- Environment-specific context (OS quirks, CI setup, etc.) -->
+
+- OS: null
+- CI: null
+- Hosting: null
+
+## Session Notes
+
+<!-- Recent session summaries — newest first, keep last 5 -->
+
+### Session: null
+**Date:** null
+**Agent:** null
+**Summary:** null
+**Files changed:** null

package/README.md

@@ -0,0 +1,197 @@
+# multimodel-dev-os
+
+> Portable, vendor-neutral project configuration for AI coding tools.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+[![v0.1](https://img.shields.io/badge/version-0.1.1-orange.svg)](CHANGELOG.md)
+
+A shared set of markdown files that any AI coding tool can read — Codex,
+Antigravity, Cursor, Claude, Gemini, VS Code, or whatever comes next.
+Think `.editorconfig` for AI tools.
+
+> [!IMPORTANT]
+> **v0.1 is a Markdown-first convention/specification layer.**
+> It is a set of structured directory/file guidelines that AI models can natively parse, not a daemon process, autonomous runtime engine, or background executor. Command Line Interface (CLI) automation and runtime engine tools are scheduled for the **v0.2+** releases.
+
+## The Problem
+
+You use Cursor for implementation, Claude for architecture, Codex for review.
+Each tool has its own config format, context window, and memory system.
+When you switch tools, context is lost. When two agents work on the same
+repo, they step on each other.
+
+## The Solution
+
+One set of markdown files that all AI tools read:
+
+```
+AGENTS.md   → What this project is and how to work on it
+MEMORY.md   → What we've learned and decided
+TASKS.md    → What needs to be done
+RUNBOOK.md  → How to deploy, rollback, and respond to incidents
+.ai/        → Agent config, skills, checks, prompts, session logs
+```
+
+Tool-specific adapters translate these into native formats:
+
+```
+adapters/codex/        → Codex-native config
+adapters/antigravity/  → Antigravity/Gemini-native config
+adapters/cursor/       → .cursorrules
+adapters/claude/       → CLAUDE.md
+adapters/gemini/       → GEMINI.md
+adapters/vscode/       → .vscode/settings.json
+```
+
+## Supported Tool Matrix
+
+| Tool | Adapter File | Reads Source of Truth From | Status |
+|------|--------------|----------------------------|--------|
+| OpenAI Codex | `adapters/codex/AGENTS.md` | `/AGENTS.md` | ✅ v0.1 |
+| Google Antigravity | `adapters/antigravity/AGENTS.md` | `/AGENTS.md` | ✅ v0.1 |
+| Cursor | `adapters/cursor/.cursorrules` | `/AGENTS.md`, `/MEMORY.md`, `/TASKS.md` | ✅ v0.1 |
+| Claude Code | `adapters/claude/CLAUDE.md` | `/AGENTS.md`, `/MEMORY.md`, `/TASKS.md` | ✅ v0.1 |
+| Gemini | `adapters/gemini/GEMINI.md` | `/AGENTS.md` | ✅ v0.1 |
+| VS Code | `adapters/vscode/.vscode/settings.json` | `/AGENTS.md` (via exclusions) | ✅ v0.1 |
+
+## Quick Start
+
+### Option 1: Automated Installation
+
+**macOS / Linux / WSL (bash):**
+```bash
+curl -fsSL https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.sh | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.ps1 | iex
+```
+
+**Caveman Mode Installation** (~79% fewer tokens):
+```bash
+curl -fsSL https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.sh | bash -s -- --caveman
+```
+
+### Option 2: Manual Setup
+
+If you prefer not to execute external shell scripts:
+1. Clone this repository locally.
+2. Copy the core markdown files (`AGENTS.md`, `MEMORY.md`, `TASKS.md`, `RUNBOOK.md`) and the `.ai/` directory into your project root.
+3. Select the adapter configurations you need from the `adapters/` directory and copy them to your project root (e.g., `adapters/cursor/.cursorrules`).
+
+See [docs/quickstart.md](docs/quickstart.md) for all options.
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────┐
+│           SOURCE OF TRUTH (root)            │
+│                                             │
+│  AGENTS.md  MEMORY.md  TASKS.md  RUNBOOK.md │
+│                .ai/                         │
+│    config · agents · skills · checks · ...  │
+└──────────────────┬──────────────────────────┘
+                   │
+        Adapters read from ↑
+                   │
+  ┌────────┬───────┼───────┬────────┬─────────┐
+  │        │       │       │        │         │
+  ▼        ▼       ▼       ▼        ▼         ▼
+Codex  Antigrav  Cursor  Claude  Gemini    VS Code
+```
+
+Adapters are **readers, not writers.** The root markdown files are the
+single source of truth. Adapters translate into tool-native formats.
+
+## Core Files
+
+| File | Purpose | Audience |
+|------|---------|----------|
+| [`AGENTS.md`](AGENTS.md) | Project rules, build commands, conventions | AI agents |
+| [`MEMORY.md`](MEMORY.md) | Architecture decisions, patterns, session notes | AI agents |
+| [`TASKS.md`](TASKS.md) | Current sprint, backlog, completed work | AI + humans |
+| [`RUNBOOK.md`](RUNBOOK.md) | Deploy, rollback, incident response | AI + humans |
+| [`.ai/config.yaml`](.ai/config.yaml) | Mode, orchestrator, adapter settings | System |
+
+## Supported Tools
+
+| Tool | Adapter | Native File | Status |
+|------|---------|-------------|--------|
+| OpenAI Codex | [`adapters/codex/`](adapters/codex/) | `AGENTS.md` | ✅ v0.1 |
+| Google Antigravity | [`adapters/antigravity/`](adapters/antigravity/) | `.gemini/settings.json` | ✅ v0.1 |
+| Cursor | [`adapters/cursor/`](adapters/cursor/) | `.cursorrules` | ✅ v0.1 |
+| Claude Code | [`adapters/claude/`](adapters/claude/) | `CLAUDE.md` | ✅ v0.1 |
+| Gemini | [`adapters/gemini/`](adapters/gemini/) | `GEMINI.md` | ✅ v0.1 |
+| VS Code | [`adapters/vscode/`](adapters/vscode/) | `.vscode/settings.json` | ✅ v0.1 |
+
+Want to add a tool? See [docs/adapters.md](docs/adapters.md).
+
+## Multimodel Orchestrator
+
+Coordinate multiple AI agents on one project. Define roles in
+`.ai/config.yaml`, detail coordination in `.ai/agents/multimodel-orchestrator.md`.
+
+```yaml
+orchestrator:
+  mode: "sequential"
+  agents:
+    - name: "architect"
+      tool: "claude"
+      files: ["docs/**"]
+    - name: "implementer"
+      tool: "cursor"
+      files: ["src/**"]
+```
+
+See [docs/multimodel-workflow.md](docs/multimodel-workflow.md).
+
+## Caveman Mode
+
+Minimal-token templates. Same structure, ~79% fewer tokens.
+
+| Mode | AGENTS.md | Total |
+|------|-----------|-------|
+| Standard | ~500 tokens | ~1,600 tokens |
+| Caveman | ~120 tokens | ~340 tokens |
+
+See [docs/caveman-mode.md](docs/caveman-mode.md).
+
+## Examples
+
+| Project Type | Files |
+|---|---|
+| [Next.js SaaS](examples/nextjs-saas/) | AGENTS.md, MEMORY.md, config |
+| [WordPress Site](examples/wordpress-site/) | AGENTS.md, MEMORY.md, config |
+| [E-commerce Headless Store](examples/ecommerce-store/) | AGENTS.md, MEMORY.md, config |
+| [SEO Static Landing Page](examples/seo-landing-page/) | AGENTS.md, MEMORY.md, config |
+| [General AppScaffold](examples/general-app/) | AGENTS.md, MEMORY.md, config |
+
+## "multimodel" ≠ "multimodal"
+
+- **multimodel** = multiple AI models/tools on the same project
+- **multimodal** = AI processing multiple input types (text, image, audio)
+
+This project is about the first one.
+
+## Docs
+
+- [Quickstart](docs/quickstart.md)
+- [Architecture](docs/architecture.md)
+- [Adapters](docs/adapters.md)
+- [Multi-agent Workflow](docs/multimodel-workflow.md)
+- [Caveman Mode](docs/caveman-mode.md)
+- [Installers](docs/installers.md)
+- [CLI Roadmap](docs/cli-roadmap.md)
+- [Testing Guide](docs/testing-v0.2.md)
+- [NPM Publishing Runbook](docs/npm-publishing.md)
+- [FAQ](docs/faq.md)
+
+## Contributing
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) and [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).
+
+## License
+
+[MIT](LICENSE)

package/RUNBOOK.md

@@ -0,0 +1,73 @@
+# Runbook
+
+> Operational procedures for deployment, rollback, and incident response.
+> AI agents reference this before executing critical operations.
+
+## Environment Setup
+
+<!-- Steps to set up a development environment from scratch -->
+
+```bash
+# 1. Clone the repo
+git clone <repo-url>
+cd <project-name>
+
+# 2. Install dependencies
+null
+
+# 3. Set up environment variables
+cp .env.example .env
+# Edit .env with your values
+
+# 4. Start development server
+null
+```
+
+## Deploy
+
+<!-- Step-by-step deployment procedure -->
+
+| Step | Command | Notes |
+|------|---------|-------|
+| 1 | null | null |
+| 2 | null | null |
+
+**Deploy URL:** null
+**Deploy branch:** null
+
+## Rollback
+
+<!-- How to revert a bad deployment -->
+
+```bash
+# Quick rollback to previous version
+null
+```
+
+**Last known good commit:** null
+
+## Incident Response
+
+<!-- What to do when things break -->
+
+1. **Identify:** Check error logs at `null`
+2. **Communicate:** Notify team at `null`
+3. **Mitigate:** Rollback if necessary (see above)
+4. **Resolve:** Fix the root cause
+5. **Document:** Add post-mortem to `MEMORY.md`
+
+## Health Checks
+
+<!-- Endpoints or commands to verify the system is working -->
+
+| Check | Command/URL | Expected |
+|-------|-------------|----------|
+| null | null | null |
+
+## Secrets & Config
+
+<!-- Where secrets are stored (never put actual secrets here) -->
+
+| Secret | Location | Rotation |
+|--------|----------|----------|
+| null | null | null |