@mikulgohil/ai-kit 1.11.0 → 2.1.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,22 +102,37 @@ 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 />
 
@@ -228,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. |
@@ -238,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. |
@@ -331,8 +346,8 @@ Your custom sections are placed at the top of the file. AI Kit's generated 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 |

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

package/dist/index.js

@@ -15,7 +15,8 @@ var GUIDES_DIR = path.join(PACKAGE_ROOT, "guides");
 var DOCS_SCAFFOLDS_DIR = path.join(PACKAGE_ROOT, "docs-scaffolds");
 var AGENTS_DIR = path.join(PACKAGE_ROOT, "agents");
 var CONTEXTS_DIR = path.join(PACKAGE_ROOT, "contexts");
-var VERSION = "1.11.0";
+var VERSION = "2.1.0";
+var SKILL_PREFIX = "kit-";
 var AI_KIT_CONFIG_FILE = "ai-kit.config.json";
 var BACKUP_DIR = ".ai-kit/backups";
 var GENERATED_FILES = {
@@ -32,6 +33,7 @@ var GENERATED_FILES = {
 };
 var TEMPLATE_FRAGMENTS = [
   "base",
+  "behavioral",
   "nextjs-app-router",
   "nextjs-pages-router",
   "sitecore-xmc",
@@ -950,7 +952,7 @@ function replacePlaceholders(content, variables) {
 
 // src/generator/claude-md.ts
 function selectFragments(scan) {
-  const fragments = ["base"];
+  const fragments = ["base", "behavioral"];
   if (scan.framework === "nextjs") {
     if (scan.routerType === "app" || scan.routerType === "hybrid") {
       fragments.push("nextjs-app-router");
@@ -1469,7 +1471,7 @@ function generateSettingsLocal(scan, profile = "standard") {
 // src/copier/skills.ts
 import path16 from "path";
 import fs4 from "fs-extra";
-var AVAILABLE_SKILLS = [
+var BASE_SKILLS = [
   "prompt-help",
   "review",
   "fix-bug",
@@ -1521,7 +1523,8 @@ var AVAILABLE_SKILLS = [
   // New skills (v1.10.0) — documentation freshness
   "fetch-docs"
 ];
-var SKILL_DESCRIPTIONS = {
+var AVAILABLE_SKILLS = BASE_SKILLS.map((s) => `${SKILL_PREFIX}${s}`);
+var BASE_SKILL_DESCRIPTIONS = {
   "prompt-help": "Help developers write effective AI prompts with structured context",
   "review": "Deep code review following project coding standards",
   "fix-bug": "Systematic debugging workflow with root cause analysis and regression testing",
@@ -1548,7 +1551,6 @@ var SKILL_DESCRIPTIONS = {
   "responsive-check": "Audit responsive design \u2014 breakpoints, touch targets, overflow",
   "document": "Generate documentation for existing components and utilities",
   "token-tips": "Token usage optimization strategies for AI coding assistants",
-  // New skills (v1.1.0)
   "perf-audit": "Lighthouse-style performance audit covering Core Web Vitals, resource loading, and caching",
   "bundle-check": "Analyze bundle size, find heavy imports, suggest tree-shaking and code splitting",
   "i18n-check": "Find hardcoded strings, missing translation keys, and internationalization gaps",
@@ -1556,7 +1558,6 @@ var SKILL_DESCRIPTIONS = {
   "changelog": "Generate formatted changelogs from git history following Keep a Changelog format",
   "release": "Guided release workflow with versioning, changelog, tagging, and release notes",
   "storybook-gen": "Generate Storybook stories with controls, play functions, and visual tests",
-  // New skills (v1.2.0) — hooks, agents, sessions, orchestration
   "search-first": "Research-before-coding \u2014 search docs, existing patterns, and APIs before writing code",
   "quality-gate-check": "Post-implementation quality checklist \u2014 type safety, a11y, security, performance, Sitecore",
   "server-action": "Scaffold Next.js Server Actions with Zod validation, error handling, and revalidation",
@@ -1567,12 +1568,13 @@ var SKILL_DESCRIPTIONS = {
   "orchestrate": "Multi-agent orchestration \u2014 break complex tasks into subtasks and delegate to agents",
   "quality-gate": "Run comprehensive quality checks: types, lint, format, tests, bundle, a11y, security",
   "harness-audit": "Audit AI agent configuration \u2014 check CLAUDE.md, hooks, agents, skills, MCP servers",
-  // New skills (v1.7.0) — requirements clarification
   "deep-interview": "Socratic requirements gathering \u2014 structured interview to transform vague ideas into detailed specifications",
   "clarify-requirements": "Quick task clarification \u2014 identify gaps and ambiguities in under 5 minutes before coding",
-  // New skills (v1.10.0) — documentation freshness
   "fetch-docs": "Pre-load current, version-specific docs for your tech stack using Context7 MCP \u2014 run at session start to prevent outdated API usage"
 };
+var SKILL_DESCRIPTIONS = Object.fromEntries(
+  Object.entries(BASE_SKILL_DESCRIPTIONS).map(([k, v]) => [`${SKILL_PREFIX}${k}`, v])
+);
 async function copySkills(targetDir) {
   const copied = [];
   for (const skill of AVAILABLE_SKILLS) {
@@ -1653,7 +1655,7 @@ async function scaffoldDocs(targetDir) {
 // src/copier/agents.ts
 import path19 from "path";
 import fs7 from "fs-extra";
-var UNIVERSAL_AGENTS = [
+var BASE_UNIVERSAL_AGENTS = [
   "planner",
   "code-reviewer",
   "security-reviewer",
@@ -1668,17 +1670,18 @@ var UNIVERSAL_AGENTS = [
   "dependency-auditor",
   "api-designer"
 ];
+var UNIVERSAL_AGENTS = BASE_UNIVERSAL_AGENTS.map((a) => `${SKILL_PREFIX}${a}`);
 var CONDITIONAL_AGENTS = [
   {
-    name: "e2e-runner",
+    name: `${SKILL_PREFIX}e2e-runner`,
     condition: (scan) => scan.tools.playwright
   },
   {
-    name: "sitecore-specialist",
+    name: `${SKILL_PREFIX}sitecore-specialist`,
     condition: (scan) => scan.cms !== "none"
   },
   {
-    name: "tdd-guide",
+    name: `${SKILL_PREFIX}tdd-guide`,
     condition: (scan) => scan.tools.playwright || !!scan.scripts["test"]
   }
 ];
@@ -2104,6 +2107,7 @@ async function updateCommand(targetPath) {
   if (backupPath) {
     logSuccess(`Backed up current configs to ${path22.relative(projectDir, backupPath)}`);
   }
+  await cleanupUnprefixedFiles(projectDir);
   logSection("Updating Files");
   const strictness = existingConfig.strictness || "standard";
   const hookProfile = existingConfig.hookProfile || "standard";
@@ -2174,6 +2178,33 @@ async function updateCommand(targetPath) {
     logInfo("Rollback available: `ai-kit rollback --latest`");
   }
 }
+async function cleanupUnprefixedFiles(projectDir) {
+  let cleaned = 0;
+  for (const name of BASE_SKILLS) {
+    for (const root of [".claude/skills", ".cursor/skills"]) {
+      const oldDir = path22.join(projectDir, root, name);
+      if (await fs10.pathExists(oldDir)) {
+        await fs10.remove(oldDir);
+        cleaned++;
+      }
+    }
+    const oldCmd = path22.join(projectDir, ".claude", "commands", `${name}.md`);
+    if (await fs10.pathExists(oldCmd)) {
+      await fs10.remove(oldCmd);
+      cleaned++;
+    }
+  }
+  for (const name of BASE_UNIVERSAL_AGENTS) {
+    const oldAgent = path22.join(projectDir, ".claude", "agents", `${name}.md`);
+    if (await fs10.pathExists(oldAgent)) {
+      await fs10.remove(oldAgent);
+      cleaned++;
+    }
+  }
+  if (cleaned > 0) {
+    logInfo(`Cleaned up ${cleaned} old unprefixed skill/agent files (migrated to kit- prefix)`);
+  }
+}
 
 // src/commands/reset.ts
 import path23 from "path";
@@ -2546,7 +2577,7 @@ ${chalk2.bold("Model Recommendation")}`);
   printRoiEstimate(monthSessions, monthCost);
   console.log(
     `
-${chalk2.dim("Tip: Use /understand before modifying unfamiliar code \u2014")}`
+${chalk2.dim("Tip: Use /kit-understand before modifying unfamiliar code \u2014")}`
   );
   console.log(
     chalk2.dim("     it's cheaper than a failed implementation attempt.")
@@ -2609,9 +2640,9 @@ async function exportDashboard(allSessions, todaySessions, weekSessions, monthSe
   }
   spinner.succeed("Dashboard exported");
   try {
-    const { exec } = await import("child_process");
+    const { execFile } = await import("child_process");
     const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-    exec(`${openCmd} "${dashboardDest}"`);
+    execFile(openCmd, [dashboardDest]);
     logInfo("Opening dashboard in browser...");
   } catch {
     logInfo(`Open ${dashboardDest} in your browser to view the dashboard.`);