ai-product

| 🎯 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 (HSOL) | Injects the right skills by profile and request; optional dynamic discovery (find-skills) for hard/focus when matrix fitness < 0.8. 310+ matrix skills, zero manual config. |

The Goal

> Code less, deliver more. Reduce token costs by 85%, cut bugs by 70%, and stop wasting time on repetitive tasks.

---

| Metric | Improvement |

| --------------------- | ----------------- |

| ⏰ Time-to-Production | 70% faster |

| 🐛 Bug Rate | 70% reduction |

| 💰 Token Cost | 85% savings |

---

Global Package (Recommended)

```bash

npm install -g @namch/agent-assistant

# After installing globally, run:

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

```

From Source

```bash

# Clone

git clone https://github.com/hainamchung/agent-assistant.git

cd agent-assistant

# 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

```

That's it. The framework installs globally and works across all your projects.

Remove configurations

```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

```

Remove global package

```bash

npm uninstall -g @namch/agent-assistant

```

From Source

```bash

cd agent-assistant

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

```

---

1. Generate Project Docs (Recommended)

```bash

/docs:core # Technical docs for AI context

/docs:business # Business requirements

```

Creates ./documents/ files that agents reference. Without docs, agents work generically. With docs, they follow YOUR patterns.

2. Start Building

```bash

/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

/report "status report for sprint" # Reporting (create/update reports)

```

Variants

| Variant | Use For | Agents |

| ------- | ---------------- | -------------------------- |

| :fast | Simple tasks | 2-3 agents |

| :hard | Complex features | 5-8 agents + quality gates |

| :focus | Clean execution | Clear context + auto-run phases (cook, code, fix, debug, design, plan, test, report) |

Clear context — stay on your request, avoid history hallucination

:hard and :focus are designed to reduce context rot (the model drifting or "hallucinating" from long chat history):

• Problem: Long conversations can make the model latch onto old context and drift from your current request.
• How we handle it:

- :hard: Structured workflow (phases + deliverables) so each step is grounded in your input + prior phase output, not arbitrary chat history.

- :focus: Clear context before running—execution starts "clean" for your request; phases run in order without pulling in old conversation.

Use :focus when you want execution to stick strictly to the current request (e.g. large refactors, tricky bugs, or after a long chat). More stable results, less "history hallucination".

---

| Category | Commands |

| ----------- | -------------------------------------------------------- |

| Build | /cook, /code, /fix |

| Quality | /test, /review, /debug |

| Plan | /plan, /brainstorm, /design |

| Docs | /docs:core, /docs:business, /docs:audit |

| Report | /report:fast, /report:hard, /report:focus |

| Deploy | /deploy:check, /deploy:preview, /deploy:production |

---

| 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, reporter |

---