@ngxtm/devkit 2.0.2 → 2.1.0

package/cli/index.js

@@ -16,7 +16,8 @@ const {
   update,
   interactiveInstall,
   listSkills,
-  listCategories
+  listCategories,
+  initProject
 } = require('./install');
 
 /**
@@ -27,6 +28,7 @@ function parseArgs(args) {
     command: null,
     tool: null,
     minimal: false,
+    lite: false,      // New: commands only, no skills/rules/hooks
     categories: [],
     interactive: false,
     fullSkills: false,
@@ -40,6 +42,9 @@ function parseArgs(args) {
     } else if (arg === '--minimal' || arg === '-m') {
       options.minimal = true;
       options.indexOnly = false;
+    } else if (arg === '--lite' || arg === '-l') {
+      options.lite = true;
+      options.indexOnly = false;
     } else if (arg === '--interactive' || arg === '-i') {
       options.interactive = true;
     } else if (arg === '--full' || arg === '-f') {
@@ -69,7 +74,8 @@ USAGE:
   devkit <command> [tool] [options]
 
 COMMANDS:
-  install     Install skills and rules to AI tools
+  install     Install skills and rules to AI tools (global ~/.claude/)
+  init        Initialize devkit in current project (.claude/ folder)
   uninstall   Remove all installed skills and rules
   update      Check for updates and reinstall
   list        List all available skills
@@ -84,9 +90,13 @@ TOOLS:
   gemini      Gemini / Antigravity (~/.gemini/)
 
 OPTIONS:
+  --lite, -l              LITE mode - commands only, no skills/rules/hooks
+                          Best for avoiding context limit issues
+                          Installs: /brainstorm, /plan, /fix, /code, etc.
+
   (default)               Index-only mode - installs skills index file only
                           Commands and agents are always fully installed
-                          Best for avoiding context limit issues
+                          May still cause context issues with some models
 
   --minimal, -m           Install ~20 core skills (instead of index)
 
@@ -101,7 +111,8 @@ OPTIONS:
   --help, -h              Show this help
 
 EXAMPLES:
-  devkit install                    # Index-only (recommended)
+  devkit install --lite             # Commands only (recommended for context limit)
+  devkit install                    # Index-only (default)
   devkit install claude             # Index-only to Claude Code
   devkit install --minimal          # Install ~20 core skills
   devkit install --category=react   # Install React-related skills
@@ -133,11 +144,13 @@ const commands = {
     }
     install(options.tool, {
       minimal: options.minimal,
+      lite: options.lite,
       categories: options.categories,
       fullSkills: options.fullSkills,
       indexOnly: options.indexOnly
     });
   },
+  init: (options) => initProject(options),
   uninstall: (options) => uninstall(options.tool),
   update: () => update(),
   list: () => listSkills(),

package/cli/install.js

@@ -122,9 +122,12 @@ function installToTool(toolId, tool, options = {}) {
   // Determine install mode
   const indexOnly = options.indexOnly !== false && !options.fullSkills;
   const isMinimal = options.minimal;
+  const isLite = options.lite;  // New lite mode - commands only
   const hasCategories = options.categories && options.categories.length > 0;
 
-  if (indexOnly && !isMinimal && !hasCategories) {
+  if (isLite) {
+    console.log(`   Mode: LITE (commands only - minimal context usage)`);
+  } else if (indexOnly && !isMinimal && !hasCategories) {
     console.log(`   Mode: INDEX-ONLY (recommended - minimal context usage)`);
   } else if (isMinimal) {
     console.log(`   Mode: MINIMAL (${MINIMAL_SKILLS.length} core skills)`);
@@ -142,10 +145,13 @@ function installToTool(toolId, tool, options = {}) {
 
   let totalFiles = 0;
 
-  // 1. Install skills - depends on mode
-  const srcSkills = path.join(PACKAGE_ROOT, 'skills');
-  if (fs.existsSync(srcSkills)) {
-    if (indexOnly && !isMinimal && !hasCategories) {
+  // 1. Install skills - depends on mode (skip in lite mode)
+  if (isLite) {
+    console.log(`  ⏭️  Skipping skills (lite mode)`);
+  } else {
+    const srcSkills = path.join(PACKAGE_ROOT, 'skills');
+    if (fs.existsSync(srcSkills)) {
+      if (indexOnly && !isMinimal && !hasCategories) {
       // Index-only mode: just copy the index files
       const indexFile = path.join(PACKAGE_ROOT, 'SKILLS_INDEX.md');
       const jsonFile = path.join(PACKAGE_ROOT, 'skills-index.json');
@@ -171,69 +177,96 @@ function installToTool(toolId, tool, options = {}) {
       totalFiles += count;
     }
   }
+  }
 
-  // 2. Install commands to the official commands directory (for slash commands)
-  if (tool.commandsPath) {
-    // Install commands from commands/ folder
-    const srcCommands = path.join(PACKAGE_ROOT, 'commands');
-    if (fs.existsSync(srcCommands)) {
-      const count = copyDir(srcCommands, tool.commandsPath, replacements, options);
-      console.log(`  ✅ Commands: ${count} files`);
-      totalFiles += count;
+  // 2. Install commands - in lite mode, install only core commands
+  if (isLite) {
+    // Lite mode: install only essential claudekit commands
+    if (tool.commandsPath) {
+      const srcCommandsClaudekit = path.join(PACKAGE_ROOT, 'commands-claudekit');
+      if (fs.existsSync(srcCommandsClaudekit)) {
+        const count = copyDir(srcCommandsClaudekit, tool.commandsPath, replacements, options);
+        console.log(`  ✅ Commands (claudekit): ${count} files`);
+        totalFiles += count;
+      }
     }
+  } else if (!indexOnly || isMinimal || hasCategories) {
+    if (tool.commandsPath) {
+      // Install commands from commands/ folder
+      const srcCommands = path.join(PACKAGE_ROOT, 'commands');
+      if (fs.existsSync(srcCommands)) {
+        const count = copyDir(srcCommands, tool.commandsPath, replacements, options);
+        console.log(`  ✅ Commands: ${count} files`);
+        totalFiles += count;
+      }
 
-    // Install commands from commands-claudekit/ folder (merged into same directory)
-    const srcCommandsClaudekit = path.join(PACKAGE_ROOT, 'commands-claudekit');
-    if (fs.existsSync(srcCommandsClaudekit)) {
-      const count = copyDir(srcCommandsClaudekit, tool.commandsPath, replacements, options);
-      console.log(`  ✅ Commands (claudekit): ${count} files`);
-      totalFiles += count;
+      // Install commands from commands-claudekit/ folder (merged into same directory)
+      const srcCommandsClaudekit = path.join(PACKAGE_ROOT, 'commands-claudekit');
+      if (fs.existsSync(srcCommandsClaudekit)) {
+        const count = copyDir(srcCommandsClaudekit, tool.commandsPath, replacements, options);
+        console.log(`  ✅ Commands (claudekit): ${count} files`);
+        totalFiles += count;
+      }
     }
+  } else {
+    console.log(`  ⏭️  Skipping commands (index-only mode - use --full to include)`);
   }
 
-  // 3. Install core framework under agent-assistant subfolder (agents, matrix-skills only)
-  const coreDir = path.join(tool.skillsPath, 'agent-assistant');
-  const coreComponents = ['agents', 'matrix-skills'];
+  // 3. Install core framework (agents, matrix-skills) - SKIP in index-only/lite mode
+  if (!isLite && (!indexOnly || isMinimal || hasCategories)) {
+    const coreDir = path.join(tool.skillsPath, 'agent-assistant');
+    const coreComponents = ['agents', 'matrix-skills'];
+
+    for (const name of coreComponents) {
+      const srcPath = path.join(PACKAGE_ROOT, name);
+      if (fs.existsSync(srcPath)) {
+        const destPath = path.join(coreDir, name);
+        const count = copyDir(srcPath, destPath, replacements, options);
+        console.log(`  ✅ ${name}: ${count} files`);
+        totalFiles += count;
+      }
+    }
 
-  for (const name of coreComponents) {
-    const srcPath = path.join(PACKAGE_ROOT, name);
-    if (fs.existsSync(srcPath)) {
-      const destPath = path.join(coreDir, name);
-      const count = copyDir(srcPath, destPath, replacements, options);
-      console.log(`  ✅ ${name}: ${count} files`);
+    // 4. Install claudekit agents if available
+    const srcAgentsClaudekit = path.join(PACKAGE_ROOT, 'agents-claudekit');
+    if (fs.existsSync(srcAgentsClaudekit)) {
+      const destPath = path.join(coreDir, 'claudekit', 'agents');
+      const count = copyDir(srcAgentsClaudekit, destPath, replacements, options);
+      console.log(`  ✅ claudekit/agents: ${count} files`);
       totalFiles += count;
     }
+  } else if (!isLite) {
+    console.log(`  ⏭️  Skipping agents/matrix-skills (index-only mode)`);
   }
 
-  // 4. Install claudekit agents if available
-  const srcAgentsClaudekit = path.join(PACKAGE_ROOT, 'agents-claudekit');
-  if (fs.existsSync(srcAgentsClaudekit)) {
-    const destPath = path.join(coreDir, 'claudekit', 'agents');
-    const count = copyDir(srcAgentsClaudekit, destPath, replacements, options);
-    console.log(`  ✅ claudekit/agents: ${count} files`);
-    totalFiles += count;
-  }
-
-  // 5. Install rules
-  const srcRules = path.join(PACKAGE_ROOT, 'rules');
-  if (fs.existsSync(srcRules) && tool.rulesPath) {
-    const count = copyDir(srcRules, tool.rulesPath, replacements, options);
-    console.log(`  ✅ Rules: ${count} files`);
-    totalFiles += count;
+  // 5. Install rules - SKIP in index-only/lite mode (327 files = ~1.5MB, causes context limit)
+  if (!isLite && (!indexOnly || isMinimal || hasCategories)) {
+    const srcRules = path.join(PACKAGE_ROOT, 'rules');
+    if (fs.existsSync(srcRules) && tool.rulesPath) {
+      const count = copyDir(srcRules, tool.rulesPath, replacements, options);
+      console.log(`  ✅ Rules: ${count} files`);
+      totalFiles += count;
+    }
+  } else if (!isLite) {
+    console.log(`  ⏭️  Skipping rules (index-only mode - use --full to include)`);
   }
 
-  // 6. Install hooks (Claude Code only)
-  if (tool.supportsHooks && tool.hooksPath) {
-    const srcHooks = path.join(PACKAGE_ROOT, 'hooks');
-    if (fs.existsSync(srcHooks)) {
-      const count = copyDir(srcHooks, tool.hooksPath, replacements, options);
-      console.log(`  ✅ Hooks: ${count} files`);
-      totalFiles += count;
+  // 6. Install hooks (Claude Code only) - SKIP in index-only/lite mode
+  if (!isLite && (!indexOnly || isMinimal || hasCategories)) {
+    if (tool.supportsHooks && tool.hooksPath) {
+      const srcHooks = path.join(PACKAGE_ROOT, 'hooks');
+      if (fs.existsSync(srcHooks)) {
+        const count = copyDir(srcHooks, tool.hooksPath, replacements, options);
+        console.log(`  ✅ Hooks: ${count} files`);
+        totalFiles += count;
+      }
     }
+  } else if (!isLite) {
+    console.log(`  ⏭️  Skipping hooks (index-only mode)`);
   }
 
-  // 7. Install output-styles (Claude Code only)
-  if (toolId === 'claude') {
+  // 7. Install output-styles (Claude Code only) - SKIP in index-only/lite mode
+  if (!isLite && toolId === 'claude' && (!indexOnly || isMinimal || hasCategories)) {
     const srcStyles = path.join(PACKAGE_ROOT, 'output-styles');
     if (fs.existsSync(srcStyles)) {
       const destStyles = path.join(tool.basePath, 'output-styles');
@@ -246,7 +279,7 @@ function installToTool(toolId, tool, options = {}) {
     const srcWorkflows = path.join(PACKAGE_ROOT, 'workflows');
     if (fs.existsSync(srcWorkflows)) {
       const destWorkflows = path.join(tool.basePath, 'workflows');
-      const count = copyDir(destWorkflows, destWorkflows, replacements, options);
+      const count = copyDir(srcWorkflows, destWorkflows, replacements, options);
       console.log(`  ✅ Workflows: ${count} files`);
       totalFiles += count;
     }
@@ -513,12 +546,157 @@ function listCategories() {
   console.log('  devkit install --interactive\n');
 }
 
+/**
+ * Initialize devkit in current project directory
+ * Creates .claude/ folder with commands, hooks, and lightweight rules
+ */
+function initProject(options = {}) {
+  const projectDir = process.cwd();
+  const claudeDir = path.join(projectDir, '.claude');
+
+  console.log('\n' + '='.repeat(60));
+  console.log('  DEVKIT - PROJECT INIT');
+  console.log('='.repeat(60));
+  console.log(`\nInitializing devkit in: ${projectDir}`);
+
+  // Check if .claude already exists
+  if (fs.existsSync(claudeDir)) {
+    console.log(`\n⚠️  .claude/ folder already exists.`);
+    if (!options.force) {
+      console.log('Use --force to overwrite existing files.');
+      return;
+    }
+    console.log('--force specified, overwriting...');
+  }
+
+  fs.mkdirSync(claudeDir, { recursive: true });
+
+  let totalFiles = 0;
+
+  // 1. Copy commands (claudekit only - lightweight)
+  const srcCommands = path.join(PACKAGE_ROOT, 'commands-claudekit');
+  if (fs.existsSync(srcCommands)) {
+    const destCommands = path.join(claudeDir, 'commands');
+    const count = copyDir(srcCommands, destCommands, {}, {});
+    console.log(`  ✅ Commands: ${count} files`);
+    totalFiles += count;
+  }
+
+  // 2. Copy hooks
+  const srcHooks = path.join(PACKAGE_ROOT, 'hooks');
+  if (fs.existsSync(srcHooks)) {
+    const destHooks = path.join(claudeDir, 'hooks');
+    const count = copyDir(srcHooks, destHooks, {}, {});
+    console.log(`  ✅ Hooks: ${count} files`);
+    totalFiles += count;
+  }
+
+  // 3. Copy agents (claudekit only)
+  const srcAgents = path.join(PACKAGE_ROOT, 'agents-claudekit');
+  if (fs.existsSync(srcAgents)) {
+    const destAgents = path.join(claudeDir, 'agents');
+    const count = copyDir(srcAgents, destAgents, {}, {});
+    console.log(`  ✅ Agents: ${count} files`);
+    totalFiles += count;
+  }
+
+  // 4. Copy output-styles
+  const srcStyles = path.join(PACKAGE_ROOT, 'output-styles');
+  if (fs.existsSync(srcStyles)) {
+    const destStyles = path.join(claudeDir, 'output-styles');
+    const count = copyDir(srcStyles, destStyles, {}, {});
+    console.log(`  ✅ Output Styles: ${count} files`);
+    totalFiles += count;
+  }
+
+  // 5. Copy lightweight rules (create minimal rules, not the full 327 files)
+  const rulesDir = path.join(claudeDir, 'rules');
+  fs.mkdirSync(rulesDir, { recursive: true });
+
+  // Create minimal rule files similar to claudekit_engineer
+  const minimalRules = {
+    'development-rules.md': `# Development Rules
+
+## Code Quality
+- Write clean, readable code with meaningful names
+- Follow project conventions and patterns
+- Keep functions small and focused
+- Add comments only where logic isn't self-evident
+
+## Testing
+- Write tests for new features
+- Ensure tests pass before committing
+- Use descriptive test names
+
+## Git
+- Write clear commit messages
+- Keep commits focused and atomic
+- Review changes before pushing
+`,
+    'orchestration-protocol.md': `# Orchestration Protocol
+
+## Workflow
+1. Understand the task completely before starting
+2. Break complex tasks into smaller steps
+3. Validate assumptions with the user
+4. Test changes incrementally
+
+## Communication
+- Be concise and clear
+- Ask clarifying questions when needed
+- Report progress on long tasks
+`
+  };
+
+  for (const [filename, content] of Object.entries(minimalRules)) {
+    fs.writeFileSync(path.join(rulesDir, filename), content);
+    totalFiles++;
+  }
+  console.log(`  ✅ Rules: ${Object.keys(minimalRules).length} files (lightweight)`);
+
+  // 6. Copy statusline scripts
+  const statuslineFiles = ['statusline.cjs', 'statusline.ps1', 'statusline.sh'];
+  for (const file of statuslineFiles) {
+    const srcFile = path.join(PACKAGE_ROOT, file);
+    if (fs.existsSync(srcFile)) {
+      fs.copyFileSync(srcFile, path.join(claudeDir, file));
+      totalFiles++;
+    }
+  }
+
+  // 7. Create settings.json
+  const settings = {
+    includeCoAuthoredBy: false
+  };
+  fs.writeFileSync(
+    path.join(claudeDir, 'settings.json'),
+    JSON.stringify(settings, null, 2)
+  );
+  totalFiles++;
+  console.log(`  ✅ Settings: created`);
+
+  console.log(`\n  📊 Total: ${totalFiles} files`);
+
+  console.log('\n' + '='.repeat(60));
+  console.log('  ✅ PROJECT INITIALIZED');
+  console.log('='.repeat(60));
+  console.log(`\nDevkit initialized in ${claudeDir}`);
+  console.log('\nAvailable commands:');
+  console.log('  /plan        - Plan implementation');
+  console.log('  /brainstorm  - Brainstorm ideas');
+  console.log('  /fix         - Fix issues');
+  console.log('  /code        - Start coding');
+  console.log('  /cook        - Build a feature');
+  console.log('');
+}
+
 // Export for CLI
 module.exports = {
   install,
   uninstall,
   update,
   interactiveInstall,
+  initProject,
   listSkills,
   listCategories,
   TOOLS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngxtm/devkit",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "Unified multi-agent system with auto-synced skills from multiple sources",
   "main": "cli/install.js",
   "bin": {