mover-os 4.0.0

package/README.md

@@ -0,0 +1,201 @@
+# 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.
+
+**Version:** 4 | **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.
+- **17 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
+git clone https://github.com/azkhh/Mover-OS.git
+cd "Mover-OS/01_Projects/Mover OS Bundle"
+node install.js
+```
+
+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. Install vault structure, rules, workflows, skills, and hooks
+
+> **Requires:** Node.js 18+ (zero dependencies). Or use `bash src/install/install.sh` for the non-interactive shell installer.
+
+### 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.
+
+---
+
+## Supported Agents
+
+The installer auto-detects and configures all of these:
+
+| Agent | Tier | What Gets Installed |
+|-------|------|---------------------|
+| Claude Code | Full | Rules + 17 commands + 44 skills + 6 hooks |
+| Cursor | Full | Rules + 17 commands + 44 skills |
+| Cline | Full | Rules + 44 skills |
+| Codex (OpenAI) | Enhanced | AGENTS.md + global instructions |
+| Windsurf | Enhanced | Rules |
+| OpenClaw | Enhanced | AGENTS.md + SOUL.md + 44 skills |
+| Antigravity | Basic+ | Rules + 17 workflows |
+| Roo Code | Basic | Rules |
+| GitHub Copilot | Basic | Rules |
+| Amp | Basic | AGENTS.md + rules |
+| Aider | Basic | AGENTS.md |
+
+**Tier 1 (Full):** Rules + slash commands + skills + hooks where supported.
+**Tier 2 (Enhanced):** Rules + skills or AGENTS.md.
+**Tier 3 (Basic):** Rules only (still powerful — the Global Rules carry the system).
+
+---
+
+## How It Works
+
+### The Engine
+
+Your `02_Areas/Engine/` folder is the brain. Seven 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 or feature |
+| `/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` | Guided tour after setup |
+| `/update` | Update Mover OS and migrate Engine files |
+| `/history` | View how your Engine files evolved over time |
+
+**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 |
+
+---
+
+## Updating
+
+Already have Mover OS installed? Update without losing your Engine data:
+
+```bash
+cd "Mover-OS/01_Projects/Mover OS Bundle"
+git pull
+node install.js --update
+```
+
+Or re-link hard links after any git operation:
+
+```bash
+bash src/install/link.sh
+```
+
+Engine files (Identity, Strategy, Dossier, etc.) are never overwritten during updates.
+
+---
+
+## Architecture
+
+```
+Mover OS Bundle/
+  src/
+    workflows/     # 17 AI command handlers (markdown)
+    system/        # Global Rules + Install Manifest
+    hooks/         # 6 Claude Code lifecycle hooks
+    skills/        # 43 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.
+
+**AGENTS.md:** Generated alongside native rule formats for universal agent compatibility (Linux Foundation standard).
+
+---
+
+## 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_).