@mikulgohil/ai-kit 1.10.0 → 2.0.0

package/README.md

@@ -54,8 +54,8 @@ npx @mikulgohil/ai-kit health
 |---|---|
 | `CLAUDE.md` | Project-aware rules for Claude Code — your stack, conventions, and patterns |
 | `.cursorrules` + `.cursor/rules/*.mdc` | Same rules formatted for Cursor AI with scoped file matching |
-| **48 Skills** | Auto-discovered workflows — `/review`, `/new-component`, `/security-check`, `/pre-pr`, and more |
-| **16 Agents** | Specialized AI assistants — planner, reviewer, security, architect, build-resolver, and more |
+| **48 Skills** | Auto-discovered workflows — `/kit-review`, `/kit-new-component`, `/kit-security-check`, `/kit-pre-pr`, and more |
+| **16 Agents** | Specialized AI assistants — kit-planner, kit-code-reviewer, kit-security-reviewer, kit-architect, kit-build-resolver, and more |
 | **3 Context Modes** | Switch between dev (build fast), review (check quality), and research (understand code) |
 | **Automated Hooks** | Auto-format, TypeScript checks, console.log warnings, mistakes auto-capture, git safety |
 | **6 Guides** | Developer playbooks for prompts, tokens, hooks, agents, Figma workflow |
@@ -88,13 +88,13 @@ Structured AI workflows applied automatically — the AI recognizes what you're
 
 | Category | Skills |
 |---|---|
-| **Getting Started** | `prompt-help`, `understand` |
-| **Building** | `new-component`, `new-page`, `api-route`, `error-boundary`, `extract-hook`, `figma-to-code`, `design-tokens`, `schema-gen`, `storybook-gen`, `scaffold-spec` |
-| **Quality & Review** | `review`, `pre-pr`, `test`, `accessibility-audit`, `security-check`, `responsive-check`, `type-fix`, `perf-audit`, `bundle-check`, `i18n-check`, `test-gaps` |
-| **Maintenance** | `fix-bug`, `refactor`, `optimize`, `migrate`, `dep-check`, `sitecore-debug`, `upgrade` |
-| **Workflow** | `document`, `commit-msg`, `env-setup`, `changelog`, `release`, `pr-description`, `standup`, `learn-from-pr`, `release-notes` |
-| **Session** | `save-session`, `resume-session`, `checkpoint` |
-| **Orchestration** | `orchestrate`, `quality-gate`, `harness-audit` |
+| **Getting Started** | `kit-prompt-help`, `kit-understand` |
+| **Building** | `kit-new-component`, `kit-new-page`, `kit-api-route`, `kit-error-boundary`, `kit-extract-hook`, `kit-figma-to-code`, `kit-design-tokens`, `kit-schema-gen`, `kit-storybook-gen`, `kit-scaffold-spec` |
+| **Quality & Review** | `kit-review`, `kit-pre-pr`, `kit-test`, `kit-accessibility-audit`, `kit-security-check`, `kit-responsive-check`, `kit-type-fix`, `kit-perf-audit`, `kit-bundle-check`, `kit-i18n-check`, `kit-test-gaps` |
+| **Maintenance** | `kit-fix-bug`, `kit-refactor`, `kit-optimize`, `kit-migrate`, `kit-dep-check`, `kit-sitecore-debug`, `kit-upgrade` |
+| **Workflow** | `kit-document`, `kit-commit-msg`, `kit-env-setup`, `kit-changelog`, `kit-release`, `kit-pr-description`, `kit-standup`, `kit-learn-from-pr`, `kit-release-notes` |
+| **Session** | `kit-save-session`, `kit-resume-session`, `kit-checkpoint` |
+| **Orchestration** | `kit-orchestrate`, `kit-quality-gate`, `kit-harness-audit` |
 
 <br />
 
@@ -102,34 +102,53 @@ Structured AI workflows applied automatically — the AI recognizes what you're
 
 | Agent | Purpose |
 |---|---|
-| `@planner` | Break features into implementation plans with dependencies and risk assessment |
-| `@code-reviewer` | Deep quality review — patterns, performance, types, and conventions |
-| `@security-reviewer` | OWASP Top 10, XSS, CSRF, secrets detection, and auth flow analysis |
-| `@build-resolver` | Diagnose and fix build errors, type conflicts, and dependency issues |
-| `@doc-updater` | Keep documentation in sync with code changes automatically |
-| `@refactor-cleaner` | Find and remove dead code, unused imports, and unnecessary complexity |
-| `@tdd-guide` | Test-driven development workflow — red, green, refactor with guidance |
-| `@ci-debugger` | Analyze CI/CD failures, parse logs, and suggest targeted fixes |
-| `@e2e-runner` | Playwright tests with Page Object Model and smart selectors |
-| `@sitecore-specialist` | XM Cloud patterns, Content SDK v2, Experience Edge, and field helpers |
-| `@architect` | SSR/SSG/ISR strategy, component hierarchy, data flow, and rendering patterns |
-| `@data-scientist` | ML pipelines, model evaluation, data analysis, and experiment tracking |
-| `@performance-profiler` | Core Web Vitals, bundle analysis, runtime profiling, and rendering optimization |
-| `@migration-specialist` | Framework upgrades, breaking change detection, codemods, and incremental adoption |
-| `@dependency-auditor` | Vulnerability scanning, outdated packages, license compliance, and bundle impact |
-| `@api-designer` | REST/GraphQL API design, schema validation, versioning, and error handling |
+| `@kit-planner` | Break features into implementation plans with dependencies and risk assessment |
+| `@kit-code-reviewer` | Deep quality review — patterns, performance, types, and conventions |
+| `@kit-security-reviewer` | OWASP Top 10, XSS, CSRF, secrets detection, and auth flow analysis |
+| `@kit-build-resolver` | Diagnose and fix build errors, type conflicts, and dependency issues |
+| `@kit-doc-updater` | Keep documentation in sync with code changes automatically |
+| `@kit-refactor-cleaner` | Find and remove dead code, unused imports, and unnecessary complexity |
+| `@kit-tdd-guide` | Test-driven development workflow — red, green, refactor with guidance |
+| `@kit-ci-debugger` | Analyze CI/CD failures, parse logs, and suggest targeted fixes |
+| `@kit-e2e-runner` | Playwright tests with Page Object Model and smart selectors |
+| `@kit-sitecore-specialist` | XM Cloud patterns, Content SDK v2, Experience Edge, and field helpers |
+| `@kit-architect` | SSR/SSG/ISR strategy, component hierarchy, data flow, and rendering patterns |
+| `@kit-data-scientist` | ML pipelines, model evaluation, data analysis, and experiment tracking |
+| `@kit-performance-profiler` | Core Web Vitals, bundle analysis, runtime profiling, and rendering optimization |
+| `@kit-migration-specialist` | Framework upgrades, breaking change detection, codemods, and incremental adoption |
+| `@kit-dependency-auditor` | Vulnerability scanning, outdated packages, license compliance, and bundle impact |
+| `@kit-api-designer` | REST/GraphQL API design, schema validation, versioning, and error handling |
+
+<br />
+
+### Namespace Prefix: No Conflicts with Your Global Setup
+
+All AI Kit skills use a `kit-` prefix (`/kit-review`, `/kit-new-component`, `/kit-security-check`) and all agents use the same prefix (`@kit-planner`, `@kit-code-reviewer`).
+
+**Why?** Claude Code, Cursor, and other tools let you define global skills and agents. Without namespacing, AI Kit's project-level `/review` would silently override your personal global `/review` — or worse, both would appear in the suggestion list, confusing developers about which to use.
+
+The `kit-` prefix guarantees:
+- AI Kit skills and your personal/global skills coexist without collision
+- No silent overrides — you always know which skill is running
+- Clean autocomplete — `kit-` groups all AI Kit skills together
+
+> **Upgrading from v1.x?** Run `ai-kit update` — it automatically cleans up old unprefixed files.
 
 <br />
 
 ### Automated Quality Hooks
 
-| Profile | What Runs Automatically |
+| Hook | What It Does |
 |---|---|
-| **Minimal** | Auto-format + git push safety |
-| **Standard** | + TypeScript type-check + console.log warnings + mistakes auto-capture + bundle impact warning |
-| **Strict** | + ESLint check + stop-time console.log audit + pre-commit AI review + bundle impact warning |
+| **Session Init** | Echoes project stack, package manager, available scripts, and last scan date at every session start — the AI has full context from the first prompt |
+| **Auto-format** | Formats files on edit via Prettier or Biome |
+| **TypeScript check** | Catches type errors after every edit (standard + strict) |
+| **Console.log warning** | Catches debug statements before commit (standard + strict) |
+| **Mistakes auto-capture** | Logs build/lint failures to `docs/mistakes-log.md` automatically (standard + strict) |
+| **Pre-commit review** | Checks for `any` types, console.logs, and TODOs without tickets in staged files (strict) |
+| **Context re-echo** | After context compaction in long sessions, re-echoes tech stack (standard + strict) |
 
-**Mistakes auto-capture** — When a build/lint command fails, the hook logs the error to `docs/mistakes-log.md` with timestamp and error preview. The mistakes log builds itself over time.
+Three strictness profiles: **Minimal** (format + git safety), **Standard** (+ typecheck + warnings + mistakes), **Strict** (+ ESLint + pre-commit review).
 
 <br />
 
@@ -180,7 +199,9 @@ Period summaries, budget progress with alerts, per-project cost breakdown, week-
 | Command | Description |
 |---|---|
 | `ai-kit init [path]` | Scan project and generate all configs |
-| `ai-kit update [path]` | Re-scan and update generated files (safe merge) |
+| `ai-kit update [path]` | Re-scan and update generated files (safe merge, auto-backup) |
+| `ai-kit migrate [path]` | Adopt ai-kit in a project with existing CLAUDE.md — preserves custom rules |
+| `ai-kit rollback [path]` | Restore configs from a previous backup created by `update` |
 | `ai-kit reset [path]` | Remove all AI Kit generated files |
 | `ai-kit health [path]` | One-glance A-F project health dashboard |
 | `ai-kit audit [path]` | Security and configuration health audit |
@@ -222,7 +243,7 @@ Every team using AI coding assistants hits these problems. AI Kit solves each on
 |---|---------|---------------------|
 | 1 | **AI forgets everything each session** — Every new chat starts from zero. | Generates a persistent `CLAUDE.md` with project rules, conventions, and stack details. The AI knows your project from the first prompt, every time. |
 | 2 | **AI generates wrong framework patterns** — Writes Pages Router code when you use App Router. | Auto-detects your exact stack and generates rules specific to your setup. The AI can't use the wrong patterns. |
-| 3 | **Developers write bad prompts** — Vague prompts lead to wrong code and rework. | Ships **48 pre-built skills** — just run `/review`, `/security-check`, `/new-component`, etc. |
+| 3 | **Developers write bad prompts** — Vague prompts lead to wrong code and rework. | Ships **48 pre-built skills** — just run `/kit-review`, `/kit-security-check`, `/kit-new-component`, etc. |
 | 4 | **Same mistakes happen repeatedly** — No system to track what went wrong. | Generates a **mistakes log** with **auto-capture hook** that logs every build/lint failure automatically. |
 | 5 | **Every developer gets different AI behavior** — No consistency across the team. | One `ai-kit init` generates the same rules for everyone. Commit the files to the repo. |
 | 6 | **No quality checks on AI-generated code** — AI output goes straight to PR. | Automated **hooks** run formatting, type-checking, linting, and git safety checks in real-time. |
@@ -232,9 +253,9 @@ Every team using AI coding assistants hits these problems. AI Kit solves each on
 | 10 | **Onboarding takes too long** — New developers spend days understanding the project. | New team members get productive AI assistance from day one with zero manual setup. |
 | 11 | **Context gets repeated every conversation** — Same conventions explained every session. | All conventions encoded in generated rules. The AI reads them automatically at session start. |
 | 12 | **AI doesn't improve over time** — Same wrong suggestions regardless of past feedback. | Mistakes log, decisions log, and updated rules mean the AI gets smarter every session. |
-| 13 | **Complex tasks need multiple manual AI passes** — Manual coordination across conversations. | **Multi-agent orchestration** runs specialists in parallel with `/orchestrate`. |
+| 13 | **Complex tasks need multiple manual AI passes** — Manual coordination across conversations. | **Multi-agent orchestration** runs specialists in parallel with `/kit-orchestrate`. |
 | 14 | **Switching AI tools means starting over** — Moving tools loses all configuration. | Generates configs for **5+ tools** from a single source — switch without losing context. |
-| 15 | **AI creates components without tests, docs, or types** — Every file needs follow-up. | Skills like `/new-component` enforce structured workflows: component + types + tests + docs together. |
+| 15 | **AI creates components without tests, docs, or types** — Every file needs follow-up. | Skills like `/kit-new-component` enforce structured workflows: component + types + tests + docs together. |
 | 16 | **No visibility into AI usage costs** — No idea how many tokens the team consumes. | Built-in **token tracking** with daily/weekly/monthly summaries and cost breakdown. |
 | 17 | **Cursor copies entire modules instead of targeted edits** — AI bloats the repo. | Generated rules include explicit instructions for editing patterns — update in place. |
 | 18 | **No component-level AI awareness** — AI doesn't know which components have gaps. | **Component scanner** discovers all components and generates `.ai.md` docs with health scores. |
@@ -299,7 +320,25 @@ When your project evolves:
 npx @mikulgohil/ai-kit update
 ```
 
-Only content between `AI-KIT:START/END` markers is refreshed. Your custom rules and manual edits are preserved.
+Every update **automatically backs up** your current configs to `.ai-kit/backups/` before writing. Only content between `AI-KIT:START/END` markers is refreshed — your custom rules and manual edits are preserved.
+
+If something goes wrong, roll back instantly:
+
+```bash
+npx @mikulgohil/ai-kit rollback          # Pick from available backups
+npx @mikulgohil/ai-kit rollback --latest  # Restore most recent backup
+```
+
+### Migrating an Existing Project
+
+Already have a hand-written `CLAUDE.md`? Migrate without losing your custom rules:
+
+```bash
+npx @mikulgohil/ai-kit migrate              # Interactive — shows preview, asks confirmation
+npx @mikulgohil/ai-kit migrate --dry-run    # Preview changes without writing
+```
+
+Your custom sections are placed at the top of the file. AI Kit's generated rules go inside `AI-KIT:START/END` markers below. Future `ai-kit update` only touches the marked section — your rules are preserved forever.
 
 ---
 
@@ -307,8 +346,8 @@ Only content between `AI-KIT:START/END` markers is refreshed. Your custom rules
 
 | Feature | Description | Status |
 |---|---|---|
-| **Project Constitution** | `/constitution` — governance doc with coding standards, testing philosophy, performance budgets | Planned |
-| **Spec-First Workflow** | `/specify` — structured feature specs with user stories and acceptance criteria before code | Planned |
+| **Project Constitution** | `/kit-constitution` — governance doc with coding standards, testing philosophy, performance budgets | Planned |
+| **Spec-First Workflow** | `/kit-specify` — structured feature specs with user stories and acceptance criteria before code | Planned |
 | **Extension Catalog** | Community-contributed agents, skills, and templates. Install with `ai-kit extension install` | Planned |
 | **Preset Bundles** | Curated bundles: `enterprise`, `startup`, `sitecore-xmc`, `fullstack`. Apply with `ai-kit preset apply` | Planned |
 | **Setup Comparison** | `ai-kit compare` — gap analysis comparing your setup against other spec-driven tools | Planned |
@@ -317,7 +356,7 @@ Only content between `AI-KIT:START/END` markers is refreshed. Your custom rules
 
 ## Requirements
 
-- Node.js 18+
+- Node.js 20+
 - A project with `package.json`
 - Claude Code or Cursor (at least one AI tool)
 
@@ -330,7 +369,7 @@ Full documentation at **[ai-kit.mikul.me](https://ai-kit.mikul.me)**
 | Page | What You'll Learn |
 |---|---|
 | [Getting Started](https://ai-kit.mikul.me/getting-started) | Step-by-step setup walkthrough |
-| [CLI Reference](https://ai-kit.mikul.me/cli-reference) | All 14 commands with examples |
+| [CLI Reference](https://ai-kit.mikul.me/cli-reference) | All 16 commands with examples |
 | [Skills & Commands](https://ai-kit.mikul.me/slash-commands) | All 48 skills with usage guides |
 | [What Gets Generated](https://ai-kit.mikul.me/what-gets-generated) | Detailed breakdown of every generated file |
 | [Hooks](https://ai-kit.mikul.me/hooks) | Hook profiles, mistakes auto-capture |

package/agents/{api-designer.md → kit-api-designer.md}

@@ -1,5 +1,5 @@
 ---
-name: api-designer
+name: kit-api-designer
 description: API designer agent — REST and GraphQL API design, schema validation, versioning strategy, error handling patterns, and API documentation.
 tools: Read, Glob, Grep, Bash
 ---

package/agents/{architect.md → kit-architect.md}

@@ -1,5 +1,5 @@
 ---
-name: architect
+name: kit-architect
 description: System architect — SSR/SSG/ISR strategy, component hierarchy, data flow, rendering patterns for Next.js + Sitecore XM Cloud + Tailwind projects.
 tools: Read, Glob, Grep, Bash
 ---

package/agents/{build-resolver.md → kit-build-resolver.md}

@@ -1,5 +1,5 @@
 ---
-name: build-resolver
+name: kit-build-resolver
 description: Build error resolution agent — diagnoses and fixes Next.js, TypeScript, and Sitecore build errors.
 tools: Read, Edit, Glob, Grep, Bash
 isolation: worktree

package/agents/{ci-debugger.md → kit-ci-debugger.md}

@@ -1,5 +1,5 @@
 ---
-name: ci-debugger
+name: kit-ci-debugger
 description: CI/CD failure debugger — analyzes pipeline logs, identifies root causes, and suggests fixes for GitHub Actions, Vercel, and Netlify failures.
 tools: Read, Edit, Glob, Grep, Bash
 ---

package/agents/{code-reviewer.md → kit-code-reviewer.md}

@@ -1,5 +1,5 @@
 ---
-name: code-reviewer
+name: kit-code-reviewer
 description: Deep code review agent — checks quality, patterns, security, accessibility, and performance for React/Next.js/Sitecore code.
 tools: Read, Glob, Grep
 ---

package/agents/{data-scientist.md → kit-data-scientist.md}

@@ -1,5 +1,5 @@
 ---
-name: data-scientist
+name: kit-data-scientist
 description: Data science and ML agent — data analysis, model evaluation, pipeline design, feature engineering, and experiment tracking patterns.
 tools: Read, Glob, Grep, Bash
 ---

package/agents/{dependency-auditor.md → kit-dependency-auditor.md}

@@ -1,5 +1,5 @@
 ---
-name: dependency-auditor
+name: kit-dependency-auditor
 description: Dependency auditor agent — outdated packages, vulnerability scanning, license compliance, bundle impact analysis, and dependency hygiene.
 tools: Read, Glob, Grep, Bash
 ---

package/agents/{doc-updater.md → kit-doc-updater.md}

@@ -1,5 +1,5 @@
 ---
-name: doc-updater
+name: kit-doc-updater
 description: Documentation sync agent — updates component docs, README, and Storybook stories when code changes.
 tools: Read, Write, Edit, Glob, Grep
 ---

package/agents/{e2e-runner.md → kit-e2e-runner.md}

@@ -1,5 +1,5 @@
 ---
-name: e2e-runner
+name: kit-e2e-runner
 description: Playwright E2E test agent — generates and runs Playwright tests using Page Object Model for Next.js applications.
 tools: Read, Write, Edit, Glob, Grep, Bash
 isolation: worktree

package/agents/{migration-specialist.md → kit-migration-specialist.md}

@@ -1,5 +1,5 @@
 ---
-name: migration-specialist
+name: kit-migration-specialist
 description: Migration specialist agent — framework upgrades, breaking change detection, codemods, dependency migration, and incremental adoption strategies.
 tools: Read, Edit, Glob, Grep, Bash
 isolation: worktree

package/agents/{performance-profiler.md → kit-performance-profiler.md}

@@ -1,5 +1,5 @@
 ---
-name: performance-profiler
+name: kit-performance-profiler
 description: Performance profiling agent — Core Web Vitals, bundle analysis, runtime profiling, rendering optimization, and Lighthouse audits for web applications.
 tools: Read, Glob, Grep, Bash
 ---

package/agents/{planner.md → kit-planner.md}

@@ -1,5 +1,5 @@
 ---
-name: planner
+name: kit-planner
 description: Implementation planning agent — breaks features into tasks, identifies files, and considers architectural tradeoffs for Next.js/React/Sitecore projects.
 tools: Read, Glob, Grep, Bash
 ---

package/agents/{refactor-cleaner.md → kit-refactor-cleaner.md}

@@ -1,5 +1,5 @@
 ---
-name: refactor-cleaner
+name: kit-refactor-cleaner
 description: Dead code cleanup and refactoring agent — finds unused exports, cleans imports, and removes dead code.
 tools: Read, Edit, Glob, Grep, Bash
 isolation: worktree

package/agents/{security-reviewer.md → kit-security-reviewer.md}

@@ -1,5 +1,5 @@
 ---
-name: security-reviewer
+name: kit-security-reviewer
 description: Security-focused review agent — checks XSS, CSRF, injection, secrets, and OWASP Top 10 for Next.js applications.
 tools: Read, Glob, Grep, Bash
 ---

package/agents/{sitecore-specialist.md → kit-sitecore-specialist.md}

@@ -1,5 +1,5 @@
 ---
-name: sitecore-specialist
+name: kit-sitecore-specialist
 description: Sitecore XM Cloud specialist — handles component mapping, GraphQL queries, layout service, Experience Edge, personalization, and Content SDK v2.x.
 tools: Read, Write, Edit, Glob, Grep, Bash
 ---

package/agents/{tdd-guide.md → kit-tdd-guide.md}

@@ -1,5 +1,5 @@
 ---
-name: tdd-guide
+name: kit-tdd-guide
 description: Test-driven development guide — red-green-refactor workflow for Next.js pages, Sitecore components, and React hooks.
 tools: Read, Write, Edit, Glob, Grep, Bash
 ---

package/commands/{clarify-requirements.md → kit-clarify-requirements.md}

@@ -78,7 +78,7 @@ Before presenting the brief, verify:
 ## Constraints
 
 - Do NOT ask more than 5 questions — prioritize ruthlessly
-- Do NOT turn this into a long interview — that's what `/deep-interview` is for
+- Do NOT turn this into a long interview — that's what `/kit-deep-interview` is for
 - Do NOT ask obvious questions that the task description already answers
 - Do NOT write code — this command is for clarification only
 - Keep the total interaction under 5 minutes

package/commands/{harness-audit.md → kit-harness-audit.md}

@@ -22,7 +22,7 @@ Audit the AI agent configuration for completeness and correctness.
 - [ ] Each agent has valid YAML frontmatter (name, description)
 - [ ] Agent descriptions are specific enough for delegation
 - [ ] No duplicate or conflicting agents
-- [ ] Conditional agents match detected stack (e2e-runner only if Playwright installed)
+- [ ] Conditional agents match detected stack (kit-e2e-runner only if Playwright installed)
 
 ### 4. Contexts (`.claude/contexts/*.md`)
 - [ ] dev, review, research modes are present

package/commands/{orchestrate.md → kit-orchestrate.md}

@@ -18,14 +18,14 @@ Coordinate multiple specialized agents to tackle complex tasks.
 
 | Agent | Best For |
 |-------|----------|
-| `planner` | Breaking down requirements into implementation steps |
-| `code-reviewer` | Quality review of existing or new code |
-| `security-reviewer` | Security-focused audit |
-| `e2e-runner` | Generating and running Playwright tests |
-| `build-resolver` | Fixing build and type errors |
-| `doc-updater` | Updating documentation |
-| `refactor-cleaner` | Finding and removing dead code |
-| `sitecore-specialist` | Sitecore-specific patterns and issues |
+| `kit-planner` | Breaking down requirements into implementation steps |
+| `kit-code-reviewer` | Quality review of existing or new code |
+| `kit-security-reviewer` | Security-focused audit |
+| `kit-e2e-runner` | Generating and running Playwright tests |
+| `kit-build-resolver` | Fixing build and type errors |
+| `kit-doc-updater` | Updating documentation |
+| `kit-refactor-cleaner` | Finding and removing dead code |
+| `kit-sitecore-specialist` | Sitecore-specific patterns and issues |
 
 ### 3. Delegate
 Launch agents in parallel where possible:
@@ -48,9 +48,9 @@ Present a merged summary:
 ### Task: [description]
 
 ### Agent Results
-- **planner**: [key findings]
-- **code-reviewer**: [key findings]
-- **security-reviewer**: [key findings]
+- **kit-planner**: [key findings]
+- **kit-code-reviewer**: [key findings]
+- **kit-security-reviewer**: [key findings]
 
 ### Conflicts
 - [Agent A recommends X, but Agent B recommends Y — resolution]

package/commands/{resume-session.md → kit-resume-session.md}

@@ -31,7 +31,7 @@ Before resuming work, check:
 
 ## If No Sessions Found
 - Check `ai-kit/sessions/` directory exists
-- Suggest running `/save-session` at the end of future sessions
+- Suggest running `/kit-save-session` at the end of future sessions
 - Offer to start fresh by creating a new session
 
 ## Tips

package/commands/{token-tips.md → kit-token-tips.md}

@@ -13,7 +13,7 @@
 ### High Impact
 
 - **Be specific about files** — "fix auth in src/lib/auth.ts:45" not "fix the auth"
-- **Use /understand BEFORE modifying unfamiliar code** — cheaper than a failed attempt
+- **Use /kit-understand BEFORE modifying unfamiliar code** — cheaper than a failed attempt
 - **Use slash commands** — they provide structured context efficiently
 - **Break large tasks into focused prompts** — 5 small prompts < 1 vague prompt that needs 3 follow-ups
 
@@ -22,7 +22,7 @@
 - **Don't ask AI to read the entire codebase** — point to specific files
 - **Use git diff to show AI only what changed**
 - **Close and reopen sessions when switching tasks** (prevents context bloat)
-- **Use /prompt-help to structure your request** before asking
+- **Use /kit-prompt-help to structure your request** before asking
 
 ### Low Impact (but adds up)
 
@@ -40,9 +40,9 @@ Daily budget: ~$0.91
 | --------------------- | ----------------- | ------------- | ---------- |
 | Read a file           | ~500 tokens       | 20            | ~$0.03     |
 | Generate a component  | ~3,000 tokens     | 3             | ~$0.14     |
-| Code review (/review) | ~5,000 tokens     | 2             | ~$0.15     |
+| Code review (/kit-review) | ~5,000 tokens     | 2             | ~$0.15     |
 | Bug fix conversation  | ~8,000 tokens     | 2             | ~$0.24     |
-| /pre-pr checklist     | ~6,000 tokens     | 1             | ~$0.09     |
+| /kit-pre-pr checklist     | ~6,000 tokens     | 1             | ~$0.09     |
 | **Total estimated**   |                   |               | ~$0.65/day |
 
 Buffer for complex tasks: ~$0.26/day