feat(hub-guide): expand plugin with 26 best-practice skills, hooks, and references

Transform hub-guide from a single-skill Hub monorepo guide into a
comprehensive programming best-practice plugin covering all situations.

Skills (26):
- Core: engineering-principles, clean-code, clean-architecture,
  design-patterns, testing, error-handling, security, api-design,
  git-workflow, documentation, logging-observability, performance
- Languages: typescript, python, rust, go
- Frameworks: react-frontend, elysiajs, hono-backend, drizzle-database, nextjs
- Infrastructure: docker, ci-cd, monitoring
- Monorepo: monorepo, hub-guide (existing)

Hooks:
- SessionStart: auto-detect project type and activate relevant skills
- PreToolUse (Write|Edit): inject language-specific rules per file type

Reference files for deep dives:
- clean-architecture/references/solid.md (SOLID + component principles)
- design-patterns/references/catalog.md (full GoF catalog with examples)
- testing/references/mocks.md (test double taxonomy)

Restructure plugin to modern skills/ directory format.

hooks/scripts/detect-file-type.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# hub-guide: detect file extension from tool input and suggest language-specific rules
+# Runs before Write/Edit to inject best-practice context
+
+TOOL_INPUT="$1"
+
+# Extract file path from tool input (looks for "file_path" in JSON)
+FILE_PATH=$(echo "$TOOL_INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+EXT="${FILE_PATH##*.}"
+
+case "$EXT" in
+  ts|tsx)
+    echo "📐 [hub-guide] TypeScript file — apply typescript skill rules (strict types, no-any, proper generics)"
+    ;;
+  py)
+    echo "📐 [hub-guide] Python file — apply python skill rules (type hints, PEP 8, no wildcard imports)"
+    ;;
+  rs)
+    echo "📐 [hub-guide] Rust file — apply rust skill rules (ownership, error handling, clippy clean)"
+    ;;
+  go)
+    echo "📐 [hub-guide] Go file — apply go skill rules (idiomatic Go, interfaces, error handling)"
+    ;;
+  js|jsx)
+    echo "📐 [hub-guide] JavaScript file — apply typescript skill rules (ESM, modern JS)"
+    ;;
+  dockerfile|Dockerfile)
+    echo "📐 [hub-guide] Dockerfile — apply docker skill rules (multi-stage, minimal layers, no root)"
+    ;;
+  yml|yaml)
+    echo "📐 [hub-guide] YAML file — check ci-cd and docker skill rules"
+    ;;
+esac

hooks/scripts/detect-project.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+# hub-guide: detect project type and suggest relevant skills
+# Runs at SessionStart to prime best-practice skills
+
+PROJECT_DIR="$(pwd)"
+SKILLS=""
+
+# Helper: check if a package.json field contains a dependency name
+has_dep() {
+  local name="$1"
+  grep -q "\"$name\"" package.json 2>/dev/null
+}
+
+# Monorepo indicators
+if [ -f "pnpm-workspace.yaml" ] || [ -f "lerna.json" ] || [ -f "nx.json" ] || [ -f "rush.json" ] || [ -f "turborepo.json" ]; then
+  SKILLS="$SKILLS, monorepo"
+fi
+
+# TypeScript / JavaScript
+if [ -f "tsconfig.json" ] || [ -f "jsconfig.json" ]; then
+  SKILLS="$SKILLS, typescript"
+  # Framework detection from package.json dependencies
+  if has_dep "next";    then SKILLS="$SKILLS, nextjs"; fi
+  if has_dep "elysia";  then SKILLS="$SKILLS, elysiajs"; fi
+  if has_dep "hono";    then SKILLS="$SKILLS, hono-backend"; fi
+  if has_dep "drizzle-orm"; then SKILLS="$SKILLS, drizzle-database"; fi
+fi
+
+# React (detect even without tsconfig)
+if [ -f "vite.config.ts" ] || [ -f "vite.config.js" ] || has_dep "react" 2>/dev/null; then
+  # avoid double-adding if already caught by typescript block
+  case "$SKILLS" in *react-frontend*) ;; *) SKILLS="$SKILLS, react-frontend" ;; esac
+fi
+
+# Next.js config file — catches JS-only projects too
+if [ -f "next.config.js" ] || [ -f "next.config.ts" ] || [ -f "next.config.mjs" ]; then
+  case "$SKILLS" in *nextjs*) ;; *) SKILLS="$SKILLS, nextjs" ;; esac
+fi
+
+# Python
+if [ -f "pyproject.toml" ] || [ -f "setup.py" ] || [ -f "setup.cfg" ] || [ -f "requirements.txt" ] || [ -f "Pipfile" ] || [ -f "poetry.lock" ] || [ -f "uv.lock" ]; then
+  SKILLS="$SKILLS, python"
+fi
+
+# Rust
+if [ -f "Cargo.toml" ]; then
+  SKILLS="$SKILLS, rust"
+fi
+
+# Go
+if [ -f "go.mod" ]; then
+  SKILLS="$SKILLS, go"
+fi
+
+# Docker
+if [ -f "Dockerfile" ] || [ -f "docker-compose.yml" ] || [ -f "compose.yml" ] || ls Dockerfile.* 2>/dev/null | grep -q .; then
+  SKILLS="$SKILLS, docker"
+fi
+
+# CI/CD
+if [ -d ".github/workflows" ] || [ -f ".gitlab-ci.yml" ] || [ -f "Jenkinsfile" ] || [ -f "bitbucket-pipelines.yml" ]; then
+  SKILLS="$SKILLS, ci-cd"
+fi
+
+# Always-active core skills (loaded every session)
+CORE="engineering-principles, clean-code, clean-architecture, testing, error-handling, security, git-workflow, api-design"
+
+SKILLS="${SKILLS#, }"  # strip leading ", "
+
+echo "📐 [hub-guide] detected: ${PROJECT_DIR}"
+echo "📐 [hub-guide] core skills: ${CORE}"
+if [ -n "$SKILLS" ]; then
+  echo "📐 [hub-guide] project-specific: ${SKILLS}"
+fi
+echo "📐 [hub-guide] Apply these best-practice rules throughout this session."