@mikulgohil/ai-kit 1.0.1 → 1.2.1

package/guides/getting-started.md

@@ -4,11 +4,14 @@
 
 `ai-kit init` scanned your project and generated AI configuration files tailored to your tech stack. Here's what was created:
 
-| File | Purpose |
-|------|---------|
+| File / Directory | Purpose |
+|-----------------|---------|
 | `CLAUDE.md` | Rules for Claude Code — tells the AI about your project |
 | `.cursorrules` | Rules for Cursor — same purpose, Cursor format |
-| `.claude/commands/` | Slash commands — pre-built workflows for common tasks |
+| `.claude/skills/` | Skills — pre-built workflows for common tasks |
+| `.claude/agents/` | Agents — specialized AI assistants for delegation |
+| `.claude/contexts/` | Context modes — dev, review, and research modes |
+| `.claude/settings.local.json` | Hooks — automated checks that run as you code |
 | `ai-kit/guides/` | Guides — tips and playbooks for using AI effectively |
 | `docs/` | Doc templates — for tracking decisions and mistakes |
 | `ai-kit.config.json` | Config — what AI Kit detected and generated |
@@ -16,7 +19,7 @@
 ## First Thing to Do
 
 ### If you use Claude Code:
-Run the `/prompt-help` command. It's an interactive prompt builder that asks you all the right questions before generating a perfect prompt. No more "fix this" and getting garbage output.
+Run the `/prompt-help` command. It's an interactive prompt builder that asks you all the right questions before generating a perfect prompt.
 
 ```
 /prompt-help
@@ -25,18 +28,67 @@ Run the `/prompt-help` command. It's an interactive prompt builder that asks you
 ### If you use Cursor:
 Open any file and use Cmd+K or the chat panel. The `.cursorrules` file is automatically loaded and gives Cursor context about your project.
 
-## Available Slash Commands (Claude Code)
+## Available Skills (Claude Code)
 
-| Command | What it does |
-|---------|-------------|
+### Getting Started
+| Skill | What it does |
+|-------|-------------|
 | `/prompt-help` | Interactive prompt builder — **start here** |
-| `/review` | Deep code review as a Senior Engineer |
-| `/fix-bug` | Guided bug fix workflow |
+| `/understand` | Explain code in detail |
+| `/token-tips` | Token usage optimization |
+
+### Building
+| Skill | What it does |
+|-------|-------------|
 | `/new-component` | Scaffold a new component |
 | `/new-page` | Create a new page/route |
-| `/understand` | Explain code in detail |
+| `/api-route` | Scaffold an API route |
+| `/figma-to-code` | Implement Figma designs |
+
+### Quality & Review
+| Skill | What it does |
+|-------|-------------|
+| `/review` | Deep code review |
+| `/fix-bug` | Guided bug fix workflow |
 | `/test` | Generate tests |
-| `/optimize` | Performance optimization |
+| `/quality-gate` | Run ALL quality checks at once |
+| `/security-check` | Security vulnerability scan |
+| `/accessibility-audit` | WCAG 2.1 AA audit |
+
+### Session & Learning (NEW in v1.2.0)
+| Skill | What it does |
+|-------|-------------|
+| `/save-session` | Save current session for later resumption |
+| `/resume-session` | Pick up where you left off |
+| `/checkpoint` | Snapshot all quality check results |
+| `/orchestrate` | Coordinate multiple agents on complex tasks |
+| `/harness-audit` | Check AI configuration health |
+
+## Hooks (Automated Checks)
+
+Hooks run automatically as you code — no action needed. Based on your selected profile:
+
+- **Auto-format**: files are formatted on save (Prettier or Biome)
+- **Type-check**: TypeScript errors caught after every edit
+- **Console.log warning**: catches debug statements before commit
+- **Git push safety**: reminder to review before pushing
+
+See `ai-kit/guides/hooks-and-agents.md` for details on profiles and customization.
+
+## Agents
+
+Specialized AI assistants live in `.claude/agents/` and can be delegated to:
+
+| Agent | Specialization |
+|-------|---------------|
+| `planner` | Implementation planning |
+| `code-reviewer` | Quality review |
+| `security-reviewer` | Security audit |
+| `build-resolver` | Fix build errors |
+| `e2e-runner` | Playwright E2E tests |
+| `doc-updater` | Documentation sync |
+| `refactor-cleaner` | Dead code cleanup |
+| `sitecore-specialist` | Sitecore XM Cloud patterns |
 
 ## Tips
 
@@ -45,17 +97,18 @@ Open any file and use Cmd+K or the chat panel. The `.cursorrules` file is automa
 3. **Don't start from scratch** — ask the AI to read existing code first
 4. **One task per conversation** — keep conversations focused
 5. **Review AI output** — always read what it generates before accepting
+6. **Use `/checkpoint`** before and after major changes to track quality
+7. **Use `/save-session`** before ending a long session
 
-## Updating
-
-When you add new packages or change your project structure:
-```bash
-npx @mikulgohil/ai-kit update
-```
-
-## Removing
+## CLI Commands
 
-To remove all AI Kit generated files:
 ```bash
-npx @mikulgohil/ai-kit reset
+npx @mikulgohil/ai-kit update    # Re-scan and update configs
+npx @mikulgohil/ai-kit audit     # Security & config health check
+npx @mikulgohil/ai-kit doctor    # Diagnose setup issues
+npx @mikulgohil/ai-kit diff      # Preview what would change on update
+npx @mikulgohil/ai-kit stats     # Project complexity metrics
+npx @mikulgohil/ai-kit tokens    # Token usage and cost estimates
+npx @mikulgohil/ai-kit export    # Export to Windsurf, Aider, Cline
+npx @mikulgohil/ai-kit reset     # Remove all generated files
 ```

package/guides/hooks-and-agents.md

@@ -0,0 +1,124 @@
+# Hooks, Agents & Context Modes
+
+AI Kit v1.2.0 introduces automated hooks, specialized agents, and context modes to supercharge your AI-assisted development workflow.
+
+## Hooks
+
+Hooks are automated checks that run as you code — no manual invocation needed.
+
+### How They Work
+
+Hooks are configured in `.claude/settings.local.json` and fire on specific events:
+
+| Event | When It Fires |
+|-------|--------------|
+| **PreToolUse** | Before a tool runs (e.g., before `git push`) |
+| **PostToolUse** | After a file is edited or written |
+| **Stop** | After each AI response completes |
+
+### Hook Profiles
+
+AI Kit generates hooks based on your selected profile:
+
+| Profile | What Runs |
+|---------|-----------|
+| **Minimal** | Auto-format + git push safety warning |
+| **Standard** | Minimal + TypeScript type-check + console.log warnings |
+| **Strict** | Standard + ESLint check + stop-time console.log audit |
+
+### Changing Your Profile
+
+Re-run `ai-kit init` and select a different hook profile, or edit `.claude/settings.local.json` directly.
+
+### Disabling a Hook
+
+Remove or comment out the hook entry in `.claude/settings.local.json`. The file is gitignored by default, so your changes are local.
+
+---
+
+## Agents
+
+Agents are specialized AI assistants that can be delegated to for specific tasks. They live in `.claude/agents/`.
+
+### Available Agents
+
+| Agent | What It Does |
+|-------|-------------|
+| **planner** | Breaks down features into implementation plans |
+| **code-reviewer** | Deep code review for quality, patterns, and security |
+| **security-reviewer** | Focused security audit (XSS, CSRF, OWASP Top 10) |
+| **build-resolver** | Diagnoses and fixes build/type errors |
+| **e2e-runner** | Generates and runs Playwright E2E tests |
+| **doc-updater** | Syncs documentation with code changes |
+| **refactor-cleaner** | Finds and removes dead code |
+| **sitecore-specialist** | Sitecore XM Cloud patterns and debugging |
+
+### How to Use Agents
+
+In Claude Code, agents are automatically available for delegation. You can also invoke them directly:
+
+```
+@planner Plan the implementation for adding dark mode support
+@code-reviewer Review the changes in src/components/Header.tsx
+@e2e-runner Write E2E tests for the checkout flow
+```
+
+### Conditional Agents
+
+Some agents are only generated when their tools are detected:
+- **e2e-runner** — only if Playwright is installed
+- **sitecore-specialist** — only if Sitecore XM Cloud is detected
+
+---
+
+## Context Modes
+
+Context modes change how the AI approaches your work. They live in `.claude/contexts/`.
+
+### Available Modes
+
+| Mode | Best For |
+|------|----------|
+| **dev** | Building features — focus on implementation |
+| **review** | Reviewing code — focus on quality and security |
+| **research** | Exploring code — focus on understanding and documentation |
+
+### How to Use
+
+Reference the context in your prompt:
+
+```
+Using review context, check the authentication flow in src/lib/auth.ts
+```
+
+---
+
+## Session Management
+
+New skills help you persist context across sessions:
+
+| Skill | What It Does |
+|-------|-------------|
+| `/save-session` | Save current session state and decisions |
+| `/resume-session` | Restore context from a previous session |
+| `/checkpoint` | Run all quality checks and record results |
+
+### Quality & Orchestration
+
+| Skill | What It Does |
+|-------|-------------|
+| `/quality-gate` | Run all checks: types, lint, format, tests, a11y, security |
+| `/orchestrate` | Coordinate multiple agents for complex tasks |
+| `/harness-audit` | Check AI configuration health |
+
+---
+
+## Security Audit
+
+Run `ai-kit audit` to check your AI agent setup for:
+
+- Secrets accidentally committed in CLAUDE.md or settings
+- Missing hooks or misconfigured agents
+- .env files not gitignored
+- MCP server security
+- Overall configuration health score (A-F grade)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mikulgohil/ai-kit",
-  "version": "1.0.1",
-  "description": "AI-assisted development setup kit. Auto-detects your tech stack and generates tailored CLAUDE.md, .cursorrules, slash commands, and developer guides.",
+  "version": "1.2.1",
+  "description": "AI-assisted development setup kit. Auto-detects your tech stack and generates tailored CLAUDE.md, .cursorrules, hooks, agents, context modes, slash commands, and developer guides.",
   "type": "module",
   "bin": {
     "ai-kit": "./dist/index.js"
@@ -11,7 +11,9 @@
     "templates",
     "commands",
     "guides",
-    "docs-scaffolds"
+    "docs-scaffolds",
+    "agents",
+    "contexts"
   ],
   "scripts": {
     "build": "tsup",
@@ -26,11 +28,20 @@
     "ai",
     "claude-code",
     "cursor",
+    "windsurf",
+    "aider",
+    "cline",
     "developer-tools",
     "cli",
     "nextjs",
     "tailwind",
-    "sitecore"
+    "sitecore",
+    "docker",
+    "storybook",
+    "i18n",
+    "hooks",
+    "agents",
+    "security-audit"
   ],
   "author": "Mikul Gohil",
   "license": "MIT",

package/templates/claude-md/base.md

@@ -131,8 +131,10 @@ These standards are enforced across all projects to ensure consistency.
 - Document significant changes in `docs/` if the directory exists
 - When modifying a component, update its doc file's change log
 
-## Commands
-Available at: `.claude/commands/`
+## Skills & Commands
+Available as auto-discovered skills (`.claude/skills/`, `.cursor/skills/`) and legacy commands (`.claude/commands/`).
+
+AI will auto-discover and apply these when your task matches. You can also invoke them manually with `/skill-name`.
 
 **Getting Started**
 - `/prompt-help` — Interactive prompt builder (start here if unsure how to ask)