@namch/agent-assistant 1.0.0 → 1.0.2

package/README.md

@@ -6,379 +6,173 @@
 
 **Multi-agent orchestration for AI coding assistants**
 
-Transform one AI into a coordinated team of 20 specialist agents with structured workflows, quality gates, and 218+ domain skills.
+Transform one AI into a coordinated team of 20 specialist agents with structured workflows and 310+ domain skills.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js 18+](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org/)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
-[![npm version](https://img.shields.io/npm/v/agent-assistant.svg)](https://www.npmjs.com/package/agent-assistant)
 
 ---
 
-## Table of Contents
-
-- [What is Agent Assistant?](#what-is-agent-assistant)
-- [Why use it?](#why-use-it)
-- [Measured Results](#measured-results)
-- [Supported Tools](#supported-tools)
-- [Installation](#installation)
-- [Quick Start](#quick-start)
-- [Commands](#commands)
-- [Agents](#agents)
-- [Matrix Skill Discovery](#matrix-skill-discovery)
-- [Project Structure](#project-structure)
-- [Architecture](#architecture)
-- [Documentation](#documentation)
-- [Uninstall](#uninstall)
-- [Configuration](#configuration)
-- [Contributing](#contributing)
-- [License & Support](#license--support)
+## Why Agent Assistant?
 
----
-
-## What is Agent Assistant?
-
-Agent Assistant is an **orchestration layer** between you and your AI coding tool. Instead of one model doing everything, it transforms the AI into a **multi-agent workflow**:
-
-```
-┌──────────┐     ┌──────────────┐     ┌─────────────┐     ┌────────────┐     ┌──────────┐
-│   You    │────▶│   Command    │────▶│ Orchestrator│────▶│ Specialist │────▶│  Output  │
-│          │     │ /cook /fix   │     │             │     │   Agents   │     │          │
-└──────────┘     └──────────────┘     └─────────────┘     └────────────┘     └──────────┘
-                                             │                    │
-                                             ▼                    ▼
-                                      ┌─────────────┐     ┌────────────┐
-                                      │    Rules    │     │   Skills   │
-                                      │ (8 files)   │     │ (218+)     │
-                                      └─────────────┘     └────────────┘
-```
-
-### Key Components
-
-| Component             | Count | Purpose                                                   |
-| --------------------- | ----- | --------------------------------------------------------- |
-| **Specialist Agents** | 20    | Domain experts (backend, frontend, security, tester, ...) |
-| **Command Workflows** | 40+   | Development workflows (/cook, /fix, /plan, /deploy, ...)  |
-| **Domain Skills**     | 218   | On-demand knowledge (React, APIs, databases, DevOps, ...) |
-| **Matrix Domains**    | 19    | Skill categories (backend, frontend, security, ...)       |
-| **Quality Gates**     | 5     | Compile, lint, test, security, review                     |
-| **Rule Files**        | 8     | Orchestration protocols and laws                          |
-
----
-
-## Why use it?
+| 🎯 Feature                      | What It Does                                                                                                                                                                                   |
+| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **One-Time Setup, Forever Use** | Configure once at global level (`~/.cursor/`, `~/.claude/`, etc.) and it auto-applies to ALL your projects. No more repetitive config for every new repo.                                      |
+| **Sub-Agent Orchestration**     | When supported (Claude Code, Cursor Max mode), the main agent spawns specialized sub-agents to handle tasks **in parallel** — backend, frontend, testing, security all working simultaneously. |
+| **Multi-Platform Support**      | Works seamlessly across **Cursor**, **GitHub Copilot**, **Claude Code**, and **Antigravity/Gemini**. Same workflows, any tool.                                                                 |
+| **Matrix Skill Discovery**      | Automatically injects the right skills into each agent based on their profile and your request. 310+ skills, zero manual config.                                                               |
 
-| Without Agent Assistant     | With Agent Assistant                    |
-| --------------------------- | --------------------------------------- |
-| One AI, one style, no gates | 20 experts + workflows + quality checks |
-| Easy to miss tests/security | Built-in test, review, security flows   |
-| Inconsistent patterns       | Shared rules, skills, and conventions   |
-| High token usage            | 85% token cost reduction                |
-| Ad-hoc prompts              | Structured, repeatable workflows        |
+### The Goal
 
-Use Agent Assistant when you want **structured, repeatable, production-oriented** AI-assisted coding instead of ad-hoc prompts.
+> **Code less, deliver more.** Reduce token costs by 85%, cut bugs by 70%, and stop wasting time on repetitive tasks.
 
 ---
 
-## Measured Results
+## Quick Results
 
 | Metric                | Improvement       |
 | --------------------- | ----------------- |
 | ⏰ Time-to-Production | **70% faster**    |
 | 🐛 Bug Rate           | **70% reduction** |
-| 🔒 Security Issues    | **70% reduction** |
 | 💰 Token Cost         | **85% savings**   |
 
 ---
 
-## Supported Tools
+## Installation
 
-| Tool                             | Status          | Integration                   |
-| -------------------------------- | --------------- | ----------------------------- |
-| **Claude Code** (claude.ai/code) | ✅ Full Support | CLI → `~/.claude/`            |
-| **Cursor**                       | ✅ Full Support | CLI → `~/.cursor/`            |
-| **GitHub Copilot** (VS Code)     | ✅ Full Support | CLI → `~/.copilot/` + VS Code |
-| **Antigravity / Gemini**         | ✅ Full Support | CLI → `~/.gemini/`            |
+### Global Package (Recommended)
 
----
+```bash
+npm install -g @namch/agent-assistant
 
-## Installation
+# After installing globally, run:
 
-### Prerequisites
+agent-assistant install cursor # Setup for Cursor
+agent-assistant install claude # Setup for Claude Code
+agent-assistant install copilot # Setup for GitHub Copilot
+agent-assistant install antigravity # Setup for Antigravity/Gemini
+agent-assistant install --all # Setup for ALL tools
+```
 
-- **Node.js 18+**
-- At least one supported AI tool
+### From Source
 
-### Option A: npm Global Install (Recommended)
+```bash
+# Clone
+git clone https://github.com/hainamchung/agent-assistant.git
+cd agent-assistant
 
-1. **Install globally**
+# Install for your tool(s)
+node cli/install.js install cursor      # Cursor
+node cli/install.js install claude      # Claude Code
+node cli/install.js install copilot     # GitHub Copilot
+node cli/install.js install antigravity # Antigravity/Gemini
+node cli/install.js install --all       # All tools
+```
 
-   ```bash
-   npm install -g @namch/agent-assistant
-   ```
+That's it. The framework installs globally and works across all your projects.
 
-2. **Install for your tool**
+## Uninstall
 
-   ```bash
-   # Single tool
-   agent-assistant install cursor
-   agent-assistant install copilot
-   agent-assistant install antigravity
-   agent-assistant install claude
+### Remove configurations
 
-   # All supported tools
-   agent-assistant install --all
-   ```
+```bash
+agent-assistant uninstall cursor      # Remove from Cursor
+agent-assistant uninstall claude      # Remove from Claude Code
+agent-assistant uninstall copilot     # Remove from GitHub Copilot
+agent-assistant uninstall antigravity # Remove from Antigravity/Gemini
+agent-assistant uninstall --all       # Remove from ALL tools
+```
 
-3. **Verify installation**
+### Remove global package
 
-   ```bash
-   agent-assistant list
-   ```
+```bash
+npm uninstall -g @namch/agent-assistant
+```
 
-### Option B: Clone and Install
+### From Source
 
 ```bash
-git clone https://github.com/nals-ai/agent-assistant.git
 cd agent-assistant
-node cli/install.js install --all   # Installs for all tools globally
+node cli/install.js uninstall cursor      # Remove from Cursor
+node cli/install.js uninstall claude      # Remove from Claude Code
+node cli/install.js uninstall copilot     # Remove from GitHub Copilot
+node cli/install.js uninstall antigravity # Remove from Antigravity/Gemini
+node cli/install.js uninstall --all   # Remove from all tools
+# Then remove the directory
+cd ..
+rm -rf agent-assistant
 ```
 
-### What Gets Installed
-
-| Component   | Cursor                              | Copilot                              | Claude Code                         | Antigravity              |
-| ----------- | ----------------------------------- | ------------------------------------ | ----------------------------------- | ------------------------ |
-| Entry point | `~/.cursor/rules/`                  | VS Code prompts                      | `~/.claude/CLAUDE.md`               | `~/.gemini/GEMINI.md`    |
-| Commands    | `~/.cursor/commands/`               | `~/.copilot/commands/`               | `~/.claude/commands/`               | workflows                |
-| Framework   | `~/.cursor/skills/agent-assistant/` | `~/.copilot/skills/agent-assistant/` | `~/.claude/skills/agent-assistant/` | `~/.gemini/antigravity/` |
-| Agents      | `~/.cursor/agents/`                 | `~/.copilot/agents/`                 | `~/.claude/agents/`                 | `~/.gemini/agents/`      |
-| Skills      | `~/.cursor/skills/`                 | `~/.copilot/skills/`                 | `~/.claude/skills/`                 | in framework             |
-
 ---
 
 ## Quick Start
 
-### 1. Generate Project Documentation (Recommended First Step)
+### 1. Generate Project Docs (Recommended)
 
 ```bash
-/docs:core       # Generate 5 core technical docs
-/docs:business   # Generate 4 business docs
+/docs:core       # Technical docs for AI context
+/docs:business   # Business requirements
 ```
 
-This creates files in `./documents/` that agents use when implementing features. **Without these docs, agents work generically. With them, agents follow YOUR project's patterns.**
+Creates `./documents/` files that agents reference. Without docs, agents work generically. With docs, they follow YOUR patterns.
 
-### 2. Try Your First Commands
+### 2. Start Building
 
 ```bash
-# Simple feature (2-3 agents, minimal gates)
-/cook:fast "add dark mode toggle"
-
-# Complex feature (5-8 agents, all quality gates)
-/cook:hard "implement OAuth 2.0 authentication"
-
-# Code review
-/review "audit authentication module"
-
-# Create implementation plan
-/plan "build notification system"
-
-# Debug an issue
-/debug "payment fails on Safari"
-
-# Generate tests
-/test:hard "user registration flow"
+/cook:fast "add dark mode toggle"           # Simple feature
+/cook:hard "implement OAuth 2.0"            # Complex feature with all quality gates
+/fix "payment fails on Safari"              # Bug fix
+/plan "build notification system"           # Implementation plan
+/test:hard "user registration flow"         # Generate tests
+/review "audit auth module"                 # Code review
 ```
 
-### 3. Understand Variants
+### Variants
 
-| Variant | When to Use      | What It Does                                 |
-| ------- | ---------------- | -------------------------------------------- |
-| `:fast` | Simple tasks     | Quick execution, 2-3 agents                  |
-| `:hard` | Complex features | Full workflow, 5-8 agents, all quality gates |
+| Variant | Use For          | Agents                     |
+| ------- | ---------------- | -------------------------- |
+| `:fast` | Simple tasks     | 2-3 agents                 |
+| `:hard` | Complex features | 5-8 agents + quality gates |
 
 ---
 
-## Commands
-
-### Development Commands
-
-| Command | Description           | Variants         |
-| ------- | --------------------- | ---------------- |
-| `/cook` | Implement features    | `:fast`, `:hard` |
-| `/code` | Write code snippets   | `:fast`, `:hard` |
-| `/fix`  | Fix bugs and refactor | `:fast`, `:hard` |
-
-### Quality Commands
+## Commands Reference
 
-| Command   | Description          | Variants         |
-| --------- | -------------------- | ---------------- |
-| `/test`   | Generate tests       | `:fast`, `:hard` |
-| `/review` | Code review          | `:fast`, `:hard` |
-| `/debug`  | Systematic debugging | `:fast`, `:hard` |
-
-### Planning Commands
-
-| Command       | Description             | Variants         |
-| ------------- | ----------------------- | ---------------- |
-| `/plan`       | Implementation planning | `:fast`, `:hard` |
-| `/brainstorm` | Requirements discovery  | `:fast`, `:hard` |
-| `/design`     | UI/UX design            | `:fast`, `:hard` |
-
-### Documentation Commands
-
-| Command          | Description               | Files Created           |
-| ---------------- | ------------------------- | ----------------------- |
-| `/docs:core`     | Technical documentation   | 5 knowledge-\*.md files |
-| `/docs:business` | Business documentation    | 4 business-\*.md files  |
-| `/docs:audit`    | Security/compliance audit | 4 audit-\*.md files     |
-
-### Deployment Commands
-
-| Command              | Description                |
-| -------------------- | -------------------------- |
-| `/deploy:check`      | Pre-deployment validation  |
-| `/deploy:preview`    | Deploy to staging          |
-| `/deploy:production` | Deploy to production       |
-| `/deploy:rollback`   | Revert to previous version |
-
-### Utility Commands
-
-| Command | Description              |
-| ------- | ------------------------ |
-| `/ask`  | Q&A about codebase       |
-| `/auto` | Auto-detect best command |
+| Category    | Commands                                                 |
+| ----------- | -------------------------------------------------------- |
+| **Build**   | `/cook`, `/code`, `/fix`                                 |
+| **Quality** | `/test`, `/review`, `/debug`                             |
+| **Plan**    | `/plan`, `/brainstorm`, `/design`                        |
+| **Docs**    | `/docs:core`, `/docs:business`, `/docs:audit`            |
+| **Deploy**  | `/deploy:check`, `/deploy:preview`, `/deploy:production` |
 
 ---
 
-## Agents
-
-Agent Assistant includes 20 specialist agents organized by domain:
-
-### Implementation Agents
-
-| Agent               | Role                         |
-| ------------------- | ---------------------------- |
-| `backend-engineer`  | APIs, server logic, data     |
-| `frontend-engineer` | UI, React, a11y, performance |
-| `mobile-engineer`   | iOS/Android, React Native    |
-| `game-engineer`     | Game loop, 3D, performance   |
-
-### Architecture Agents
-
-| Agent                | Role                       |
-| -------------------- | -------------------------- |
-| `tech-lead`          | Orchestration, routing     |
-| `database-architect` | Schema, migrations, tuning |
-
-### Quality Agents
-
-| Agent               | Role                      |
-| ------------------- | ------------------------- |
-| `tester`            | Test strategy, automation |
-| `reviewer`          | Code review, compliance   |
-| `debugger`          | Root cause analysis       |
-| `security-engineer` | OWASP, threat modeling    |
-
-### Planning Agents
-
-| Agent              | Role                        |
-| ------------------ | --------------------------- |
-| `planner`          | Implementation plans, risks |
-| `brainstormer`     | Requirements, clarification |
-| `business-analyst` | User stories, stakeholders  |
+## 20 Specialist Agents
 
-### Support Agents
-
-| Agent                  | Role                       |
-| ---------------------- | -------------------------- |
-| `designer`             | UI/UX, design system       |
-| `devops-engineer`      | CI/CD, infrastructure      |
-| `docs-manager`         | README, API docs           |
-| `performance-engineer` | Profiling, optimization    |
-| `researcher`           | Docs, sources, comparisons |
-| `scouter`              | Codebase exploration       |
-| `project-manager`      | Sprints, risks, delivery   |
+| Domain             | Agents                                                                                              |
+| ------------------ | --------------------------------------------------------------------------------------------------- |
+| **Implementation** | backend-engineer, frontend-engineer, mobile-engineer, game-engineer                                 |
+| **Architecture**   | tech-lead, database-architect                                                                       |
+| **Quality**        | tester, reviewer, debugger, security-engineer                                                       |
+| **Planning**       | planner, brainstormer, business-analyst                                                             |
+| **Support**        | designer, devops-engineer, docs-manager, performance-engineer, researcher, scouter, project-manager |
 
 ---
 
 ## Matrix Skill Discovery
 
-Agent Assistant uses **Matrix Skill Discovery**—a centralized system that automatically injects relevant skills into agents based on their declared profile.
-
-### How It Works
-
-Instead of hardcoding skills in agents:
+Agents don't have hardcoded skills. They declare a **profile**, and the Matrix automatically injects relevant skills:
 
 ```yaml
-# OLD approach (no longer used)
-skills: [api-patterns, database-design, nodejs-best-practices]
-```
-
-Agents declare a **profile**:
-
-```yaml
-# Matrix Skill Discovery
+# Agent declares:
 profile: "backend:execution"
-```
-
-The system automatically resolves and injects skills:
-
-```
-Agent declares profile → Matrix resolves domains → Skills injected at runtime
-```
-
-### Benefits
-
-| Metric            | Hardcoded Skills | Matrix Discovery |
-| ----------------- | ---------------- | ---------------- |
-| Add new skill     | Update 10+ files | Update 1 file    |
-| Skill consistency | Manual           | Guaranteed       |
-| Agent file size   | ~200 lines       | ~150 lines       |
-| Single source     | ❌               | ✅               |
-
-### Matrix Structure
-
-```
-matrix-skills/
-├── _index.yaml          # Registry + agent profiles + resolution rules
-├── backend.yaml         # 20 backend skills
-├── frontend.yaml        # 18 frontend skills
-├── architecture.yaml    # 9 architecture skills
-├── quality.yaml         # 17 QA skills
-├── security.yaml        # 6 security skills
-├── design.yaml          # 10 design skills
-├── planning.yaml        # 9 planning skills
-├── devops.yaml          # 15 DevOps skills
-├── data.yaml            # 7 database skills
-├── performance.yaml     # 1 performance skill
-├── research.yaml        # 11 research skills
-├── mobile.yaml          # 8 mobile skills
-├── gaming.yaml          # 3 gaming skills
-├── management.yaml      # 4 management skills
-├── ai-ml.yaml           # 13 AI/ML skills
-├── cloud.yaml           # 11 cloud skills
-├── languages.yaml       # 17 language skills
-├── tools.yaml           # 31 utility skills
-└── mcp.yaml             # 8 MCP skills
-```
-
-### Skill Entry Schema
 
-```yaml
-- skill_id: api-patterns
-  category: core
-  priority_score: 9
-  relevance_mapping:
-    agents: [backend-engineer, tech-lead]
-    profiles: ["backend:*"]
-  description: "REST/GraphQL design, versioning, pagination"
+# Matrix resolves → 20+ backend skills injected automatically
 ```
 
-### Adding New Skills
-
-1. Create skill folder: `skills/{skill-id}/SKILL.md`
-2. Add entry to domain file: `matrix-skills/{domain}.yaml`
-3. Done! No agent files need modification.
+**310+ skills** across 19 domains. Add a new skill once, all relevant agents get it instantly.
 
 ---
 
@@ -386,236 +180,37 @@ matrix-skills/
 
 ```
 agent-assistant/
-├── agents/                      # 20 specialist agents
-│   └── {agent}.md               # Agent definition (profile-based)
-├── commands/                    # 40+ command workflows
-│   ├── cook/                    # Feature implementation
-│   │   ├── fast.md              # Quick execution
-│   │   └── hard.md              # Full workflow
-│   ├── fix/                     # Bug fixing
-│   ├── plan/                    # Planning
-│   ├── docs/                    # Documentation
-│   └── deploy/                  # Deployment
-├── rules/                       # 8 orchestration rules
-│   ├── BOOTSTRAP.md             # Entry point
-│   ├── ORCHESTRATION-LAWS.md    # 10 inviolable laws
-│   ├── EXECUTION-PROTOCOL.md    # Phase execution
-│   ├── ADAPTIVE-EXECUTION.md    # Tier 1/2 decisions
-│   ├── AGENT-RULES.md           # Agent guidelines
-│   ├── SKILL-DISCOVERY.md       # Matrix algorithm
-│   ├── ERROR-RECOVERY.md        # Error handling
-│   └── QUICK-REFERENCE.md       # Lookup tables
-├── matrix-skills/               # 19 domain files + registry
-│   ├── _index.yaml              # Central registry (218 skills)
-│   └── {domain}.yaml            # Domain-specific skills
-├── skills/                      # 218 domain skills
-│   └── {skill-id}/SKILL.md      # Skill definition
-├── documents/                   # Generated documentation
-│   ├── knowledge-*.md           # Core docs
-│   ├── business/                # Business docs
-│   └── audit/                   # Audit docs
-├── cli/                         # CLI installer
-│   └── install.js               # Main installer
-├── code-assistants/             # IDE-specific configs
-├── AGENT-TEMPLATE.md            # Agent template
-├── CLAUDE.md                    # Claude Code entry
-├── CURSOR.md                    # Cursor entry
-├── COPILOT.md                   # Copilot entry
-├── GEMINI.md                    # Antigravity entry
-└── package.json
-```
-
----
-
-## Architecture
-
-### Orchestrator Pattern
-
-The Orchestrator is the central brain that coordinates all work:
-
-```
-╔═══════════════════════════════════════════════════════════════════════════════╗
-║ ORCHESTRATOR — THE CENTRAL BRAIN                                              ║
-║                                                                               ║
-║ ✅ YOU DO: Delegate, coordinate, verify, synthesize                          ║
-║ ❌ YOU NEVER: Write code, debug, test, design, or implement directly         ║
-╚═══════════════════════════════════════════════════════════════════════════════╝
+├── agents/          # 20 specialist agents
+├── commands/        # 40+ workflow commands
+├── rules/           # 8 orchestration rules
+├── matrix-skills/   # 19 domain skill registries
+├── skills/          # 310+ domain skills
+└── cli/             # Installer
 ```
 
-### Tiered Execution
-
-| Tier   | Name      | When Used           | Context                 |
-| ------ | --------- | ------------------- | ----------------------- |
-| TIER 1 | Sub-agent | When tool available | ISOLATED (fresh memory) |
-| TIER 2 | Embody    | Fallback only       | SHARED (same memory)    |
-
-**Rule**: TIER 1 is MANDATORY when available. TIER 2 is FALLBACK only.
-
-### The 10 Orchestration Laws
-
-1. **Absolute Decentralization** — Orchestrator NEVER implements
-2. **Requirement Integrity** — 100% fidelity capture
-3. **Workflow Sovereignty** — Command file is source of truth
-4. **Deep Agent Embodiment** — Fully become the agent
-5. **Context Isolation** — Clean handoffs only
-6. **Language Matching** — Match user's language
-7. **Recursive Delegation** — Managers coordinate, never implement
-8. **Stateful Handoff** — Prior deliverables are immutable
-9. **Constraint Propagation** — Global state awareness
-10. **Tiered Execution** — Sub-agent first, embody fallback
-
 ---
 
-## Documentation
-
-Agent Assistant generates comprehensive documentation through the `/docs` command family. This documentation helps AI agents understand YOUR project's specific patterns and conventions.
-
-### Why Generate Documentation?
-
-| Without Docs                      | With Docs                      |
-| --------------------------------- | ------------------------------ |
-| Agents work with generic patterns | Agents follow YOUR conventions |
-| Inconsistent implementations      | Consistent with codebase       |
-| Rework due to misunderstanding    | First-time quality             |
-| Token waste on context            | Efficient, targeted responses  |
-
-### Core Documentation (`./documents/`)
-
-Generated by `/docs:core` — Technical documentation for AI agents.
-
-| File                        | Purpose                                 | Lines |
-| --------------------------- | --------------------------------------- | ----- |
-| `knowledge-overview.md`     | Project introduction, goals, tech stack | ~400  |
-| `knowledge-architecture.md` | System design, components, patterns     | ~500  |
-| `knowledge-domain.md`       | Data models, API contracts, entities    | ~550  |
-| `knowledge-source-base.md`  | Directory structure, file purposes      | ~450  |
-| `knowledge-standards.md`    | Code style, naming, commit format       | ~500  |
-
-### Business Documentation (`./documents/business/`)
-
-Generated by `/docs:business` — Business-oriented documentation.
-
-| File                    | Purpose                       | Lines |
-| ----------------------- | ----------------------------- | ----- |
-| `business-prd.md`       | Product requirements document | ~450  |
-| `business-features.md`  | Feature specifications        | ~600  |
-| `business-workflows.md` | User journeys and flows       | ~550  |
-| `business-glossary.md`  | Term definitions (80+ terms)  | ~500  |
-
-### Audit Documentation (`./documents/audit/`)
-
-Generated by `/docs:audit` — Security and compliance documentation.
-
-| File                       | Purpose                  |
-| -------------------------- | ------------------------ |
-| `audit-security.md`        | Security assessment      |
-| `audit-compliance.md`      | Compliance status        |
-| `audit-dataflow.md`        | Data flow analysis       |
-| `audit-recommendations.md` | Security recommendations |
-
-### Documentation Generation Commands
-
-```bash
-# Generate all core technical docs (recommended first step)
-/docs:core
-
-# Generate business documentation
-/docs:business
-
-# Generate security/compliance audit docs
-/docs:audit
-```
-
----
-
-## Uninstall
-
-```bash
-# Single tool
-agent-assistant uninstall cursor
-agent-assistant uninstall copilot
-agent-assistant uninstall antigravity
-
-# All tools
-agent-assistant uninstall --all
-```
-
-Your custom skills and configurations are preserved.
-
----
-
-## Configuration
-
-### Update Framework
-
-```bash
-git pull origin main
-agent-assistant install --all  # or specific tool
-```
-
-### Add Custom Skills
-
-Add skill folders to your tool's skills directory:
-
-- Cursor: `~/.cursor/skills/`
-- Copilot: `~/.copilot/skills/`
-- Antigravity: `~/.gemini/antigravity/skills/`
-
-Custom skills are picked up automatically.
-
-### Add Skills to Matrix
-
-1. Create skill folder: `skills/{skill-id}/SKILL.md`
-2. Add entry to domain file: `matrix-skills/{domain}.yaml`
+## Supported Tools
 
-```yaml
-- skill_id: my-new-skill
-  category: specialized
-  priority_score: 7
-  relevance_mapping:
-    agents: [backend-engineer]
-    profiles: ["backend:execution"]
-  description: "Brief description for AI recognition"
-```
+| Tool           | Status  | Install Path  |
+| -------------- | ------- | ------------- |
+| Cursor         | ✅ Full | `~/.cursor/`  |
+| Claude Code    | ✅ Full | `~/.claude/`  |
+| GitHub Copilot | ✅ Full | `~/.copilot/` |
+| Antigravity    | ✅ Full | `~/.gemini/`  |
 
 ---
 
 ## Contributing
 
-Contributions are welcome!
-
-### How to Contribute
-
-1. Fork the repo
-2. Create a branch: `git checkout -b feature/your-feature`
-3. Commit with [Conventional Commits](https://www.conventionalcommits.org/): `git commit -m 'feat: add X'`
-4. Push and open a Pull Request
-
-### Commit Types
-
-| Type       | Description      |
-| ---------- | ---------------- |
-| `feat`     | New feature      |
-| `fix`      | Bug fix          |
-| `docs`     | Documentation    |
-| `refactor` | Code refactoring |
-| `test`     | Tests            |
-| `chore`    | Maintenance      |
-
-### Areas to Contribute
-
-- **Agents**: New specialists for specialized domains
-- **Commands**: New workflow types
-- **Skills**: Domain knowledge for technologies
-- **Matrix**: Skill mappings and categories
-- **Documentation**: Improvements and translations
-- **Bug fixes**: Issue resolutions
+1. Fork → Branch → Commit (`feat:`, `fix:`, `docs:`) → PR
+2. Areas: Agents, Commands, Skills, Matrix, Docs, Bug fixes
 
 ---
 
 ## Support
 
-If you find this project helpful, consider buying me a coffee!
+If this helps you ship faster, consider buying me a coffee!
 
 <a href="https://buymeacoffee.com/hainamchuns" target="_blank">
   <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60" width="217">
@@ -623,20 +218,17 @@ If you find this project helpful, consider buying me a coffee!
 
 <br/>
 <img src="assets/buymeacoffee-qr.png" alt="Buy Me A Coffee QR Code" width="150" />
+<br/>
+<img src="assets/IMG_20260126_202557.png" alt="QR Code" width="150" />
 
 ---
 
-## License & Support
+## License
 
-- **License**: [MIT](LICENSE)
-- **Author**: NamCH
-- **Issues**: [GitHub Issues](https://github.com/hainamchung/agent-assistant/issues)
-- **Documentation**: [documents/](documents/)
-
----
+MIT — [NamCH](https://github.com/hainamchung) — [Issues](https://github.com/hainamchung/agent-assistant/issues)
 
 <div align="center">
 
-**Agent Assistant** — _Orchestrate. Delegate. Verify. Deliver._
+**Agent Assistant** — _Code less. Deliver more._
 
 </div>