mover-os 4.3.0

package/README.md

@@ -0,0 +1,218 @@
+# Mover OS
+
+**The Agentic Operating System for Obsidian.**
+
+> Most productivity systems are passive storage. This one talks back.
+
+Mover OS turns Obsidian into an AI-powered execution engine. It audits your behavior against your stated strategy, extracts reusable knowledge from daily work, and evolves based on your corrections.
+
+**Works best with Claude Code.** Supports 13 AI coding agents.
+
+**Version:** 4.3 | **Status:** Production
+
+---
+
+## What It Does
+
+- **Active Accountability** — AI reads your daily logs and detects drift, procrastination, and scope creep.
+- **Strategic Validation** — Acts as an intellectual opponent, testing your logic before you invest time.
+- **Knowledge Compounding** — Automatically refines ephemeral notes into a permanent, linked library.
+- **Three Domains** — Identity covers Work, Vitality, and Faith/Purpose. Not just productivity.
+- **Pattern Detection** — Tracks behavioral patterns with confidence scores. Surfaces them when they matter.
+- **Escalating Friction** — 4 levels of pushback when you drift from your plan. Speed bumps, not walls.
+- **Correction Lifecycle** — Correct the AI and it proposes a fix, waits for approval, and updates its own rules.
+- **Entity Memory** — Remembers people, organizations, and decisions across sessions.
+- **22 Connected Workflows** — Each one hands off to the next. You never wonder what to do next.
+
+---
+
+## Install
+
+### Prerequisites
+
+- [Obsidian](https://obsidian.md) (your vault interface)
+- A coding agent (any of the supported ones below)
+- Git
+
+### Quick Start
+
+```bash
+npx moveros
+```
+
+The interactive installer will:
+1. Ask where your Obsidian vault is (auto-detects common locations)
+2. Detect which coding agents you have installed
+3. Let you choose which agents to configure
+4. Let you select skill categories (dev, marketing, CRO, strategy, SEO, design, obsidian)
+5. Install vault structure, rules, workflows, skills, and hooks
+
+> **Requires:** Node.js 18+ (zero dependencies).
+
+### After Install
+
+Open your vault in Obsidian and your coding agent, then run:
+
+```
+/setup
+```
+
+This launches a deep interview that builds your Identity, Strategy, Dossier, and Goals.
+
+### Migrating an Existing Vault?
+
+If you have an existing Obsidian vault with content you want to organize into the PARA structure:
+
+```
+/migrate
+```
+
+This scans your folders, suggests where everything should go, and copies files into place. Originals are never deleted.
+
+### Already Installed?
+
+Update without losing your Engine data:
+
+```bash
+npx moveros
+```
+
+Choose "Update" mode. Your Engine files (Identity, Strategy, Dossier, etc.) are never overwritten.
+
+Then run `/update` inside your vault to migrate any new Engine sections.
+
+Or re-link hard links after any git operation:
+
+```bash
+bash src/install/link.sh
+```
+
+---
+
+## Supported Agents
+
+Works with **13 AI coding agents.** The installer auto-detects and configures each one:
+
+| Agent | What Gets Installed |
+|-------|---------------------|
+| Claude Code | Rules + 22 commands + 61 skills + 6 hooks |
+| Cursor | Rules + 22 commands + 61 skills |
+| Cline | Rules + 61 skills |
+| Windsurf | Rules + 61 skills |
+| Gemini CLI | Rules + 22 workflows + 61 skills |
+| GitHub Copilot | Rules + 61 skills |
+| Codex CLI | Rules + 61 skills |
+| Codex (Cloud) | Rules + 61 skills |
+| Antigravity | Rules + 22 workflows |
+| OpenClaw | Rules + 61 skills |
+| Roo Code | Rules + 61 skills |
+| Amp | Rules + 61 skills |
+| Aider | Rules |
+
+> Claude Code gets the deepest integration — hooks, native slash commands, and the full correction lifecycle. Every other agent gets the core system.
+
+---
+
+## How It Works
+
+### The Engine
+
+Your `02_Areas/Engine/` folder is the brain. Core files that the AI reads before every operation:
+
+| File | Purpose |
+|------|---------|
+| `Identity_Prime.md` | Who you are — psychology, values, anti-identity |
+| `Strategy.md` | What you're testing — hypotheses, metrics, pivot criteria |
+| `Active_Context.md` | Where you are NOW — blockers, energy, commitments, waiting-for |
+| `Mover_Dossier.md` | What you have — skills, assets, network, capital |
+| `Auto_Learnings.md` | What the AI has learned about you — patterns with confidence scores |
+| `Goals.md` | Where you're going — 90-day, 1-year, 10-year targets |
+| `Metrics_Log.md` | 30-day rolling performance data |
+
+### The Daily Rhythm
+
+```
+/morning → [WORK] → /log → /analyse-day → /plan-tomorrow
+```
+
+| Workflow | When | Duration |
+|----------|------|----------|
+| `/morning` | Start of session | 5 min |
+| `/log` | End of session | 5 min |
+| `/analyse-day` | End of day | 10 min |
+| `/plan-tomorrow` | Every evening | 5 min |
+| `/review-week` | Weekly (configurable day) | 30 min |
+
+### All Workflows
+
+**Daily Flow:**
+
+| Command | Purpose |
+|---------|---------|
+| `/morning` | Session primer — identity, energy check, pattern alerts |
+| `/log` | Session capture — sync plan, extract wisdom |
+| `/analyse-day` | Brutal daily audit — strategy alignment, pattern detection |
+| `/plan-tomorrow` | Battle plan for tomorrow |
+| `/review-week` | Weekly + monthly + quarterly review |
+
+**Project Flow:**
+
+| Command | Purpose |
+|---------|---------|
+| `/ignite` | Start a new project |
+| `/ignite --feature` | Add a feature to an existing project |
+| `/ignite --monetize` | Monetize a project (market validation pipeline) |
+| `/overview` | Refresh context on a project |
+| `/refactor-plan` | Update roadmap after a pivot |
+| `/debrief` | Post-meeting/call capture — actions, decisions, commitments |
+
+**System Flow:**
+
+| Command | Purpose |
+|---------|---------|
+| `/setup` | Onboarding interview (Identity + Strategy + Dossier + Goals) |
+| `/walkthrough` | Interactive guided tour after setup |
+| `/update` | Update Mover OS and migrate Engine files |
+| `/history` | View how your Engine files evolved over time |
+| `/migrate` | Import existing vault content into PARA structure |
+
+**Recovery & Strategy:**
+
+| Command | Purpose |
+|---------|---------|
+| `/reboot` | Recovery after 3+ days away |
+| `/debug-resistance` | Diagnose procrastination and avoidance |
+| `/pivot-strategy` | Formal strategy change with logging |
+| `/harvest` | Extract knowledge to Library |
+| `/capture` | Quick capture and route — links, tasks, ideas, brain dumps |
+| `/mover-report` | Generate progress report or submit feedback |
+| `/mover-ideas` | Vault-wide brainstorm from full Engine context |
+| `/mover-check` | Verify installation integrity |
+
+---
+
+## Architecture
+
+```
+Mover OS Bundle/
+  src/
+    workflows/     # 22 AI command handlers (markdown)
+    system/        # Global Rules + Install Manifest
+    hooks/         # 6 Claude Code lifecycle hooks
+    skills/        # 61 curated skill packs
+    install/       # link.sh (hard-link re-linker)
+    structure/     # Vault template (PARA + Engine)
+```
+
+**Hard-link architecture:** One file, multiple paths. Edit workflows from your editor or from `src/workflows/` — same file on disk. `link.sh` re-establishes links after git operations.
+
+---
+
+## Documentation
+
+- [System Architecture](MANUAL.md) — Deep technical documentation
+- [Install Manifest](src/system/AI_INSTALL_MANIFEST.md) — Complete file inventory
+
+---
+
+Built by [Asmir](https://x.com/AsmirKHAN_).