@ngxtm/devkit 3.8.0 → 3.10.0

package/cli/init.js

@@ -85,18 +85,22 @@ function installForTool(toolId, tool, projectDir, options = {}) {
   let totalFiles = 0;
   const stats = {};
 
-  // 1. Install commands (if tool supports it)
+  // 1. Install core commands (if tool supports it) - optimized size ~400KB
   if (tool.commandsPath) {
-    const mergedCommandsDir = path.join(PACKAGE_ROOT, 'merged-commands');
+    const coreCommandsDir = path.join(PACKAGE_ROOT, 'core-commands');
     const commandsDir = path.join(targetDir, tool.commandsPath);
 
-    if (fs.existsSync(mergedCommandsDir)) {
-      const count = copyDir(mergedCommandsDir, commandsDir);
+    if (fs.existsSync(coreCommandsDir)) {
+      const count = copyDir(coreCommandsDir, commandsDir);
       stats.commands = count;
       totalFiles += count;
     }
   }
 
+  // Note: Skills are loaded on-demand from skills-compact.json
+  // Full skills are NOT copied to reduce installation size
+  // User can run "devkit add-skills" to install specific skill packs
+
   // 2. Install rules
   if (tool.rulesPath && options.rules && options.rules.length > 0) {
     const rulesDir = path.join(targetDir, tool.rulesPath);
@@ -136,14 +140,22 @@ function installForTool(toolId, tool, projectDir, options = {}) {
     }
   }
 
-  // 4. Install skills index
-  const skillsIndexSrc = path.join(PACKAGE_ROOT, 'skills-index.json');
-  if (fs.existsSync(skillsIndexSrc)) {
-    fs.copyFileSync(skillsIndexSrc, path.join(targetDir, 'skills-index.json'));
+  // 4. Install compact skill index (for auto-detection, ~20KB only)
+  const compactIndex = path.join(PACKAGE_ROOT, 'skills-compact.json');
+  if (fs.existsSync(compactIndex)) {
+    fs.copyFileSync(compactIndex, path.join(targetDir, 'skills-compact.json'));
     totalFiles++;
   }
 
-  // 5. Create devkit.json tracking file
+  // 5. Install base rules (including auto-skill detection)
+  const baseRulesDir = path.join(PACKAGE_ROOT, 'templates', 'base', 'rules');
+  if (tool.rulesPath && fs.existsSync(baseRulesDir)) {
+    const destRulesDir = path.join(targetDir, tool.rulesPath, 'base');
+    const count = copyDir(baseRulesDir, destRulesDir);
+    totalFiles += count;
+  }
+
+  // 6. Create devkit.json tracking file
   const devkitConfig = {
     version: VERSION,
     tool: toolId,
@@ -164,7 +176,7 @@ function installForTool(toolId, tool, projectDir, options = {}) {
   );
   totalFiles++;
 
-  // 6. Create settings.json if not exists (for tools that use it)
+  // 7. Create settings.json if not exists (for tools that use it)
   if (toolId === 'claude') {
     const settingsPath = path.join(targetDir, 'settings.json');
     if (!fs.existsSync(settingsPath)) {

package/cli/update.js

@@ -56,15 +56,17 @@ function updateToolInstallation(toolId, tool, projectDir, options = {}) {
 
   let updatedCount = 0;
 
-  // 1. Update commands (if tool supports it)
+  // 1. Update core commands (if tool supports it) - optimized size ~400KB
   if (tool.commandsPath) {
-    const mergedCommandsDir = path.join(PACKAGE_ROOT, 'merged-commands');
+    const coreCommandsDir = path.join(PACKAGE_ROOT, 'core-commands');
     const commandsDir = path.join(targetDir, tool.commandsPath);
-    if (fs.existsSync(mergedCommandsDir)) {
-      updatedCount += copyDir(mergedCommandsDir, commandsDir);
+    if (fs.existsSync(coreCommandsDir)) {
+      updatedCount += copyDir(coreCommandsDir, commandsDir);
     }
   }
 
+  // Note: Skills are loaded on-demand, not copied to project
+
   // 2. Update rules
   if (tool.rulesPath && options.rules && options.rules.length > 0) {
     const rulesDir = path.join(targetDir, tool.rulesPath);
@@ -97,14 +99,21 @@ function updateToolInstallation(toolId, tool, projectDir, options = {}) {
     }
   }
 
-  // 5. Update skills index
-  const skillsIndexSrc = path.join(PACKAGE_ROOT, 'skills-index.json');
-  if (fs.existsSync(skillsIndexSrc)) {
-    fs.copyFileSync(skillsIndexSrc, path.join(targetDir, 'skills-index.json'));
+  // 5. Update compact skill index (for auto-detection, ~20KB only)
+  const compactIndex = path.join(PACKAGE_ROOT, 'skills-compact.json');
+  if (fs.existsSync(compactIndex)) {
+    fs.copyFileSync(compactIndex, path.join(targetDir, 'skills-compact.json'));
     updatedCount++;
   }
 
-  // 6. Update devkit.json
+  // 6. Update base rules (including auto-skill detection)
+  const baseRulesDir = path.join(PACKAGE_ROOT, 'templates', 'base', 'rules');
+  if (tool.rulesPath && fs.existsSync(baseRulesDir)) {
+    const destRulesDir = path.join(targetDir, tool.rulesPath, 'base');
+    updatedCount += copyDir(baseRulesDir, destRulesDir);
+  }
+
+  // 7. Update devkit.json
   const newConfig = {
     ...config,
     version: VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngxtm/devkit",
-  "version": "3.8.0",
+  "version": "3.10.0",
   "description": "Per-project AI skills with smart tech detection - lightweight and context-optimized",
   "main": "cli/index.js",
   "bin": {

package/templates/base/rules/auto-skill.md

@@ -0,0 +1,139 @@
+# Auto-Skill Detection
+
+> Automatically detect and suggest relevant skills based on user's task
+
+## When to Activate
+
+Before starting ANY coding task, you SHOULD check if a relevant skill exists:
+
+1. **Analyze the user's request** - Extract key technologies, patterns, or domains
+2. **Check compact index** - Read `skills-compact.json` (~20KB) for skill names and categories
+3. **Suggest to user** - Present top 1-3 matching skills
+4. **Load on-demand** - When user confirms, read full skill from `skills/{name}/SKILL.md`
+
+## Quick Reference: Skill Categories
+
+| Code | Category | Examples |
+|------|----------|----------|
+| `fe` | Frontend | react, vue, nextjs, tailwind, ui/ux |
+| `be` | Backend | node, express, nestjs, fastapi, api |
+| `db` | Database | postgres, mysql, mongodb, redis, prisma |
+| `ai` | AI/ML | llm, agents, rag, mcp, embeddings |
+| `ops` | DevOps | docker, k8s, ci/cd, aws, terraform |
+| `test` | Testing | jest, playwright, tdd, e2e |
+| `sec` | Security | auth, oauth, jwt, owasp, pentest |
+| `git` | Git/Workflow | pr, review, commit, branching |
+| `mob` | Mobile | react-native, flutter, ios, android |
+| `py` | Python | django, flask, fastapi, pandas |
+| `go` | Golang | gin, echo, fiber, concurrency |
+
+## Detection Flow
+
+```
+User Request → Extract keywords (react, auth, test, etc.)
+                    ↓
+            Read skills-compact.json
+                    ↓
+            Match skill names containing keywords
+                    ↓
+            Found? → Suggest: "I found /skill-name. Use it?"
+              ↓ No
+            Check category (fe, be, ai, etc.)
+                    ↓
+            Suggest skills in that category
+```
+
+## How to Search
+
+### Step 1: Read Compact Index
+```
+Read: .claude/skills-compact.json
+Format: { "_categories": {...}, "skills": { "skill-name": "category-code" } }
+```
+
+### Step 2: Match by Name/Keyword
+Look for skills whose name contains user's keywords:
+- User says "react" → find skills with "react" in name
+- User says "authentication" → find "auth" skills
+- User says "docker" → find "docker" skills
+
+### Step 3: Load Full Skill
+When user confirms, read the full skill:
+```
+Read: .claude/skills/{skill-name}/SKILL.md
+```
+
+## Suggestion Format
+
+**Single match:**
+```
+I found a skill that might help:
+
+📌 /skill-name - [category]
+
+Load this skill? It has specialized patterns for your task.
+```
+
+**Multiple matches (max 3):**
+```
+I found skills that might help:
+
+1. /skill-1 - [category]
+2. /skill-2 - [category]
+3. /skill-3 - [category]
+
+Which one should I use? (or "none" to proceed without)
+```
+
+## Auto-Activate Triggers
+
+Some patterns should auto-suggest specific skills:
+
+| User says... | Suggest skill |
+|--------------|---------------|
+| "create PR", "pull request" | /git-advanced-workflows |
+| "code review" | /code-review |
+| "write tests", "add tests" | /test-master |
+| "fix bug", "debug" | /systematic-debugging |
+| "learn", "teach me" | /learn |
+| "react component" | /react-expert |
+| "nextjs", "next.js" | /nextjs-best-practices |
+| "docker", "container" | /docker-expert |
+| "api design" | /api-design-principles |
+| "database schema" | /database-design |
+| "authentication", "auth" | /auth-implementation-patterns |
+| "mcp server" | /mcp-developer |
+
+## Important Rules
+
+1. **Don't auto-load** - Always ask before loading a skill
+2. **Max 3 suggestions** - Don't overwhelm user
+3. **Be concise** - One-line per skill
+4. **Remember context** - If user said "none", don't suggest again for same task
+5. **On-demand loading** - Only read full SKILL.md when user confirms
+6. **Core commands available** - /learn, /react-expert, /docker-expert, etc. are pre-loaded
+
+## File Locations
+
+| File | Purpose | Size |
+|------|---------|------|
+| `skills-compact.json` | Quick lookup index | ~20KB |
+| `skills/{name}/SKILL.md` | Full skill content | varies |
+| `commands/*.md` | Core commands (pre-loaded) | ~400KB |
+
+## Example Interaction
+
+**User:** "Help me add JWT authentication to my Express API"
+
+**Claude:** (reads skills-compact.json, finds "auth-implementation-patterns")
+```
+I found a skill that matches your task:
+
+📌 /auth-implementation-patterns - security
+
+This skill has JWT, OAuth2, and session patterns. Load it?
+```
+
+**User:** "yes"
+
+**Claude:** (reads skills/auth-implementation-patterns/SKILL.md and applies it)