@neyugn/agent-kits 0.2.6 → 0.2.8

package/common/skills/scan-techstack/scripts/techstack_scanner.py

@@ -0,0 +1,335 @@
+#!/usr/bin/env python3
+"""
+Techstack Scanner for Common Skills Layer
+
+Analyzes workspace to detect technologies, frameworks, and dependencies.
+Outputs structured JSON profile for filter-skill and filter-agent to consume.
+
+Usage:
+    python3 techstack_scanner.py [workspace_path]
+    python3 techstack_scanner.py .
+    python3 techstack_scanner.py /path/to/project
+"""
+
+import json
+import os
+import sys
+from pathlib import Path
+from datetime import datetime
+from typing import Dict, List, Any
+
+# =============================================================================
+# Detection Mappings
+# =============================================================================
+
+# Config files → Language/Platform detection
+CONFIG_TO_LANGUAGE = {
+    "package.json": "nodejs",
+    "tsconfig.json": "typescript",
+    "pubspec.yaml": "dart",
+    "pyproject.toml": "python",
+    "requirements.txt": "python",
+    "Cargo.toml": "rust",
+    "go.mod": "go",
+    "build.gradle": "kotlin",
+    "build.gradle.kts": "kotlin",
+    "Podfile": "swift",
+    "composer.json": "php",
+    "Gemfile": "ruby",
+}
+
+# Framework markers → Framework name + Category
+FRAMEWORK_MARKERS = {
+    "next.config.js": {"framework": "nextjs", "category": "frontend"},
+    "next.config.mjs": {"framework": "nextjs", "category": "frontend"},
+    "next.config.ts": {"framework": "nextjs", "category": "frontend"},
+    "vite.config.js": {"framework": "vite", "category": "frontend"},
+    "vite.config.ts": {"framework": "vite", "category": "frontend"},
+    "angular.json": {"framework": "angular", "category": "frontend"},
+    "nuxt.config.js": {"framework": "nuxtjs", "category": "frontend"},
+    "nuxt.config.ts": {"framework": "nuxtjs", "category": "frontend"},
+    "tailwind.config.js": {"framework": "tailwindcss", "category": "styling"},
+    "tailwind.config.ts": {"framework": "tailwindcss", "category": "styling"},
+    "tailwind.config.mjs": {"framework": "tailwindcss", "category": "styling"},
+    "Dockerfile": {"framework": "docker", "category": "devops"},
+    "docker-compose.yml": {"framework": "docker-compose", "category": "devops"},
+    "docker-compose.yaml": {"framework": "docker-compose", "category": "devops"},
+    ".gitlab-ci.yml": {"framework": "gitlab-ci", "category": "cicd"},
+    "pubspec.yaml": {"framework": "flutter", "category": "mobile"},
+}
+
+# Directory patterns → Framework + Category
+DIRECTORY_MARKERS = {
+    ".github/workflows": {"framework": "github-actions", "category": "cicd"},
+    "k8s": {"framework": "kubernetes", "category": "devops"},
+    "kubernetes": {"framework": "kubernetes", "category": "devops"},
+    "terraform": {"framework": "terraform", "category": "iac"},
+    "prisma": {"framework": "prisma", "category": "database"},
+}
+
+# NPM dependencies → Category detection
+NPM_CATEGORY_MAPPINGS = {
+    # Frontend
+    "react": "frontend",
+    "react-dom": "frontend",
+    "vue": "frontend",
+    "@angular/core": "frontend",
+    "svelte": "frontend",
+    # Backend
+    "express": "backend",
+    "fastify": "backend",
+    "@nestjs/core": "backend",
+    "koa": "backend",
+    "hono": "backend",
+    # Database
+    "@prisma/client": "database",
+    "drizzle-orm": "database",
+    "pg": "database",
+    "mysql2": "database",
+    "mongodb": "database",
+    "mongoose": "database",
+    "redis": "database",
+    "ioredis": "database",
+    # AI
+    "openai": "ai",
+    "langchain": "ai",
+    "@langchain/core": "ai",
+    "@anthropic-ai/sdk": "ai",
+    # Realtime
+    "socket.io": "realtime",
+    "socket.io-client": "realtime",
+    "ws": "realtime",
+    # Queue
+    "bullmq": "queue",
+    "bull": "queue",
+    "bee-queue": "queue",
+    "amqplib": "queue",
+    # Testing
+    "jest": "testing",
+    "vitest": "testing",
+    "playwright": "testing",
+    "@playwright/test": "testing",
+    "cypress": "testing",
+    # Auth
+    "passport": "auth",
+    "next-auth": "auth",
+    "@auth/core": "auth",
+    # GraphQL
+    "graphql": "graphql",
+    "@apollo/server": "graphql",
+    "@apollo/client": "graphql",
+}
+
+# Frameworks detected from dependencies
+NPM_FRAMEWORK_MAPPINGS = {
+    "next": "nextjs",
+    "react": "react",
+    "vue": "vue",
+    "@angular/core": "angular",
+    "express": "express",
+    "fastify": "fastify",
+    "@nestjs/core": "nestjs",
+    "socket.io": "socketio",
+    "tailwindcss": "tailwindcss",
+    "@prisma/client": "prisma",
+    "drizzle-orm": "drizzle",
+}
+
+# =============================================================================
+# Scanner Class
+# =============================================================================
+
+class TechstackScanner:
+    def __init__(self, workspace_path: str):
+        self.workspace = Path(workspace_path).resolve()
+        self.config_files: List[str] = []
+        self.languages: set = set()
+        self.frameworks: set = set()
+        self.databases: List[str] = []
+        self.tools: List[str] = []
+        self.dependencies: Dict[str, List[str]] = {}
+        self.categories: Dict[str, bool] = {
+            "frontend": False,
+            "backend": False,
+            "mobile": False,
+            "database": False,
+            "devops": False,
+            "ai": False,
+            "realtime": False,
+            "queue": False,
+            "graphql": False,
+            "auth": False,
+            "testing": False,
+        }
+
+    def scan(self) -> Dict[str, Any]:
+        """Run full workspace scan."""
+        if not self.workspace.exists():
+            return self._error(f"Workspace not found: {self.workspace}")
+
+        # Step 1: Scan config files for languages
+        self._scan_config_files()
+
+        # Step 2: Scan framework markers
+        self._scan_framework_markers()
+
+        # Step 3: Scan directories
+        self._scan_directories()
+
+        # Step 4: Parse dependencies
+        self._parse_dependencies()
+
+        # Step 5: Build result
+        return self._build_result()
+
+    def _scan_config_files(self):
+        """Scan for config files and detect languages."""
+        for filename, language in CONFIG_TO_LANGUAGE.items():
+            filepath = self.workspace / filename
+            if filepath.exists():
+                self.config_files.append(filename)
+                self.languages.add(language)
+
+    def _scan_framework_markers(self):
+        """Scan for framework-specific config files."""
+        for filename, info in FRAMEWORK_MARKERS.items():
+            filepath = self.workspace / filename
+            if filepath.exists():
+                self.config_files.append(filename)
+                self.frameworks.add(info["framework"])
+                self._set_category(info["category"])
+
+    def _scan_directories(self):
+        """Scan for special directories."""
+        for dirname, info in DIRECTORY_MARKERS.items():
+            dirpath = self.workspace / dirname
+            if dirpath.exists() and dirpath.is_dir():
+                self.config_files.append(f"{dirname}/")
+                self.frameworks.add(info["framework"])
+                self._set_category(info["category"])
+                self.tools.append(info["framework"])
+
+    def _parse_dependencies(self):
+        """Parse dependencies from package managers."""
+        # Parse package.json
+        package_json = self.workspace / "package.json"
+        if package_json.exists():
+            try:
+                with open(package_json, "r") as f:
+                    data = json.load(f)
+
+                all_deps = {}
+                all_deps.update(data.get("dependencies", {}))
+                all_deps.update(data.get("devDependencies", {}))
+
+                self.dependencies["npm"] = list(all_deps.keys())
+
+                # Detect categories and frameworks from deps
+                for dep_name in all_deps.keys():
+                    # Check category
+                    for pattern, category in NPM_CATEGORY_MAPPINGS.items():
+                        if pattern == dep_name or dep_name.startswith(f"{pattern}/"):
+                            self._set_category(category)
+
+                    # Check framework
+                    for pattern, framework in NPM_FRAMEWORK_MAPPINGS.items():
+                        if pattern == dep_name:
+                            self.frameworks.add(framework)
+
+            except (json.JSONDecodeError, IOError):
+                pass
+
+        # Parse pubspec.yaml (Flutter)
+        pubspec = self.workspace / "pubspec.yaml"
+        if pubspec.exists():
+            self.frameworks.add("flutter")
+            self._set_category("mobile")
+
+        # Parse Podfile (iOS)
+        podfile = self.workspace / "Podfile"
+        if podfile.exists():
+            self._set_category("mobile")
+
+        # Parse build.gradle (Android)
+        gradle = self.workspace / "build.gradle"
+        if gradle.exists() or (self.workspace / "build.gradle.kts").exists():
+            self._set_category("mobile")
+
+    def _set_category(self, category: str):
+        """Set category flag to True."""
+        # Map sub-categories to main categories
+        category_map = {
+            "frontend": "frontend",
+            "backend": "backend",
+            "mobile": "mobile",
+            "database": "database",
+            "devops": "devops",
+            "iac": "devops",
+            "cicd": "devops",
+            "ai": "ai",
+            "realtime": "realtime",
+            "queue": "queue",
+            "graphql": "graphql",
+            "auth": "auth",
+            "testing": "testing",
+            "styling": "frontend",  # Styling is part of frontend
+        }
+        main_category = category_map.get(category, category)
+        if main_category in self.categories:
+            self.categories[main_category] = True
+
+    def _build_result(self) -> Dict[str, Any]:
+        """Build final scan result."""
+        # Detect databases from frameworks
+        db_frameworks = ["prisma", "drizzle", "mongodb", "postgresql", "mysql"]
+        for fw in self.frameworks:
+            if fw in db_frameworks:
+                self.databases.append(fw)
+
+        return {
+            "success": True,
+            "analyzedAt": datetime.now().isoformat(),
+            "workspacePath": str(self.workspace),
+            "detection": {
+                "configFiles": sorted(set(self.config_files)),
+                "languages": sorted(self.languages),
+                "frameworks": sorted(self.frameworks),
+                "databases": sorted(set(self.databases)),
+                "tools": sorted(set(self.tools)),
+                "dependencies": self.dependencies,
+            },
+            "categories": self.categories,
+        }
+
+    def _error(self, message: str) -> Dict[str, Any]:
+        """Return error result."""
+        return {
+            "success": False,
+            "error": message,
+            "analyzedAt": datetime.now().isoformat(),
+        }
+
+
+# =============================================================================
+# Main
+# =============================================================================
+
+def main():
+    # Get workspace path from args or use current directory
+    if len(sys.argv) > 1:
+        workspace_path = sys.argv[1]
+    else:
+        workspace_path = "."
+
+    scanner = TechstackScanner(workspace_path)
+    result = scanner.scan()
+
+    # Output as JSON for AI to parse
+    print(json.dumps(result, indent=2))
+
+    # Exit code based on success
+    sys.exit(0 if result.get("success") else 1)
+
+
+if __name__ == "__main__":
+    main()

package/common/workflows/filter.md

@@ -2,7 +2,7 @@
 description: Analyze workspace and enable/disable skills/agents based on techstack
 ---
 
-# /filter - Workspace Skill Filtering
+# /filter - Workspace Skill & Agent Filtering
 
 ## Trigger
 
@@ -10,7 +10,7 @@ User calls `/filter` or requests "filter skills", "optimize skills for this proj
 
 ## Agent
 
-No specific agent required - this skill is standalone.
+No specific agent required - this workflow uses common skills.
 
 ## Prerequisites
 
@@ -19,18 +19,31 @@ No specific agent required - this skill is standalone.
 ## Critical Rules
 
 1. **ALWAYS ASK** - Always ask user confirmation before applying changes
-2. **NEVER DISABLE CORE** - Never disable core skills (clean-code, testing-patterns, etc.)
-3. **PERSIST RESULTS** - Save results to `.agent/workspace-profile.json`
+2. **NEVER DISABLE CORE** - Never disable core skills/agents
+3. **PERSIST RESULTS** - Save results to `.agent/profile.json`
 4. **ASK FUTURE STACK** - Ask user about planned future techstack additions
 
 ---
 
+## Workflow Overview
+
+```
+/filter
+  ├── Step 1: scan-techstack → Detect technologies
+  ├── Step 2: filter-skill → Recommend skill changes
+  ├── Step 3: filter-agent → Recommend agent changes
+  ├── Step 4: Present to User → Ask confirmation
+  └── Step 5: Save Profile → Persist to profile.json
+```
+
+---
+
 ## Workflow Steps
 
-### Step 1: Analyze Workspace
+### Step 1: Scan Techstack
 
 ```
-1. Read filter-skill SKILL.md to understand detection criteria
+1. Read scan-techstack SKILL.md to understand detection criteria
 2. Scan workspace for config files:
    - package.json, pubspec.yaml, pyproject.toml, Cargo.toml, go.mod
    - next.config.*, vite.config.*, angular.json, nuxt.config.*
@@ -38,20 +51,39 @@ No specific agent required - this skill is standalone.
    - .github/workflows/, .gitlab-ci.yml
    - prisma/, drizzle.config.*, terraform/
 3. Parse dependencies if package manager exists
-4. Build techstack profile
+4. Build techstack profile with categories:
+   - frontend, backend, mobile, database, devops, ai, realtime, queue
 ```
 
-### Step 2: Generate Recommendations
+**Output:** TechstackProfile object
+
+### Step 2: Filter Skills
 
 ```
-1. Load skill definitions from ARCHITECTURE.md
-2. Map detected techstack → required skills
-3. Identify skills to ENABLE (missing but needed)
-4. Identify skills to DISABLE (present but not needed)
-5. Build recommendation table
+1. Read filter-skill SKILL.md to understand mapping rules
+2. Use TechstackProfile categories to determine required skills
+3. Map detected frameworks → additional skills
+4. Identify skills to ENABLE (needed for project)
+5. Identify skills to DISABLE (not needed)
+6. Ensure core skills are NEVER in disabled list
 ```
 
-### Step 3: Present to User
+**Output:** SkillRecommendations object
+
+### Step 3: Filter Agents
+
+```
+1. Read filter-agent SKILL.md to understand agent mapping
+2. Use TechstackProfile categories to determine required agents
+3. Identify agents to DISABLE (irrelevant to project)
+4. Ensure core agents are NEVER in disabled list:
+   - orchestrator, project-planner, debugger
+   - security-auditor, code-reviewer, documentation-writer
+```
+
+**Output:** AgentRecommendations object
+
+### Step 4: Present to User
 
 Display in this format:
 
@@ -69,7 +101,9 @@ Display in this format:
 | Cache     | Redis                   |
 | CI/CD     | GitHub Actions          |
 
-### Recommended Changes
+---
+
+### 📚 Skill Recommendations
 
 #### ✅ Skills to ENABLE:
 
@@ -92,76 +126,108 @@ Display in this format:
 
 ---
 
-### Confirmation Questions:
+### 🤖 Agent Recommendations
+
+#### ✅ Agents to KEEP:
+
+| Agent               | Reason             |
+| ------------------- | ------------------ |
+| frontend-specialist | Next.js detected   |
+| backend-specialist  | API logic detected |
+| devops-engineer     | Docker/CI detected |
+
+#### ❌ Agents to DISABLE:
+
+| Agent               | Reason                 |
+| ------------------- | ---------------------- |
+| mobile-developer    | No mobile detected     |
+| realtime-specialist | No WebSocket detected  |
+| queue-specialist    | No queue deps detected |
+
+#### 🔒 Core Agents (always ON):
+
+- orchestrator, project-planner, debugger, security-auditor, code-reviewer
+
+---
+
+### ❓ Confirmation Questions:
 
 1. **Do you agree with the changes above?** (yes/no/customize)
 
 2. **Are there any techstacks you plan to add in the future?**
    (e.g., mobile app, Kubernetes, different CI/CD...)
 
-3. **Are there any skills you want to force enable or disable?**
+3. **Are there any skills/agents you want to force enable or disable?**
    (e.g., keep ai-rag-patterns even though not currently used)
 ```
 
-### Step 4: Process User Response
+### Step 5: Process User Response
 
 ```
 Based on user answer:
 
 If YES:
   → Apply all recommended changes
-  → Save to workspace-profile.json
+  → Save to profile.json
 
 If NO / CUSTOMIZE:
   → Ask which changes to skip/modify
   → Apply only approved changes
-  → Save to workspace-profile.json
+  → Save to profile.json
 
 If user mentions FUTURE techstack:
   → Add to futureTechstack array
-  → Keep relevant skills enabled (don't disable)
+  → Keep relevant skills/agents enabled (don't disable)
 ```
 
-### Step 5: Save Profile
+### Step 6: Save Profile
 
-Create/Update `.agent/workspace-profile.json`:
+Create/Update `.agent/profile.json`:
 
 ```json
 {
   "version": "1.0",
   "generatedAt": "ISO timestamp",
-  "analyzedBy": "filter-skill v1.0",
-  "techstack": { ... },
+  "analyzedBy": "filter-workflow v1.0",
+  "techstack": {
+    "languages": ["typescript"],
+    "frameworks": ["nextjs", "tailwindcss"],
+    "databases": ["postgresql"],
+    "tools": ["docker", "github-actions"]
+  },
   "skills": {
-    "enabled": [...],
-    "disabled": [...],
-    "userOverrides": { ... }
+    "enabled": ["react-patterns", "tailwind-patterns", "postgres-patterns", ...],
+    "disabled": ["flutter-patterns", "mobile-design", ...],
+    "userOverrides": {
+      "force-enabled": [],
+      "force-disabled": []
+    }
   },
   "agents": {
-    "disabled": [...]
+    "disabled": ["mobile-developer", "realtime-specialist", "queue-specialist"]
   },
-  "futureTechstack": [...]
+  "futureTechstack": ["react-native", "kubernetes"]
 }
 ```
 
-### Step 6: Confirm
+### Step 7: Confirm
 
 ```markdown
 ## ✅ Workspace Profile Saved!
 
-**File:** `.agent/workspace-profile.json`
+**File:** `.agent/profile.json`
 
 **Summary:**
 
 - Skills enabled: 15
 - Skills disabled: 8
-- Agents disabled: 2
+- Agents disabled: 3
 - Future techstack tracked: 2
 
 **Next steps:**
 
 - Profile will be automatically loaded in subsequent sessions
-- Run `/filter --reset` to re-enable all skills
+- Run `/filter --reset` to re-enable all skills/agents
 - Run `/filter` again when project adds new techstack
 ```
 
@@ -169,7 +235,7 @@ Create/Update `.agent/workspace-profile.json`:
 
 ## Output Format
 
-Final result is the `workspace-profile.json` file saved to disk.
+Final result is the `profile.json` file saved to disk.
 
 ---
 
@@ -181,6 +247,18 @@ Final result is the `workspace-profile.json` file saved to disk.
 
 ---
 
+## Command Variants
+
+```bash
+/filter              # Full analysis and recommendation
+/filter --reset      # Reset to default (enable all)
+/filter --force-enable <skill>   # Force enable specific skill
+/filter --force-disable <skill>  # Force disable specific skill
+/filter --dry-run    # Show recommendations without saving
+```
+
+---
+
 ## Examples
 
 ### Example 1: Next.js + Tailwind Project
@@ -188,17 +266,21 @@ Final result is the `workspace-profile.json` file saved to disk.
 ```
 User: /filter
 
-AI: [Analyze workspace...]
+AI: [Step 1: scan-techstack...]
+    [Step 2: filter-skill...]
+    [Step 3: filter-agent...]
 
 Detected: Next.js 14, TypeScript, Tailwind CSS, Prisma, PostgreSQL
 
-Recommend ENABLE: react-patterns, tailwind-patterns, postgres-patterns
-Recommend DISABLE: flutter-patterns, mobile-design, queue-patterns
+Skills to ENABLE: react-patterns, tailwind-patterns, postgres-patterns
+Skills to DISABLE: flutter-patterns, mobile-design, queue-patterns
 
-User: yes, future I might add mobile app
+Agents to DISABLE: mobile-developer, realtime-specialist, queue-specialist
+
+User: yes, but in the future I might add mobile app
 
 AI: [Save profile with futureTechstack: ["react-native"]]
-    [Keep mobile-design enabled for future use]
+    [Keep mobile-developer enabled for future use]
 ```
 
 ### Example 2: Python ML Project
@@ -210,12 +292,17 @@ AI: [Analyze workspace...]
 
 Detected: Python 3.11, Poetry, FastAPI, PostgreSQL, OpenAI
 
-Recommend ENABLE: api-patterns, postgres-patterns, ai-rag-patterns
-Recommend DISABLE: react-patterns, flutter-patterns, tailwind-patterns, mobile-design
+Skills to ENABLE: api-patterns, postgres-patterns, ai-rag-patterns
+Skills to DISABLE: react-patterns, flutter-patterns, tailwind-patterns
+
+Agents to ENABLE: ai-engineer, backend-specialist
+Agents to DISABLE: frontend-specialist, mobile-developer
 
-User: customize, keep testing-patterns and docker-patterns
+User: customize, I also need docker
 
-AI: [Apply with user customization]
+AI: [Add docker-patterns to enabled]
+    [Keep devops-engineer enabled]
+    [Apply with user customization]
 ```
 
 ---