Changelog

All notable changes to AI Kit are documented here. This project follows Semantic Versioning .

v1.7.0 — 2026-03-26

New Agents (5)

Five new universal agents bring the total to 16 agents (was 11). Inspired by the oh-my-claudecode evaluation :

All five are universal agents — generated for every project regardless of stack.

New Skills (2)

Two requirements-gathering skills bring the total to 48 skills (was 46):

Other Improvements

• Total agents: 16 (was 11)
• Total skills: 48 (was 46)
• New skill category: Requirements
• Updated evaluation doc with completed P1 items

v1.5.0 — 2026-03-25

Remember My Choices (Profile Persistence)

ai-kit init now saves your configuration choices (tools, strictness, hook profile) into ai-kit.config.json. When you or a teammate runs ai-kit init again on the same project:

• Shows the saved profile (tools, strictness, hooks, version)
• Offers three options: Update (re-scan, keep settings), Re-configure (fresh start), or Cancel
• In “Update” mode, zero questions are asked — the saved choices are reused automatically

This means every developer on the project gets the same AI configuration without answering questions independently.

Design Token Scanner

New scanner that extracts design tokens from your Tailwind config or CSS variables and injects them into generated rules:

• Tailwind v4: Parses @theme { } blocks in globals.css for --color-*, --font-*, --spacing-*, --breakpoint-* tokens
• Tailwind v3: Parses tailwind.config.ts/js for colors, fontFamily, spacing, and screens keys
• CSS Variables: Detects custom properties in globals.css and categorizes them

Detected tokens are shown during ai-kit init and included as template variables so the AI knows your exact design system — no more inventing arbitrary colors.

Static Site / SSG Detection

New scanner and template fragment for static Next.js sites:

• Detects output: 'export' in next.config.*
• Detects generateStaticParams(), getStaticPaths(), revalidate patterns
• Detects server actions and API routes to determine output mode: export, isr, ssr, or hybrid
• Generates a static-site template fragment with SSG-specific rules (no server-only features, build-time data, performance targets)

.aiignore File Support

Create a .aiignore file in your project root (gitignore-like syntax) to tell AI agents and scanners to skip certain files:

# Legacy code — don't touch
legacy/
*.generated.ts
src/old-components/

Loaded during scanning and displayed in ai-kit init output.

Component Registry Command

New CLI command: ai-kit component-registry

Generates ai-kit/component-registry.json and ai-kit/component-registry.md — a catalog of all components with props, categories, dependencies, Sitecore metadata, and health scores. AI agents can reference this to discover existing components before creating new ones.

npx @mikulgohil/ai-kit component-registry

Health Dashboard Enhancements

The ai-kit health command now checks:

• Design Tokens — warns if Tailwind is detected but no custom tokens are found
• Static Site — shows the detected output mode
• .aiignore — confirms patterns are loaded

Other Improvements

• Tools selection saved — ai-kit.config.json now stores tools: { claude: true, cursor: true } so ai-kit update knows which tool configs to regenerate
• Update command shows saved profile info before regenerating
• Total template fragments: 9 (was 8, added static-site)
• Total CLI commands: 14 (was 13, added component-registry)

v1.4.0 — 2026-03-25

New Skills (7)

Seven new skills bring the total to 46 skills across all categories:

New Agent: ci-debugger

A new ci-debugger agent is generated in .claude/agents/ for every project. It specializes in diagnosing CI/CD pipeline failures:

• Reads CI logs (GitHub Actions, GitLab CI, CircleCI, and others)
• Identifies root causes: failing tests, type errors, lint failures, build errors, environment issues
• Suggests targeted fixes with file and line references
• Distinguishes flaky failures from genuine regressions

Invoke with: @ci-debugger Diagnose the failing GitHub Actions workflow

Total agents: 10 (was 9).

New Hooks (2)

Bundle Impact Warning (standard + strict profiles) — fires after edits to package.json, detects newly added dependencies via git diff, and prints a warning with the package names. Prompts you to run /bundle-check to evaluate impact before committing.

Pre-Commit AI Review (strict profile only) — fires before git commit, scans all staged .ts/.tsx/.js/.jsx files for any types, console.log statements, and TODO comments without ticket references. Reports findings file-by-file without blocking the commit.

See Hooks for full behavior details.

New CLI Commands (3)

Three new commands bring the total to 13 CLI commands (was 10):

See CLI Reference for full usage.

GitHub Action Template

A new template is available at templates/github-action-ai-review.yml — a ready-to-use GitHub Actions workflow that runs an AI-powered PR review on every pull request. Copy it to .github/workflows/ to enable automated PR feedback in CI.

Other Improvements

• Total skills: 46 (was 39)
• Total agents: 10 (was 9)
• Total CLI commands: 13 (was 10)

v1.3.0 — 2026-03-25

New CLI Command: ai-kit health

One-glance project health dashboard that combines setup integrity, security, stack detection, tools/MCP status, and documentation checks into a single view with an A-F grade.

npx @mikulgohil/ai-kit health

Five diagnostic sections: Setup Integrity, Security, Stack Detection, Tools & MCP, and Documentation. Produces a letter grade with actionable recommendations. Replaces running doctor + audit + stats separately.

See CLI Reference for details.

Component Scanner & Docs Generator

Two new modules that bring component-level intelligence to AI Kit:

• Component scanner (src/scanner/components.ts) — discovers all React components and extracts metadata: props, Sitecore integration (fields, params, placeholders, GraphQL), dependencies, test/story coverage, and auto-categorization
• Component docs generator (src/generator/component-docs.ts) — produces .ai.md files per component with YAML frontmatter, health scores (0-100), props tables, usage examples, and Sitecore integration details
• Smart merge — updates only auto-generated sections when .ai.md files already exist, preserving manual edits

See What Gets Generated for details.

Mistakes Auto-Capture Hook

New PostToolUse hook that automatically logs build and lint failures into docs/mistakes-log.md:

• Fires after every Bash command with a non-zero exit code
• Pattern-matches against TypeScript errors, ESLint failures, build errors, missing modules, and syntax/type errors
• Auto-appends timestamped entries with error preview pre-filled
• Available in standard and strict hook profiles
• The mistakes log builds itself — no manual effort required

See Hooks for details.

Other Improvements

• Total CLI commands expanded from 9 to 10
• Feature overview document added to docs/feature-overview.md

v1.2.0 — 2026-03-18

Hooks System (Automated Quality Checks)

Hooks run automatically as you code — no manual invocation needed.

• Auto-format on file edit — detects Prettier or Biome and generates the right hook
• TypeScript type-check after .ts/.tsx edits
• Console.log warning detection in edited files
• Git push safety reminder before pushing
• Three hook profiles: minimal, standard, strict
• Generated in .claude/settings.local.json (gitignored by default)

See Hooks for full details.

Specialized Agents (8 agents)

Agents live in .claude/agents/ and handle delegated tasks:

Conditional agents are only generated when their tools are detected. See Agents for details.

Context Modes (3 modes)

See Context Modes for details.

New Skills (6)

Session management and orchestration skills:

New CLI Command: ai-kit audit

Security and configuration health audit with A-F grading. Checks for secrets in CLAUDE.md, hook validity, agent config, MCP security, and more.

npx @mikulgohil/ai-kit audit

See CLI Reference for details.

Other Improvements

• Biome formatter detection — scanner now detects Biome alongside Prettier
• Conditional agent generation — e2e-runner only if Playwright, sitecore-specialist only if Sitecore
• Updated init/update commands — now generate hooks, agents, and contexts
• New guide: hooks-and-agents.md added to generated guides (6 total)
• Total skills expanded from 38 to 39

v1.1.0 — 2026-03-17

New CLI Commands

Four new commands for deeper project insights and cross-tool compatibility:

New Skills (7)

Expanded the skills library from 26 to 33:

Template System Improvements

• Strictness levels: Choose between strict, standard (default), or relaxed rule enforcement during ai-kit init
• Custom fragments: Add your own rule markdown files to .ai-kit/fragments/ — they’re automatically included in generated configs
• Expanded variable system: More placeholder tokens available for template customization

Token Tracking Enhancements

• Per-project breakdown: See cost per project ranked by usage
• Budget alerts: Warnings at 50%, 75%, and 90% of monthly budget
• Model recommendations: Suggests Sonnet vs Opus usage optimization when Opus cost is disproportionate
• CSV export: ai-kit tokens --csv exports daily usage data
• Custom budget: ai-kit tokens --budget 100 sets a custom monthly budget
• Week-over-week trends: Cost comparison with the previous week
• ROI estimate: Estimated time saved and developer cost offset based on session count

Configuration Changes

ai-kit.config.json now includes two new fields:

{
  "strictness": "standard",
  "customFragments": []
}

These are backward-compatible — existing configs without these fields default to "standard" strictness and no custom fragments.

v1.0.1 — 2026-03-10

Fixed

• Minor bug fixes and improvements

v1.0.0 — 2026-03-01

Initial Release

• Project scanner with 9 detection modules (Next.js, Sitecore, styling, TypeScript, monorepo, package manager, Figma, tools, MCP)
• Template generator with 8 fragments (base, nextjs-app-router, nextjs-pages-router, sitecore-xmc, tailwind, typescript, monorepo, figma)
• 26 auto-discovered skills for Claude Code and Cursor
• 5 developer guides
• 3 documentation scaffolds
• Token usage tracking with HTML dashboard export
• Marker-based safe merging for updates
• Support for Claude Code and Cursor AI editors