@neyugn/agent-kits 0.2.5 → 0.2.7

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

@@ -0,0 +1,308 @@
+---
+description: Analyze workspace and enable/disable skills/agents based on techstack
+---
+
+# /filter - Workspace Skill & Agent Filtering
+
+## Trigger
+
+User calls `/filter` or requests "filter skills", "optimize skills for this project"
+
+## Agent
+
+No specific agent required - this workflow uses common skills.
+
+## Prerequisites
+
+- Currently in a workspace with code
+
+## Critical Rules
+
+1. **ALWAYS ASK** - Always ask user confirmation before applying changes
+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: Scan Techstack
+
+```
+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.*
+   - Dockerfile, docker-compose.*, k8s/, kubernetes/
+   - .github/workflows/, .gitlab-ci.yml
+   - prisma/, drizzle.config.*, terraform/
+3. Parse dependencies if package manager exists
+4. Build techstack profile with categories:
+   - frontend, backend, mobile, database, devops, ai, realtime, queue
+```
+
+**Output:** TechstackProfile object
+
+### Step 2: Filter Skills
+
+```
+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
+```
+
+**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:
+
+```markdown
+## 🔍 Workspace Analysis Complete
+
+### Detected Techstack
+
+| Category  | Technology              |
+| --------- | ----------------------- |
+| Language  | TypeScript, Python      |
+| Framework | Next.js 14 (App Router) |
+| Styling   | Tailwind CSS v4         |
+| Database  | PostgreSQL (Prisma)     |
+| Cache     | Redis                   |
+| CI/CD     | GitHub Actions          |
+
+---
+
+### 📚 Skill Recommendations
+
+#### ✅ Skills to ENABLE:
+
+| Skill             | Reason                   |
+| ----------------- | ------------------------ |
+| react-patterns    | Next.js detected         |
+| tailwind-patterns | tailwind.config.js found |
+| postgres-patterns | Prisma + PostgreSQL      |
+
+#### ❌ Skills to DISABLE:
+
+| Skill            | Reason                   |
+| ---------------- | ------------------------ |
+| flutter-patterns | No pubspec.yaml found    |
+| mobile-design    | No mobile setup detected |
+
+#### 🔒 Core Skills (always ON):
+
+- clean-code, testing-patterns, security-fundamentals, brainstorming, plan-writing
+
+---
+
+### 🤖 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/agents you want to force enable or disable?**
+   (e.g., keep ai-rag-patterns even though not currently used)
+```
+
+### Step 5: Process User Response
+
+```
+Based on user answer:
+
+If YES:
+  → Apply all recommended changes
+  → Save to profile.json
+
+If NO / CUSTOMIZE:
+  → Ask which changes to skip/modify
+  → Apply only approved changes
+  → Save to profile.json
+
+If user mentions FUTURE techstack:
+  → Add to futureTechstack array
+  → Keep relevant skills/agents enabled (don't disable)
+```
+
+### Step 6: Save Profile
+
+Create/Update `.agent/profile.json`:
+
+```json
+{
+  "version": "1.0",
+  "generatedAt": "ISO timestamp",
+  "analyzedBy": "filter-workflow v1.0",
+  "techstack": {
+    "languages": ["typescript"],
+    "frameworks": ["nextjs", "tailwindcss"],
+    "databases": ["postgresql"],
+    "tools": ["docker", "github-actions"]
+  },
+  "skills": {
+    "enabled": ["react-patterns", "tailwind-patterns", "postgres-patterns", ...],
+    "disabled": ["flutter-patterns", "mobile-design", ...],
+    "userOverrides": {
+      "force-enabled": [],
+      "force-disabled": []
+    }
+  },
+  "agents": {
+    "disabled": ["mobile-developer", "realtime-specialist", "queue-specialist"]
+  },
+  "futureTechstack": ["react-native", "kubernetes"]
+}
+```
+
+### Step 7: Confirm
+
+```markdown
+## ✅ Workspace Profile Saved!
+
+**File:** `.agent/profile.json`
+
+**Summary:**
+
+- Skills enabled: 15
+- Skills disabled: 8
+- 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/agents
+- Run `/filter` again when project adds new techstack
+```
+
+---
+
+## Output Format
+
+Final result is the `profile.json` file saved to disk.
+
+---
+
+## Exit Conditions
+
+- User confirms and profile is saved successfully
+- User cancels mid-process (no save)
+- Error during analysis (report error, no save)
+
+---
+
+## 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
+
+```
+User: /filter
+
+AI: [Step 1: scan-techstack...]
+    [Step 2: filter-skill...]
+    [Step 3: filter-agent...]
+
+Detected: Next.js 14, TypeScript, Tailwind CSS, Prisma, PostgreSQL
+
+Skills to ENABLE: react-patterns, tailwind-patterns, postgres-patterns
+Skills to DISABLE: flutter-patterns, mobile-design, queue-patterns
+
+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-developer enabled for future use]
+```
+
+### Example 2: Python ML Project
+
+```
+User: /filter
+
+AI: [Analyze workspace...]
+
+Detected: Python 3.11, Poetry, FastAPI, PostgreSQL, OpenAI
+
+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, I also need docker
+
+AI: [Add docker-patterns to enabled]
+    [Keep devops-engineer enabled]
+    [Apply with user customization]
+```
+
+---

package/kits/coder/rules/AGENTS.md

@@ -129,18 +129,39 @@ Agent activated → Check frontmatter `skills:` → Read SKILL.md → Apply.
 ## 🛠️ SKILL LOADING PROTOCOL
 
 ```
-User Request → Skill Description Match → Load SKILL.md → Apply
+User Request → Check Profile → Skill Description Match → Load SKILL.md → Apply
+```
+
+### Profile-Aware Loading
+
+> **CRITICAL:** Before loading any skill or selecting any agent, check `.agent/profile.json`
+
+```
+1. Check if `.agent/profile.json` exists
+2. If EXISTS:
+   - Read skills.enabled[] → Only load these skills
+   - Read skills.disabled[] → Skip these skills
+   - Read agents.disabled[] → Skip these agents
+   - Respect userOverrides.force-enabled/force-disabled
+3. If NOT EXISTS:
+   - All skills/agents are ENABLED by default
+   - Behave as if no filtering is applied
 ```
 
 ### Core Skills (Always Available)
 
+These skills are NEVER disabled regardless of profile:
+
 - `clean-code` - Pragmatic coding standards (used by ALL agents)
 - `testing-patterns` - Testing pyramid, AAA pattern
 - `security-fundamentals` - OWASP 2025
+- `brainstorming` - Socratic questioning protocol
+- `plan-writing` - Task breakdown and WBS
+- `systematic-debugging` - 4-phase debugging
 
 ### Domain Skills (39 total - see ARCHITECTURE.md)
 
-Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-patterns`, `docker-patterns`, `kubernetes-patterns`, `terraform-patterns`, `auth-patterns`, `graphql-patterns`, `redis-patterns`, `realtime-patterns`, `queue-patterns`, `multi-tenancy`, `ai-rag-patterns`, `prompt-engineering`, `monitoring-observability`, `frontend-design`, `mobile-design`, `tailwind-patterns`, `e2e-testing`, `performance-profiling`, `plan-writing`, `systematic-debugging`, `brainstorming`, `github-actions`, `gitlab-ci-patterns`
+Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-patterns`, `docker-patterns`, `kubernetes-patterns`, `terraform-patterns`, `auth-patterns`, `graphql-patterns`, `redis-patterns`, `realtime-patterns`, `queue-patterns`, `multi-tenancy`, `ai-rag-patterns`, `prompt-engineering`, `monitoring-observability`, `frontend-design`, `mobile-design`, `tailwind-patterns`, `e2e-testing`, `performance-profiling`, `github-actions`, `gitlab-ci-patterns`
 
 > 🔴 Full skill list: See `ARCHITECTURE.md` → Skills section