@mikulgohil/ai-kit 1.5.1 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +45 -9
  2. package/dist/index.js +1 -1
  3. package/dist/index.js.map +1 -1
  4. package/package.json +9 -3
package/README.md CHANGED
@@ -7,7 +7,7 @@ One command. Project-aware AI from the first conversation.
7
7
  [![npm downloads](https://img.shields.io/npm/dm/@mikulgohil/ai-kit.svg)](https://www.npmjs.com/package/@mikulgohil/ai-kit)
8
8
  [![license](https://img.shields.io/npm/l/@mikulgohil/ai-kit.svg)](https://github.com/mikulgohil/ai-kit/blob/main/LICENSE)
9
9
 
10
- > **[Read the full documentation](https://mikulgohil.github.io/ai-kit-docs)** | [Getting Started](https://mikulgohil.github.io/ai-kit-docs/getting-started) | [CLI Reference](https://mikulgohil.github.io/ai-kit-docs/cli-reference) | [Skills & Commands](https://mikulgohil.github.io/ai-kit-docs/slash-commands) | [Hooks](https://mikulgohil.github.io/ai-kit-docs/hooks) | [Agents](https://mikulgohil.github.io/ai-kit-docs/agents) | [Changelog](https://mikulgohil.github.io/ai-kit-docs/changelog)
10
+ > **[Read the full documentation](https://ai-kit-docs-beta.vercel.app/docs)** | [Getting Started](https://ai-kit-docs-beta.vercel.app/docs/getting-started) | [CLI Reference](https://ai-kit-docs-beta.vercel.app/docs/cli-reference) | [Skills & Commands](https://ai-kit-docs-beta.vercel.app/docs/slash-commands) | [Hooks](https://ai-kit-docs-beta.vercel.app/docs/hooks) | [Agents](https://ai-kit-docs-beta.vercel.app/docs/agents) | [Changelog](https://ai-kit-docs-beta.vercel.app/docs/changelog)
11
11
 
12
12
  ```bash
13
13
  npx @mikulgohil/ai-kit init
@@ -242,17 +242,53 @@ Only content between `AI-KIT:START/END` markers is refreshed. Your custom rules
242
242
 
243
243
  ## Documentation
244
244
 
245
- **[mikulgohil.github.io/ai-kit-docs](https://mikulgohil.github.io/ai-kit-docs)**
245
+ **[ai-kit-docs-beta.vercel.app/docs](https://ai-kit-docs-beta.vercel.app/docs)**
246
246
 
247
247
  | Page | What You'll Learn |
248
248
  |---|---|
249
- | [Getting Started](https://mikulgohil.github.io/ai-kit-docs/getting-started) | Step-by-step setup walkthrough |
250
- | [CLI Reference](https://mikulgohil.github.io/ai-kit-docs/cli-reference) | All 13 commands with examples |
251
- | [Skills & Commands](https://mikulgohil.github.io/ai-kit-docs/slash-commands) | All 46 skills with usage guides |
252
- | [What Gets Generated](https://mikulgohil.github.io/ai-kit-docs/what-gets-generated) | Detailed breakdown of every generated file |
253
- | [Hooks](https://mikulgohil.github.io/ai-kit-docs/hooks) | Hook profiles, mistakes auto-capture |
254
- | [Agents](https://mikulgohil.github.io/ai-kit-docs/agents) | 10 specialized agents |
255
- | [Changelog](https://mikulgohil.github.io/ai-kit-docs/changelog) | Version history and release notes |
249
+ | [Getting Started](https://ai-kit-docs-beta.vercel.app/docs/getting-started) | Step-by-step setup walkthrough |
250
+ | [CLI Reference](https://ai-kit-docs-beta.vercel.app/docs/cli-reference) | All 13 commands with examples |
251
+ | [Skills & Commands](https://ai-kit-docs-beta.vercel.app/docs/slash-commands) | All 46 skills with usage guides |
252
+ | [What Gets Generated](https://ai-kit-docs-beta.vercel.app/docs/what-gets-generated) | Detailed breakdown of every generated file |
253
+ | [Hooks](https://ai-kit-docs-beta.vercel.app/docs/hooks) | Hook profiles, mistakes auto-capture |
254
+ | [Agents](https://ai-kit-docs-beta.vercel.app/docs/agents) | 10 specialized agents |
255
+ | [Changelog](https://ai-kit-docs-beta.vercel.app/docs/changelog) | Version history and release notes |
256
+
257
+ ---
258
+
259
+ ## Roadmap
260
+
261
+ Features planned for upcoming releases, inspired by best practices from the spec-driven development ecosystem.
262
+
263
+ | Feature | Description | Status |
264
+ |---|---|---|
265
+ | **Project Constitution** | `/constitution` skill — generate a `PROJECT_PRINCIPLES.md` governance doc that defines coding standards, testing philosophy, performance budgets, and accessibility targets. AI agents reference it before every decision. | Planned |
266
+ | **Spec-First Workflow** | `/specify` skill — create structured feature specs (`specs/<feature>.md`) with user stories, acceptance criteria, and edge cases *before* writing code. Planner agent references specs during implementation. | Planned |
267
+ | **Extension Catalog** | Community-contributed agents, skills, and template fragments. Install with `ai-kit extension install <name>`. Standard manifest format for third-party contributions. | Planned |
268
+ | **Preset Bundles** | Curated workflow bundles for common project types: `enterprise` (strict compliance), `startup` (fast iteration), `sitecore-xmc` (XM Cloud best practices), `fullstack` (full-stack Next.js). Apply with `ai-kit preset apply <name>`. | Planned |
269
+ | **Setup Comparison** | `ai-kit compare` — gap analysis comparing your AI Kit setup against other spec-driven tools. Shows what's covered and what's missing. | Planned |
270
+
271
+ See [plan.md](./plan.md) for detailed implementation plans.
272
+
273
+ ---
274
+
275
+ ## How AI Kit Compares
276
+
277
+ | Capability | AI Kit | Spec-Driven Tools (e.g., Spec Kit) |
278
+ |---|---|---|
279
+ | **Setup** | Auto-detect — zero manual config | Manual spec writing required |
280
+ | **Stack awareness** | Scans package.json, configs, directory structure | User describes stack in specs |
281
+ | **Rules generation** | Auto-generated from detected stack | User-written specifications |
282
+ | **Multi-tool support** | 5+ tools from single source | Varies by tool |
283
+ | **Quality hooks** | Built-in (minimal/standard/strict profiles) | Extension-dependent |
284
+ | **Security audit** | Built-in CLI command | Extension-dependent |
285
+ | **Token tracking** | Built-in with cost estimates | Not available |
286
+ | **Component awareness** | Auto-scanned with health scores | Not available |
287
+ | **Extension ecosystem** | Coming soon | Community catalog available |
288
+ | **Project principles** | Coming soon (`/constitution`) | Available (`/speckit.constitution`) |
289
+ | **Spec-first workflow** | Coming soon (`/specify`) | Core feature |
290
+
291
+ **AI Kit's philosophy**: Auto-detect everything possible, only ask for what can't be inferred. Spec-driven tools require manual specification upfront. Both approaches have merit — AI Kit is adding spec-first capabilities as an *optional* layer on top of auto-detection.
256
292
 
257
293
  ---
258
294
 
package/dist/index.js CHANGED
@@ -15,7 +15,7 @@ var GUIDES_DIR = path.join(PACKAGE_ROOT, "guides");
15
15
  var DOCS_SCAFFOLDS_DIR = path.join(PACKAGE_ROOT, "docs-scaffolds");
16
16
  var AGENTS_DIR = path.join(PACKAGE_ROOT, "agents");
17
17
  var CONTEXTS_DIR = path.join(PACKAGE_ROOT, "contexts");
18
- var VERSION = "1.5.0";
18
+ var VERSION = "1.6.1";
19
19
  var AI_KIT_CONFIG_FILE = "ai-kit.config.json";
20
20
  var GENERATED_FILES = {
21
21
  claudeMd: "CLAUDE.md",