@ngxtm/devkit 2.1.0 → 3.0.1

package/README.md

@@ -1,236 +1,96 @@
-# Devkit Agent Assistant
+# Devkit
 
-> Unified multi-agent system with auto-synced skills from multiple sources
+> Unified multi-agent skill system for AI coding assistants
 
 [![npm version](https://img.shields.io/npm/v/@ngxtm/devkit.svg)](https://www.npmjs.com/package/@ngxtm/devkit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+Supercharge your AI coding assistant with **414+ skills**, **38 agents**, and **57 commands**. Works with Claude Code, Cursor, GitHub Copilot, and Gemini.
+
 ## Features
 
-- **414+ Skills** - Merged from antigravity, agent-assistant, and claudekit
-- **38 Agents** - 20 from agent-assistant + 18 from claudekit
-- **57 Commands** - Full workflow commands from both sources
-- **9 Hooks** - Session management, privacy, context awareness (claudekit)
-- **6 Output Styles** - Coding levels from ELI5 to God mode (claudekit)
-- **10 Rules** - Coding standards for TypeScript, React, NestJS, etc.
-- **Matrix Skill Discovery** - Intelligent skill injection based on context
+- **Smart Tech Detection** - Automatically detects your project stack and loads relevant skills
+- **Per-Project Installation** - Install only what you need, where you need it
+- **Context-Optimized** - Index-only mode reduces context usage by 99.95%
 - **Auto-Sync** - Daily updates from upstream sources via GitHub Actions
+- **Multi-Tool Support** - Works with Claude, Cursor, Copilot, and Gemini
 
-## Sources
-
-| Source | What's Included |
-|--------|-----------------|
-| [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) | 256+ skills (primary, frequently updated) |
-| [agent-assistant](https://github.com/hainamchung/agent-assistant) | 310+ skills, Matrix system, 20 agents, 25 commands |
-| [claudekit](https://github.com/anthropics/claudekit) | 45 skills, 18 agents, 32 commands, hooks, output styles |
-| [skill-rule](https://github.com/ngxtm/skill-rule) | Coding standards for 10 frameworks |
-
-## Installation
+## Quick Start
 
 ```bash
 npm install -g @ngxtm/devkit
 devkit install
 ```
 
-### Install Modes
-
-| Mode | Command | Skills Size | Description |
-|------|---------|-------------|-------------|
-| **Index-only** (default) | `devkit install` | ~30KB | Only installs skills index, Claude loads skills on-demand |
-| Minimal | `devkit install --minimal` | ~2MB | Installs ~20 core skills |
-| Category | `devkit install -c=react` | varies | Installs specific categories |
-| Full | `devkit install --full` | ~59MB | Installs all 413+ skills (may cause context limit) |
-
-```bash
-# Recommended: Index-only (default)
-devkit install                      # Best for avoiding context limits
-devkit install claude               # Claude Code only
-
-# Alternative modes
-devkit install --minimal            # ~20 core skills
-devkit install --category=react,ts  # Specific categories
-devkit install --full               # All skills (large)
-devkit install --interactive        # Choose interactively
-```
-
-### How Index-Only Mode Works
-
-Instead of installing 3,500+ files (59MB), devkit installs:
-- `SKILLS_INDEX.md` - 30KB summary of all 411 skills
-- All commands (`/plan`, `/cook`, `/brainstorm`, etc.)
-- All agents (planner, debugger, reviewer, etc.)
-- Hooks, rules, output-styles
-
-When Claude needs a specific skill, it reads the index to find it, then loads the full skill on-demand. This reduces context usage by **99.95%**.
-
-### Available Categories
+## Installation Modes
 
-```bash
-devkit categories    # Show all categories
-```
+| Mode | Command | Size | Description |
+|------|---------|------|-------------|
+| **Index-only** | `devkit install` | ~30KB | On-demand skill loading (recommended) |
+| Minimal | `devkit install --minimal` | ~2MB | ~20 core skills |
+| Category | `devkit install -c=react,ts` | varies | Specific categories only |
+| Full | `devkit install --full` | ~59MB | All 414+ skills |
 
-| Category | Skills | Description |
-|----------|--------|-------------|
-| react | 9 | React, Next.js, Remix |
-| typescript | 4 | TypeScript patterns |
-| node | 6 | Node.js, NestJS, Express |
-| database | 5 | PostgreSQL, MongoDB, Redis |
-| devops | 7 | Docker, K8s, CI/CD, AWS |
-| testing | 6 | Jest, Playwright, Vitest |
-| security | 5 | OWASP, Auth, API security |
-| ai | 6 | AI agents, MCP, prompts |
-| mobile | 5 | React Native, Flutter |
-| frontend | 6 | CSS, Tailwind, a11y |
-| backend | 6 | APIs, microservices |
-| tools | 6 | Git, debugging, docs |
-
-## Uninstallation
+## Commands
 
 ```bash
-# Remove from all tools
-devkit uninstall
-
-# Remove from specific tool
-devkit uninstall claude
-devkit uninstall cursor
+# Planning & Building
+/plan           # Create implementation strategy
+/cook           # Build feature with full workflow
+/code           # Code with workflow
+
+# Development
+/fix            # Fix bugs
+/test           # Run tests
+/review         # Code review
+/scout          # Explore codebase
+
+# Setup
+/bootstrap      # Setup new project
+/coding-level   # Set output style (eli5 → god)
+/kanban         # Manage tasks
 ```
 
-## What Gets Installed
+## Coding Levels
 
-### For Claude Code (`~/.claude/`)
-
-```
-~/.claude/
-├── skills/                   # 414+ skills
-│   └── agent-assistant/      # Core framework
-│       ├── agents/           # 20 agents
-│       ├── commands/         # 25 commands
-│       ├── matrix-skills/    # Skill discovery system
-│       └── claudekit/        # Claudekit components
-│           ├── agents/       # 18 agents
-│           └── commands/     # 32 commands
-├── rules/                    # Coding standards
-├── hooks/                    # 9 hooks
-├── output-styles/            # 6 coding levels
-├── workflows/                # Workflow definitions
-└── settings.json             # Claude settings
-```
+| Level | Command | Style |
+|-------|---------|-------|
+| 0 | `/coding-level 0` | ELI5 - Learning friendly |
+| 1 | `/coding-level 1` | Junior - Detailed comments |
+| 2 | `/coding-level 2` | Mid - Balanced |
+| 3 | `/coding-level 3` | Senior - Concise |
+| 4 | `/coding-level 4` | Lead - Architecture focus |
+| 5 | `/coding-level 5` | God - Maximum efficiency |
 
-### For Other Tools
-
-- **Cursor**: Skills, agents, commands, rules
-- **GitHub Copilot**: Skills, rules
-- **Gemini/Antigravity**: Skills, rules
-
-## Quick Start Commands
-
-After installation, use these commands in your AI coding tool:
-
-### From agent-assistant
-```
-/cook           - Build a feature with full workflow
-/plan           - Plan implementation strategy
-/review         - Code review
-/test           - Run tests
-/fix            - Fix bugs
-```
+## Categories
 
-### From claudekit
-```
-/bootstrap      - Setup new project
-/coding-level   - Set output style (eli5/junior/mid/senior/lead/god)
-/code           - Code with workflow
-/scout          - Explore codebase
-/kanban         - Manage tasks
+```bash
+devkit categories    # List all categories
 ```
 
-## Output Styles (claudekit)
-
-Set your preferred coding level:
-
-| Level | Style | Best For |
-|-------|-------|----------|
-| `/coding-level 0` | ELI5 | Learning, explanations |
-| `/coding-level 1` | Junior | Detailed comments, safe patterns |
-| `/coding-level 2` | Mid | Balanced, best practices |
-| `/coding-level 3` | Senior | Concise, optimized |
-| `/coding-level 4` | Lead | Architecture focus |
-| `/coding-level 5` | God | Minimal, maximum efficiency |
-
-## Hooks (Claude Code only)
-
-Claudekit hooks provide:
-- **session-init** - Initialize session context
-- **privacy-block** - Protect sensitive files
-- **scout-block** - Control exploration scope
-- **dev-rules-reminder** - Enforce coding standards
-- **usage-context-awareness** - Smart context management
-- And more...
-
-## Auto-Sync
-
-Skills and rules are automatically updated via GitHub Actions:
-
-- **Skills**: Daily sync from antigravity + agent-assistant
-- **Rules**: Weekly sync from skill-rule
-- **Hooks/Claudekit**: Manual sync (local source)
-
-## Configuration
+| Category | Skills | Category | Skills |
+|----------|--------|----------|--------|
+| react | 9 | database | 5 |
+| typescript | 4 | devops | 7 |
+| node | 6 | testing | 6 |
+| security | 5 | ai | 6 |
+| mobile | 5 | frontend | 6 |
+| backend | 6 | tools | 6 |
 
-Edit `SYNC_CONFIG.yaml` to customize sources:
-
-```yaml
-skill_sources:
-  - name: antigravity-awesome-skills
-    repo: sickn33/antigravity-awesome-skills
-    enabled: true
-    priority: 1
-
-  - name: agent-assistant
-    repo: hainamchung/agent-assistant
-    enabled: true
-    priority: 2
-
-sync:
-  merge_strategy: prefer-primary
-  schedule: "0 0 * * *"
-```
-
-## Development
+## Uninstall
 
 ```bash
-# Clone the repo
-git clone https://github.com/YOUR_USERNAME/devkit-assistant.git
-cd devkit-assistant
-
-# Install dependencies
-npm install
-
-# Run initial sync (first time only)
-# Windows:
-initial-sync.bat
-
-# Linux/Mac:
-./initial-sync.sh
-
-# Test install locally
-node cli/install.js
+devkit uninstall          # Remove from all tools
+devkit uninstall claude   # Remove from specific tool
 ```
 
 ## Contributing
 
 1. Fork the repository
-2. Add your skills to `skills/your-skill-name/SKILL.md`
+2. Add skills to `skills/your-skill-name/SKILL.md`
 3. Run `python scripts/update_matrix.py`
 4. Submit a pull request
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) for details.
-
-## Credits
-
-- [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) by sickn33
-- [agent-assistant](https://github.com/hainamchung/agent-assistant) by hainamchung
-- [claudekit](https://github.com/anthropics/claudekit) by Anthropic
-- [skill-rule](https://github.com/ngxtm/skill-rule) by ngxtm
+MIT

package/cli/detect.js

@@ -0,0 +1,292 @@
+/**
+ * Project Type Detection
+ *
+ * Detects the technology stack of a project by analyzing:
+ * - Configuration files (package.json, pubspec.yaml, go.mod, etc.)
+ * - Dependencies
+ * - File patterns
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Detection rules for different technology stacks
+ * Each rule can have:
+ * - files: Array of files that indicate this tech (any match)
+ * - dependencies: Array of npm dependencies (any match)
+ * - devDependencies: Array of npm devDependencies (any match)
+ * - rules: Array of rule directories to install
+ */
+const DETECTION_RULES = {
+  // Flutter/Dart
+  flutter: {
+    files: ['pubspec.yaml', 'pubspec.lock'],
+    rules: ['flutter', 'dart']
+  },
+
+  // React (standalone)
+  react: {
+    dependencies: ['react', 'react-dom'],
+    excludeIf: ['next'], // Don't detect if Next.js is present
+    rules: ['react', 'typescript']
+  },
+
+  // Next.js (includes React rules)
+  nextjs: {
+    files: ['next.config.js', 'next.config.mjs', 'next.config.ts'],
+    dependencies: ['next'],
+    rules: ['nextjs', 'react', 'typescript']
+  },
+
+  // NestJS
+  nestjs: {
+    files: ['nest-cli.json'],
+    dependencies: ['@nestjs/core', '@nestjs/common'],
+    rules: ['nestjs', 'typescript']
+  },
+
+  // Golang
+  golang: {
+    files: ['go.mod', 'go.sum'],
+    rules: ['golang']
+  },
+
+  // Python
+  python: {
+    files: ['pyproject.toml', 'requirements.txt', 'Pipfile', 'setup.py', 'poetry.lock'],
+    rules: ['python']
+  },
+
+  // Rust
+  rust: {
+    files: ['Cargo.toml', 'Cargo.lock'],
+    rules: ['rust']
+  },
+
+  // Java/Kotlin
+  java: {
+    files: ['pom.xml', 'build.gradle', 'build.gradle.kts'],
+    rules: ['java']
+  },
+
+  // TypeScript (generic, if not covered by framework)
+  typescript: {
+    files: ['tsconfig.json'],
+    devDependencies: ['typescript'],
+    rules: ['typescript']
+  },
+
+  // Prisma ORM
+  prisma: {
+    files: ['prisma/schema.prisma'],
+    dependencies: ['@prisma/client'],
+    devDependencies: ['prisma'],
+    rules: ['prisma']
+  },
+
+  // Supabase
+  supabase: {
+    files: ['supabase/config.toml'],
+    dependencies: ['@supabase/supabase-js'],
+    rules: ['supabase']
+  },
+
+  // Vue.js
+  vue: {
+    dependencies: ['vue'],
+    files: ['vue.config.js', 'vite.config.ts', 'vite.config.js'],
+    rules: ['vue', 'typescript']
+  },
+
+  // Angular
+  angular: {
+    files: ['angular.json'],
+    dependencies: ['@angular/core'],
+    rules: ['angular', 'typescript']
+  },
+
+  // Svelte/SvelteKit
+  svelte: {
+    files: ['svelte.config.js'],
+    dependencies: ['svelte', '@sveltejs/kit'],
+    rules: ['svelte', 'typescript']
+  },
+
+  // Express.js
+  express: {
+    dependencies: ['express'],
+    rules: ['express', 'nodejs']
+  },
+
+  // Fastify
+  fastify: {
+    dependencies: ['fastify'],
+    rules: ['fastify', 'nodejs']
+  },
+
+  // Hono
+  hono: {
+    dependencies: ['hono'],
+    rules: ['hono', 'typescript']
+  },
+
+  // Tailwind CSS
+  tailwind: {
+    files: ['tailwind.config.js', 'tailwind.config.ts', 'tailwind.config.cjs'],
+    devDependencies: ['tailwindcss'],
+    rules: ['tailwind']
+  },
+
+  // Docker
+  docker: {
+    files: ['Dockerfile', 'docker-compose.yml', 'docker-compose.yaml'],
+    rules: ['docker']
+  }
+};
+
+/**
+ * Parse package.json and extract dependencies
+ */
+function parsePackageJson(projectDir) {
+  const pkgPath = path.join(projectDir, 'package.json');
+
+  if (!fs.existsSync(pkgPath)) {
+    return { dependencies: {}, devDependencies: {} };
+  }
+
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return {
+      dependencies: pkg.dependencies || {},
+      devDependencies: pkg.devDependencies || {}
+    };
+  } catch (e) {
+    return { dependencies: {}, devDependencies: {} };
+  }
+}
+
+/**
+ * Check if any file from the list exists in the project
+ */
+function hasAnyFile(projectDir, files) {
+  return files.some(file => fs.existsSync(path.join(projectDir, file)));
+}
+
+/**
+ * Check if any dependency from the list exists
+ */
+function hasAnyDependency(deps, targetDeps) {
+  return targetDeps.some(dep => dep in deps);
+}
+
+/**
+ * Detect project types based on rules
+ * @param {string} projectDir - Project directory to analyze
+ * @returns {string[]} - Array of detected technology types
+ */
+function detectProjectType(projectDir = process.cwd()) {
+  const detected = new Set();
+  const { dependencies, devDependencies } = parsePackageJson(projectDir);
+  const allDeps = { ...dependencies, ...devDependencies };
+
+  // First pass: detect all matching rules
+  const matches = [];
+
+  for (const [type, config] of Object.entries(DETECTION_RULES)) {
+    let isMatch = false;
+
+    // Check files
+    if (config.files && hasAnyFile(projectDir, config.files)) {
+      isMatch = true;
+    }
+
+    // Check dependencies
+    if (config.dependencies && hasAnyDependency(allDeps, config.dependencies)) {
+      isMatch = true;
+    }
+
+    // Check devDependencies specifically
+    if (config.devDependencies && hasAnyDependency(devDependencies, config.devDependencies)) {
+      isMatch = true;
+    }
+
+    if (isMatch) {
+      // Check exclusions
+      if (config.excludeIf) {
+        const shouldExclude = config.excludeIf.some(excludeType => {
+          const excludeConfig = DETECTION_RULES[excludeType];
+          if (!excludeConfig) return false;
+
+          if (excludeConfig.files && hasAnyFile(projectDir, excludeConfig.files)) return true;
+          if (excludeConfig.dependencies && hasAnyDependency(allDeps, excludeConfig.dependencies)) return true;
+          return false;
+        });
+
+        if (shouldExclude) continue;
+      }
+
+      matches.push({ type, rules: config.rules });
+    }
+  }
+
+  // Collect unique rules from all matches
+  for (const match of matches) {
+    detected.add(match.type);
+  }
+
+  return Array.from(detected);
+}
+
+/**
+ * Get all rules that should be installed for detected types
+ * @param {string[]} detectedTypes - Array of detected technology types
+ * @returns {string[]} - Array of unique rule directories to install
+ */
+function getRulesForTypes(detectedTypes) {
+  const rules = new Set();
+
+  for (const type of detectedTypes) {
+    const config = DETECTION_RULES[type];
+    if (config && config.rules) {
+      config.rules.forEach(rule => rules.add(rule));
+    }
+  }
+
+  return Array.from(rules);
+}
+
+/**
+ * Print detection results
+ */
+function printDetectionResults(projectDir = process.cwd()) {
+  const detected = detectProjectType(projectDir);
+  const rules = getRulesForTypes(detected);
+
+  console.log('\n' + '='.repeat(50));
+  console.log('  PROJECT DETECTION RESULTS');
+  console.log('='.repeat(50));
+  console.log(`\nDirectory: ${projectDir}`);
+
+  if (detected.length === 0) {
+    console.log('\nNo specific technology detected.');
+    console.log('Will install base commands only.\n');
+    return;
+  }
+
+  console.log('\nDetected Technologies:');
+  detected.forEach(tech => console.log(`  - ${tech}`));
+
+  console.log('\nRules to Install:');
+  rules.forEach(rule => console.log(`  - ${rule}`));
+
+  console.log('');
+}
+
+module.exports = {
+  DETECTION_RULES,
+  detectProjectType,
+  getRulesForTypes,
+  printDetectionResults,
+  parsePackageJson
+};