codymaster 4.8.0 → 7.0.0

package/README.md

@@ -1,22 +1,12 @@
-<div align="center">
+[English](README.md) | [Tiếng Việt](README-vi.md)
 
-[English](README.md) | [Tiếng Việt](README-vi.md) | [中文](README-zh.md) | [Русский](README-ru.md) | [한국어](README-ko.md) | [हिन्दी](README-hi.md)
+# CodyMaster
 
-# 🧠 CodyMaster
+> *"I can't write code. But in 6 months, I shipped 12 real products using AI. CodyMaster is everything I learned — so you don't have to repeat my mistakes."* — **Tody Le**, Head of Product, Creator of CodyMaster
 
-### Your AI Agent is smart. CodyMaster makes it *wise*.
+**50+ skills. One install. Your AI coding agent becomes a full team.**
 
-**68+ Skills · 18 Commands · 1 Plugin · 7+ Platforms · 6 Languages**
-
-<p align="center">
-  <img alt="Version" src="https://img.shields.io/badge/version-4.8.0-blue.svg?cacheSeconds=2592000" />
-  <img alt="Skills" src="https://img.shields.io/badge/skills-68+-success.svg" />
-  <img alt="Platforms" src="https://img.shields.io/badge/platforms-7+-orange.svg" />
-  <img alt="Open Source" src="https://img.shields.io/badge/license-ISC-purple.svg" />
-  <a href="https://github.com/tody-agent/codymaster#readme" target="_blank">
-    <img alt="Documentation" src="https://img.shields.io/badge/documentation-yes-brightgreen.svg" />
-  </a>
-</p>
+**v7.0 — Browse Hybrid Bridge:** AI-native browser automation with a11y snapshots, error collection, video recording.
 
 ```
     ( . \ --- / . )
@@ -24,400 +14,340 @@
     (      u      )
      |  \ ___ /  |
       '--w---w--'
-       Meet CodyMaster 🐹
-  Your smart coding companion.
+       Meet Cody 🐹
 ```
 
-![CodyMaster Kanban Dashboard](assets/images/dashboard.png)
+[![Discord](https://img.shields.io/badge/Discord-Join-7289da?logo=discord&logoColor=white)](https://discord.gg/codymaster)
 
-### 🌟 If CodyMaster saves you time, give it a [Star](https://github.com/tody-agent/codymaster)! 🌟
+---
 
-</div>
+## The Problem
 
----
+You installed an AI coding agent. It writes code fast. But then:
 
-## 🛑 The Problem Nobody Talks About
+- **It designs differently every time** — your brand looks like 3 different companies
+- **It fixes one thing, breaks five others** — you redo the same work over and over
+- **It forgets everything** between sessions — you re-explain your project every morning
+- **It writes zero tests, zero docs** — your codebase becomes a ticking time bomb
+- **You install 15 skills** — none of them talk to each other
 
-You installed an AI coding agent. It's *brilliant*. It writes code faster than any human.
+> *"AI gave me 100 hands. Without discipline, those hands created chaos."*
 
-But then reality hits:
+---
 
-| 😤 What Actually Happens                                                            | 💀 The Real Cost                               |
-| ----------------------------------------------------------------------------------- | ---------------------------------------------- |
-| AI designs**differently every single time** — same brand, 3 different styles | Clients think you're 3 different companies     |
-| AI fixes one bug,**silently breaks 5 other things**                           | You redo the same work 3-4 times               |
-| AI**forgets everything** between sessions                                     | You re-explain the same codebase every morning |
-| AI writes zero tests, zero docs                                                     | Your codebase becomes a house of cards         |
-| You install 15 different skills —**none of them talk to each other**         | Frankenstein toolkit with zero synergy         |
-| Deploy to production =**deploy and pray** 🙏                                  | Broken deploys at 2 AM, no rollback            |
+## The Solution: A Full Senior Team in One Install
 
-> *"AI gave me 100 hands. But without discipline, those hands created chaos."*
-> — **Tody Le**, Head of Product · 10+ years · Creator of CodyMaster
+CodyMaster isn't a collection of random skills. It's an **operating system** for your AI agent — 50+ skills that work together like a real team.
 
----
+**When you install CodyMaster, you hire:**
 
-## 🟢 The Solution: An Entire Senior Team in One Kit
-
-CodyMaster isn't just "another AI skills pack." It's **10+ years of product management experience + 6 months of battle-tested vibe coding**, distilled into 68+ interconnected skills that work as a **single integrated system**.
-
-When you install CodyMaster, you're not adding skills.
-**You're hiring an entire senior team:**
-
-```mermaid
-graph TD
-    A["🧠 CodyMaster Kit"] --> B["👨‍💻 Senior Developer<br/><i>cm-tdd · cm-debugging · cm-code-review · cm-clean-code</i>"]
-    A --> C["🎨 UX Lead<br/><i>cm-design-system · cm-ux-master · cm-ui-preview</i>"]
-    A --> D["📋 Product Manager<br/><i>cm-planning · cm-brainstorm-idea · cm-jtbd</i>"]
-    A --> E["🔒 DevOps Engineer<br/><i>cm-safe-deploy · cm-secret-shield · cm-security-gate · cm-identity-guard</i>"]
-    A --> F["📝 Technical Writer<br/><i>cm-dockit · cm-content-factory · cm-auto-publisher</i>"]
-    A --> G["📈 Growth Marketer<br/><i>cm-ads-tracker · cm-cro-methodology · cm-growth-hacking</i>"]
-    A --> H["🏭 Enterprise Dev<br/><i>cm-booking-calendar · cm-google-form</i>"]
-    style A fill:#fbc531,stroke:#e1b12c,color:#2f3640,stroke-width:3px
-    classDef team fill:#2f3640,stroke:#dcdde1,stroke-width:1px,color:#fff;
-    class B,C,D,E,F,G,H team;
-```
+| Role | What They Do | Key Skills |
+|------|-------------|------------|
+| **Senior Developer** | Write tests first, debug systematically, review code | `cm-tdd` `cm-debugging` `cm-code-review` |
+| **UX Designer** | Extract design systems, preview UI before coding | `cm-design-system` `cm-ux-master` `cm-open-design` |
+| **Product Manager** | Plan features, brainstorm ideas, understand users | `cm-planning` `cm-brainstorm-idea` |
+| **DevOps Engineer** | Safe deploys, secret scanning, right-account checks | `cm-safe-deploy` `cm-identity-guard` |
+| **Tech Writer** | Auto-generate docs, API refs, knowledge base from code | `cm-dockit` `cm-codeintell` |
+| **Automation Lead** | Sprint pipelines, autopilot workflows, status tracking | `cm-sprint-bus` `cm-autopilot` |
 
 ---
 
-## ⚡ What Makes CodyMaster Different
-
-Other skill packs give you loose tools. CodyMaster gives you an **interconnected operating system** for your AI — 68+ skills that chain, share memory, and communicate like a real team.
-
-### 🔄 Full Lifecycle Coverage (Idea → Production)
-
-No gaps. No manual handoffs. Every phase is covered:
-
-```mermaid
-graph LR
-    A["💡 Idea"] --> B["📋 Plan"]
-    B --> C["🎨 Design"]
-    C --> D["🧪 Test First"]
-    D --> E["💻 Code"]
-    E --> F["🔍 Debug"]
-    F --> G["✅ Quality Gate"]
-    G --> H["🔒 Security Scan"]
-    H --> I["🚀 Deploy"]
-    I --> J["📊 Monitor"]
-    J --> K["📝 Document"]
-    K --> L["🧠 Learn & Improve"]
-    L -.-> A
-    classDef phase fill:#353b48,stroke:#fbc531,stroke-width:2px,color:#fff;
-    class A,B,C,D,E,F,G,H,I,J,K,L phase;
-```
+## Quick Start — 30 Seconds
 
-### 🧠 The Unified Brain: 5-Tier Memory + Smart Spine
-
-Your AI doesn't just execute — it **understands and remembers** using a multi-scale, 5-Tier + Smart Spine architecture that persists across sessions and machines:
-
-1. **Sensory Memory (Session)** — Immediate context of active files and terminals.
-2. **Working Memory (`cm-continuity`)** — Cross-session scratchpad. AI never repeats the same mistake.
-3. **Long-Term Memory (`learnings.json`)** — Reinforced lessons with smart Ebbinghaus TTL decay.
-4. **Semantic Memory (`cm-deep-search`)** — Local vector search across docs using `qmd`.
-5. **Structural Memory (`cm-codeintell`)** — AST-based CodeGraph. Up to 95% token compression for full codebase context.
-
-🦴 **Smart Spine (v4.6+)** — The nervous system connecting all 5 tiers:
-- **SQLite + FTS5** — BM25-ranked keyword search replaces flat JSON scans.
-- **Progressive Loading (L0/L1/L2)** — Context loaded at cheapest sufficient depth. 78% token savings.
-- **cm:// URI Scheme** — Skills request context by URI, not file paths.
-- **Token Budget** — 200k window pre-allocated by category. No more silent overflow.
-- **Context Bus** — Skills share outputs in real-time within a chain.
-- **MCP Server** — 13 tools exposed to Claude Desktop and any MCP client (`src/mcp-context-server.ts`).
-- **OpenViking Backend natively integrated** — Inspired by OpenViking's architecture, CodyMaster defaults to `openviking` auto-installation. It delivers true semantic vector graph memory, automatic session compression, and temporal context layering. (One config line change: `storage.backend: viking`).
-
-☁️ **The Cloud Brain (`cm-notebooklm`)**
-High-value knowledge and design patterns are synced to NotebookLM, providing a universal, cross-machine "Soul" for your project. Auto-generate podcasts and flashcards to onboard human developers alongside the AI.
-
-📖 [CodyMaster Brain & memory model →](docs/architecture/codymaster-brain.md)
-
-### 🛡️ Multi-Layer Protection (Your Codebase Won't Get Destroyed)
-
-Every line of code passes through multiple safety gates before reaching production:
-
-```mermaid
-flowchart LR
-    subgraph "Layer 1: Write"
-        A["cm-tdd<br/>Tests First"] --> B["cm-code-review"]
-    end
-    subgraph "Layer 2: Secure"
-        B --> C["cm-secret-shield<br/>Leak Scan"] --> S["cm-security-gate<br/>Vuln Scan"] --> D["cm-identity-guard<br/>Right Account"]
-    end
-    subgraph "Layer 3: Isolate"
-        D --> E["cm-git-worktrees<br/>Isolated Branch"]
-    end
-    subgraph "Layer 4: Deploy"
-        E --> F["cm-quality-gate<br/>Evidence Check"] --> G["cm-safe-deploy<br/>Multi-Gate Pipeline"]
-    end
-    style A fill:#e84118,stroke:#c23616,color:#fff
-    style C fill:#e84118,stroke:#c23616,color:#fff
-    style F fill:#0097e6,stroke:#00a8ff,color:#fff
-    style G fill:#4cd137,stroke:#44bd32,color:#fff
+**Step 1: Install**
+
+```bash
+npm install -g codymaster && cm
 ```
 
-> **Result:** Zero leaked secrets. Zero wrong-account deploys. Zero "worked on my machine" failures.
+A wizard detects your AI tools (Claude Code, Cursor, Gemini, etc.) and installs skills to all of them.
 
-### 🎨 Design System Builder — Even From Old Products
+**Step 2: Start coding**
 
-Got a legacy product with no design system? **cm-design-system** scans your website, extracts colors, typography, spacing, and tokens, then rebuilds a proper design system. Preview designs visually with **Pencil.dev** or **Google Stitch** before writing a single line of code.
+Open your AI agent and say what you want:
 
-### 📝 Zero Documentation? No Problem.
+```
+Build a landing page for my coffee shop
+```
 
-Don't know what the old code does? **`cm-dockit`** reads your entire codebase and generates:
+**Step 3: Watch it work**
 
-- 📚 Technical architecture docs
-- 📖 User guides & SOPs
-- 🔌 API references
-- 🎯 Persona analysis & JTBD mapping
-- 🌐 Multi-language. SEO-optimized.
+CodyMaster automatically chains the right skills:
+`cm-brainstorm-idea` → `cm-design-system` → `cm-execution` → `cm-safe-deploy`
 
-**One scan = Complete knowledge base.**
+That's it. No config files. No setup ritual. Just describe what you want.
 
-### 💡 Strategic Brainstorming (Design Thinking + 9 Windows)
+---
 
-Before diving into code for complex requests, **`cm-brainstorm-idea`** evaluates your product using multi-dimensional analysis (Tech, Product, Design, Business). It generates 2-3 qualified options using the 9 Windows (TRIZ) framework and provides a visual UI Preview via **Pencil.dev** or **Google Stitch** to validate the direction before detailed planning. 
+## See It Work
 
-📖 [TRIZ-parallel workflow & UI preview handoff →](docs/architecture/triz-parallel-engine.md)
+Here's a real conversation — a non-technical founder building a booking site:
 
+```
+You:    I want to build a booking website for my spa business.
+        I have an old website at myspa.com but it looks terrible.
+
+AI:     [cm-brainstorm-idea] Let me analyze your current site first...
+        I found 3 key issues: no mobile booking, unclear pricing,
+        slow load time. Here are 2 approaches:
+        A) Redesign from scratch (recommended — your brand needs it)
+        B) Fix the existing site
+        
+You:    Let's go with A.
+
+AI:     [cm-design-system] I'm extracting your brand colors from
+        myspa.com... Found: gold + navy. Building a design system.
+        [cm-planning] Here's the plan: booking page, services page,
+        about page, contact. Estimated: 30 minutes of AI work.
+        
+You:    Sounds good, do it.
+
+AI:     [cm-tdd] Writing tests first...
+        [cm-execution] Building 4 pages...
+        [cm-dockit] Generating service descriptions and FAQ docs...
+        [cm-quality-gate] All tests pass. Performance: 98/100.
+        [cm-safe-deploy] Deploying to staging...
+        
+        ✅ Done. Preview: https://staging-myspa.pages.dev
+        
+You:    The booking button is too small on mobile.
+
+AI:     [cm-debugging] Found it — padding was 8px, should be 16px.
+        [cm-code-review] Fix looks good. No side effects.
+        [cm-safe-deploy] Deployed fix.
+        
+        ✅ Fixed. Try now.
+```
 
-### 🏭 AI Content Factory v2.0 & Visual Dashboard
+**No code written by the human. No bugs introduced by the AI.** The system caught the mobile issue before it reached production.
 
-Need to scale content? **`cm-content-factory`** is a self-learning, multi-agent content engine. It automatically researches, writes, audits (SEO & Persuasion), and deploys high-converting articles with the Content Mastery framework (StoryBrand + Cialdini) to guarantee conversion.
+---
 
-Track it all on the **Visual Dashboard** (`cm-dashboard`): No more guessing. Track every task, every agent, every deployment on a real-time Kanban board. Pipeline progress, token tracker, event log — all on one screen.
+## What Makes This Different
 
-### 🧬 Self-Healing AI (Skills That Fix Themselves)
+| | 😵 Random Skills | 🧠 CodyMaster |
+|---|---|---|
+| **Integration** | Each skill is standalone | 50+ skills that chain and share memory |
+| **Memory** | Forgets everything between sessions | Remembers your project, your style, your mistakes |
+| **Safety** | Deploy and pray | Multi-layer protection: tests → security → staging → production |
+| **Design** | Random UI every time | Extracts your brand, enforces consistency |
+| **Documentation** | "Maybe later" | Auto-generates docs from your code |
+| **Self-improvement** | Static — what you install is what you get | Learns from feedback, gets better over time |
 
-CodyMaster doesn't just run skills — it **watches them, scores them, and heals them automatically.**
+---
 
-- **`cm-skill-health`** monitors every invocation: success rate, token usage, error patterns.
-- **`cm-skill-evolution`** auto-patches degraded skills (Mode: FIX) when health scores drop below threshold.
-- **`cm-skill-chain` Auto-Dispatch** — Inspired by OpenSpace automation orchestrators, sequence dispatching is now 100% automated with intelligent task detection, zero-touch handoffs, and multi-agent coordination.
-- **`cm-skill-search`** uses BM25 ranking to find the right skill for any task.
-- **`cm-skill-share`** exports & imports skills across teams and machines.
+## Built For Builders, Not Coders
 
-> **Think of it like an immune system for your AI toolkit.** Skills that break get healed. Skills that work well get reinforced. Dead skills get archived.
+CodyMaster was built for people who **have ideas, not CS degrees**.
 
-### 🚀 Growth Hacking Engine
+**You're a good fit if you:**
+- Want to type a message and get a working product back
+- Want your AI to learn from its mistakes
+- Don't want to manually review every line of AI output
+- Want to deploy with confidence, not prayer
 
-Need popups, booking flows, or lead capture? **`cm-growth-hacking`** generates complete conversion systems: Bottom Sheet + Calendar CTA + Tracking. Auto-detects industry, selects the right pattern, wires up **`cm-booking-calendar`** for appointments and **`cm-ads-tracker`** for pixel tracking. Zero dependencies.
+**You're NOT a good fit if you:**
+- Enjoy doing the same setup for every project
+- Prefer slow, manual deploys with no safety net
+- Like re-explaining your codebase every morning
 
 ---
 
-## 🆚 Scattered Skills vs CodyMaster
+## The 10-Second Tour
 
-|                            | 😵 15 Random Skills                         | 🧠 CodyMaster                                                         |
-| -------------------------- | ------------------------------------------- | --------------------------------------------------------------------- |
-| **Integration**      | Each skill is standalone, no shared context | 68+ skills that chain, share memory, and communicate                   |
-| **Lifecycle**        | Covers coding only                          | Covers Idea → Design → Code → Test → Deploy → Docs → Learn      |
-| **Memory**           | Forgets everything between sessions         | 5-tier Unified Brain: Sensory → Working → Long-term → Semantic → Structural + Cloud Brain. Optional **OpenViking** backend for vector search + auto memory compression. |
-| **Safety**           | YOLO deploys                                | 4-layer protection: TDD → Security → Isolation → Multi-gate deploy |
-| **Design**           | Random UI every time                        | Extracts & enforces design system + visual preview                    |
-| **Documentation**    | "Maybe write a README later"                | Auto-generates complete docs, SOPs, API refs from code                |
-| **Self-improvement** | Static — what you install is what you get  | Self-healing: monitors health → auto-patches → reinforces winners   |
-| **Maintenance**      | Update 15 repos separately                  | One `npm i -g codymaster` updates everything                        |
-
----
+Instead of listing 50+ skills, here's what CodyMaster does in plain language:
 
-## 🦥 Built For Lazy People (Seriously)
+### 💡 Before You Build
+- **Thinks before coding** — asks questions, challenges your assumptions, saves you from building the wrong thing
+- **Plans the architecture** — diagrams, data flow, edge cases — all before writing code
 
-We're going to be honest: **CodyMaster was built for lazy people.**
+### 🎨 While Building
+- **Enforces your design system** — consistent colors, fonts, spacing across every page
+- **Writes tests first** — catches bugs before they exist
+- **Debugs systematically** — traces the root cause, doesn't guess
 
-If you want to:
+### 🚀 Before Shipping
+- **Scans for secrets** — no API keys leaking to GitHub
+- **Checks the right account** — no accidental deploys to the wrong Cloudflare
+- **Runs quality gates** — no deploy without passing tests + performance checks
 
-- ✅ Type a chat message and get a **working product** back
-- ✅ Have your AI **learn from its mistakes** and get better every day
-- ✅ Never setup the same boilerplate twice
-- ✅ Deploy with **confidence** instead of praying
+### 📈 After Shipping
+- **Generates documentation** — reads your code, writes the docs
+- **Learns from feedback** — gets smarter with every project
+- **Runs retrospectives** — captures what worked, what didn't, improves the process
 
-**→ CodyMaster is for you.**
+📖 [Full skill reference →](skills/)
 
-If you prefer:
+---
 
-- ❌ Manually reviewing every line of AI output
-- ❌ Doing the same setup ritual for every project
-- ❌ Slow, manual deploys with no safety net
+## The Design Pipeline
 
-**→ CodyMaster is NOT for you.**
+CodyMaster treats design as a **first-class discipline** — not an afterthought. Your AI doesn't just write code; it enforces visual consistency across every page.
 
----
+**Three ways to get a design system:**
 
-## 🚀 1-Minute Install
+| Method | When to Use | How |
+|--------|-------------|-----|
+| **Extract from URL** | You have an existing brand/site | `cm-open-design` analyzes your site, extracts colors, fonts, spacing |
+| **Pick from 129 systems** | You want a proven aesthetic | Choose from Linear, Stripe, Vercel, Notion, Apple, Tesla, and 123 more |
+| **Choose a direction** | You have no brand yet | Pick from 5 curated styles: Editorial, Modern Minimal, Warm Soft, Tech Utility, Brutalist |
 
-### 1. Install AI Skills (All Platforms)
+```
+Extract → Tokens → Validate → Build → QA
+   │          │         │          │       │
+   │          │         │          │       └─ cm-quality-gate
+   │          │         │          └─ cm-execution
+   │          │         └─ cm-ux-master (48 UX laws)
+   │          └─ cm-design-system (STITCH_TOKENS)
+   └─ cm-open-design (129 systems + extraction)
+```
 
-One command installs all 68+ skills to your environment. Supports Claude Code, Gemini CLI, Cursor, Aider, Windsurf, Cline, OpenCode, and more:
+📖 [Full design pipeline guide →](docs/design-pipeline.md)
 
-```bash
-bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --all
-```
+---
 
-#### After `install.sh --all` (verify)
+## Real-World Scenarios
 
-- **Restart** Claude Code, Cursor, or Gemini / Antigravity so they reload config and rules from disk.
-- **Cursor:** rules go to **`~/.cursor/rules`** (always under your home folder, not wherever you ran the script). In Agent chat, run **`/add-plugin cody-master`**. To install rules **only inside one git repo**, run from that repo: `bash install.sh --cursor --cursor-project`.
-- **Gemini / Antigravity:** skills live in `~/.gemini/antigravity/skills`. The installer **creates or appends** `~/.gemini/GEMINI.md` with `@~/.gemini/antigravity/skills/cm-skill-index/SKILL.md` when that hint is missing.
-- **Claude Code:** if commands like `/cm:demo` do not appear, run `claude plugin marketplace add tody-agent/codymaster` then `claude plugin install cm@codymaster --scope user` (or `--scope project`).
-- **Non-interactive:** `--all` skips the onboarding menu. For a single platform, add **`--yes`** (e.g. `bash install.sh --gemini --yes`).
+| You Say | What Happens |
+|---------|-------------|
+| *"Fix this bug"* | `cm-debugging` finds root cause → `cm-tdd` writes test → `cm-quality-gate` verifies |
+| *"Build a landing page"* | `cm-brainstorm-idea` → `cm-design-system` → `cm-execution` → `cm-safe-deploy` |
+| *"Make it look like Stripe"* | `cm-open-design` extracts Stripe tokens → `cm-design-system` applies → `cm-execution` builds |
+| *"Deploy to production"* | `cm-secret-shield` → `cm-security-gate` → `cm-identity-guard` → `cm-safe-deploy` |
+| *"What does this code do?"* | `cm-codeintell` reads the codebase → `cm-dockit` generates docs |
+| *"Add Vietnamese support"* | `cm-safe-i18n` extracts strings → translates → validates → ships |
+| *"Start a new project"* | `cm-project-bootstrap` scaffolds → `cm-planning` plans → `cm-execution` builds |
 
-#### Google Antigravity / Gemini CLI / Windsurf (token budget)
+---
 
-Antigravity and some Windsurf builds count **skills + MCP** against a customization token budget. Installing every skill globally can trigger truncation or unstable agent runs (especially if an MCP server errors and retries).
+## Install
 
-- **Recommended:** install a **small global profile**, add the rest per project.
+### One command
 
 ```bash
-# Core only → ~/.gemini/antigravity/skills (merge more profiles later with the same command)
-bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --gemini --profile core
-
-# Optional packs (re-run to add folders alongside core)
-bash install.sh --gemini --profile growth
-bash install.sh --gemini --profile design
-bash install.sh --gemini --profile knowledge
+npm install -g codymaster && cm
 ```
 
-- **Paths:** Antigravity / Gemini CLI skills → `~/.gemini/antigravity/skills`. This repo’s installer for **Windsurf** writes to **project** `.windsurf/rules` when you run `install.sh --windsurf` from a repo root. Some Windsurf/Codeium setups also use a **global** skills directory (e.g. under Codeium); if you copy skills there manually, use the same `--profile` flags to avoid duplicating hundreds of rules.
-- **MCP:** Disable MCP servers you are not using in the IDE settings. Flaky or rate-limited MCPs can cause “MCP Error” loops until the agent terminates.
-- **Progressive disclosure:** Add `@~/.gemini/antigravity/skills/cm-skill-index/SKILL.md` to `GEMINI.md` so the model loads the index before pulling full skills.
-
-Profiles are defined under [`skills/profiles/`](skills/profiles/README.md).
+### What the wizard does
 
-*For Cursor IDE users, you can also just type `/add-plugin cody-master` in your agent chat.*
+1. **Detects** every AI tool you have (Claude Code, Cursor, Gemini CLI, Codex, OpenCode, Windsurf, Cline, Aider, Continue, Kiro, Amazon Q, Amp, Copilot, Claude Desktop)
+2. **Asks** which ones you want skills for (pre-checked for detected tools)
+3. **Installs** to each platform's native location
+4. **Done** — open your AI agent and start building
 
-### 2. Install Mission Control Dashboard (Optional but Recommended)
-
-Visualize your progress, manage tasks, and track your 10x coding streak with Cody the Hamster 🐹.
-
-**Both are official:** install **per project** (no `-g`) or **globally**.
-
-Per project — keeps the CLI version with the repo (use `npx` so you do not need `cm` on your PATH):
+### After install
 
 ```bash
-npm install codymaster
-npx cm
+cm doctor          # Check what's installed
+cm status          # See your tasks and progress
+cm dashboard       # Open the visual dashboard
 ```
 
-Global — type `cm` from any directory:
+### No Node.js?
 
 ```bash
-npm install -g codymaster
-cm
+bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --all --profile core
 ```
 
-The CLI will greet you and keep you organized on your long coding sessions!
+---
 
-```text
-    ( . \ --- / . )
-     /   ^   ^   \        Hi! I'm Cody 🐹
-    (      u      )        Your smart coding companion.
-     |  \ ___ /  |
-      '--w---w--'
+## The Dashboard
 
-│
-◆  Quick menu
-│  ● 📊  Dashboard (Start & open)
-│  ○ 📋  My Tasks
-│  ○ 📈 Status
-│  ○ 🧩  Browse Skills
+Visual mission control for your projects:
+
+```
+┌─────────────────────────────────────────────┐
+│           📊 CodyMaster Dashboard           │
+│  Tasks │ Progress │ Tokens │ Logs           │
+└─────────────────────────────────────────────┘
 ```
 
-</details>
+```bash
+cm dashboard start   # Start the dashboard
+cm dashboard open    # Open in browser
+```
+
+Track tasks, monitor progress, see what your AI team is doing — all in one screen.
 
 ---
 
-## 🧰 The 68+ Skill Arsenal
+## How It Works Under the Hood
+
+For the curious (skip this if you just want to build):
+
+- **Memory System** — Your AI remembers your project across sessions. No more re-explaining.
+- **Skill Chaining** — Skills talk to each other. Planning feeds into design, design feeds into code, code feeds into tests.
+- **Behavioral Discipline** — Inspired by [Andrej Karpathy's AI coding rules](https://x.com/karpathy/status/2015883857489522876). Your AI thinks before coding, keeps things simple, makes surgical changes.
+- **Multi-Layer Safety** — Tests → security scan → staging → production. Each layer catches what the previous missed.
+- **Self-Healing** — Skills learn from failures and improve over time.
 
-| Domain                    | Skills                                                                                                                                                          |
-| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 🔧 **Engineering**   | `cm-tdd` `cm-debugging` `cm-quality-gate` `cm-test-gate` `cm-code-review` `cm-clean-code`                                                                             |
-| ⚙️ **Operations**  | `cm-safe-deploy` `cm-identity-guard` `cm-secret-shield` `cm-security-gate` `cm-git-worktrees` `cm-terminal` `cm-safe-i18n`                                             |
-| 🎨 **Product & UX**  | `cm-planning` `cm-design-system` `cm-ux-master` `cm-ui-preview` `cm-project-bootstrap` `cm-jtbd` `cm-brainstorm-idea` `cm-dockit` `cm-readit` |
-| 📈 **Growth & CRO**    | `cm-content-factory` `cm-auto-publisher` `cm-ads-tracker` `cm-cro-methodology` `cm-growth-hacking` `cm-booking-calendar` `cm-google-form`                                                                                                   |
-| 🏢 **Enterprise**  | `cm-reactor` `cm-notebooklm`                                                                                                  |
-| 🧬 **Self-Healing**   | `cm-skill-health` `cm-skill-evolution` `cm-skill-search` `cm-skill-share` `cm-skill-chain` `cm-skill-mastery` `cm-skill-index`             |
-| 🎯 **Orchestration** | `cm-execution` `cm-continuity` `cm-deep-search` `cm-codeintell` `cm-how-it-work`             |
-| 🖥️ **Workflow**    | `cm-start` `cm-dashboard` `cm-status`                                                                                                                     |
+📖 [Architecture deep dive →](docs/architecture/codymaster-brain.md)
 
 ---
 
-## 🎮 Commands
+## For Teams & Advanced Users
 
-Run `cm --help` (or `node dist/index.js --help` from a clone) for the **authoritative** list. Highlights from `src/cli/command-registry.ts`:
+### Multiple AI Agents
 
-```
-cm, codymaster              → CLI entry
-cm status                   → Task & project summary
-cm task <cmd> [args...]     → Task management
-cm project <cmd> [args...]  → Project management
-cm deploy <cmd> [args...]   → Deploy / rollback / history / changelog
-cm dashboard [start|stop|status|open|url] → Mission Control (default :6969)
-cm agent [status|memory|brain|learn]      → Working memory / learnings
-cm brain                    → Continuity + next actions
-cm chain <cmd> [args...]    → Skill chain execution
-cm config [key] [value]   → Config helper
-cm open                     → Open dashboard in browser
-cm browse …                 → Local Playwright browse daemon (QA)
-cm guardian …               → Destructive-command / path checks
-cm sprint …                 → Sprint pipeline + .cm/sprint
-cm design-studio [init|status]
-cm distro validate …        → Validate skill pack layout
+Works with 14+ platforms out of the box:
+
+```bash
+cm install claude-code --profile core
+cm install cursor --profile growth
+cm install gemini --profile full
 ```
 
-**Memory, bus, budgets, `cm://` resolution:** use the **MCP context server** — see [docs/api/api-reference.md](docs/api/api-reference.md).
+### MCP Server
 
-**Engineering (browse, guardian, sprint):** [docs/workflows/engineering-pipeline.md](docs/workflows/engineering-pipeline.md) · [docs/architecture/servers-and-mcp.md](docs/architecture/servers-and-mcp.md)
+Use CodyMaster as an MCP server for Claude Desktop:
 
 ```bash
-# OpenViking backend (optional — semantic vector search)
-pip install openviking && openviking start
-# Then set storage.backend: viking in .cm/config.yaml
+npx codymaster mcp-serve --install-claude
 ```
 
-**Slash Commands (inside AI agents):**
+### Goose Integration
 
-```
-/cm:demo         → Interactive onboarding tour
-/cm:plan         → Plan a feature with analysis
-/cm:build        → Build with strict TDD
-/cm:debug        → Systematic debugging
-/cm:ux           → Design system extraction & UI preview
+```bash
+cm mcp-serve --print-config  # Paste into Goose config
 ```
 
----
+📖 [All integrations →](docs/integrations/)
 
-## 👤 Who Built This
+---
 
-**Tody Le** — Head of Product with 10+ years of experience. Can't write code. Used AI to build real products for 6 months straight. Every skill in this kit was born from a real failure that cost real time and real tears.
+## Contributing
 
-> *"68+ skills. Each skill is a lesson. Each lesson is a sleepless night. And now, you don't have to go through those nights."*
+1. ⭐ **Star the repo** — helps more builders find this
+2. Fork → Create `skills/cm-your-skill/SKILL.md`
+3. Submit a Pull Request
 
-📖 [Read the full story →](https://cody.todyle.com/story)
+CI runs `npm run test:gate:kit` on every push and PR.
 
 ---
 
-## 📚 Resources
+## Resources
 
-- 🌍 [Website](https://cody.todyle.com) — Overview & demos
-- 📖 [Documentation (site)](https://cody.todyle.com/docs) — Hosted deep-dive
-- 📘 [Documentation (repo)](docs/index.md) — Markdown source; run `npm run docs:dev` for VitePress
-- 🛠️ [Skills Reference](skills/) — Browse **56** bundled `cm-*` SKILL.md packs (profiles/installer can add more)
-- 📖 [Our Story](https://cody.todyle.com/story) — Why this exists
+| Resource | Link |
+|----------|------|
+| 🌍 Website | [cody.todyle.com](https://cody.todyle.com) |
+| 📖 Docs | [cody.todyle.com/docs](https://cody.todyle.com/docs) |
+| 📘 Repo Docs | [docs/index.md](docs/index.md) |
+| 🎨 Design Pipeline | [docs/design-pipeline.md](docs/design-pipeline.md) |
+| 🛠️ Skills | [skills/](skills/) |
+| 📖 Our Story | [cody.todyle.com/story](https://cody.todyle.com/story) |
 
 ---
 
-## 🤝 Contributing
+## Who Built This
 
-1. ⭐ **Star the repo** — it helps more builders find this
-2. Fork → Create `skills/cm-your-skill/SKILL.md`
-3. Submit a Pull Request
+**Tody Le** — Head of Product with 10+ years of experience. Can't write code. Used AI to build real products for 6 months straight. Every skill in this kit was born from a real failure that cost real time and real tears.
 
-CI runs `npm ci` and `npm run test:gate:kit` on pushes and pull requests (see `.github/workflows/ci.yml`).
+> *"50+ skills. Each skill is a lesson. Each lesson is a sleepless night. And now, you don't have to go through those nights."*
 
 ---
 
-<div align="center">
+*ISC License — Free to use, modify, and distribute.*
 
-*ISC License — Free to use, modify, and distribute.* <br/>
 **Built with ❤️ for the vibe coding community.**
 
 *"CodyMaster" = "Code Đi" (Vietnamese: "Go code!") — just start building.*
-
-</div>