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.

README.md

@@ -1,2 +1,100 @@
-# asepharyana-hub-hub-guide
-Claude Code plugin — hub guide for Asepharyana Hub monorepo
+# hub-guide — Comprehensive Programming Best-Practice Plugin
+
+A Claude Code plugin serving as a complete engineering guide for **all programming situations** — monorepo, standalone, any language, any framework.
+
+## Features
+
+### 🧠 24 Best-Practice Skills
+
+| Category | Skills |
+|----------|--------|
+| **Core Engineering** | 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 (patterns + submodules + workspace tooling) |
+| **Hub-specific** | hub-guide (Asepharyana Hub monorepo infra & workflow) |
+
+Skills activate automatically when Claude detects relevant context (language, framework, topic).
+
+### ⚡ Hooks for Auto-Detection
+
+| Hook | Trigger | What It Does |
+|------|---------|--------------|
+| **SessionStart** | Session begins | Detects project type from files (package.json, Cargo.toml, go.mod, etc.) and activates relevant skills |
+| **PreToolUse** | Before Write/Edit | Detects file extension and injects language-specific best-practice rules |
+
+## Installation
+
+### As a Claude Code Plugin
+
+```bash
+# Link for development (edits take effect immediately)
+ln -s /path/to/hub-guide ~/.claude/plugins/hub-guide
+
+# Or copy
+cp -r /path/to/hub-guide ~/.claude/plugins/hub-guide
+```
+
+### Manual Install (skills only)
+
+```bash
+# Copy individual skills
+cp -r skills/<skill-name> ~/.claude/skills/<skill-name>
+```
+
+## Usage
+
+Skills are **auto-triggered** — Claude loads them when you mention relevant topics or work with matching file types.
+
+Example triggers:
+- *"Refactor this function"* → `clean-code` activates
+- *"Write a test for this"* → `testing` activates
+- *"Design an API endpoint"* → `api-design` activates
+- Working with `.ts` files → `typescript` activates
+- Project with `Cargo.toml` → `rust` activates (SessionStart hook)
+
+## Auto-Detection (Hooks)
+
+When you start a session in a project, the SessionStart hook scans for:
+
+| File | Skills Activated |
+|------|-----------------|
+| `tsconfig.json` | typescript, react-frontend, elysiajs, hono-backend, drizzle-database |
+| `Cargo.toml` | rust |
+| `go.mod` | go |
+| `pyproject.toml` | python |
+| `pnpm-workspace.yaml` | monorepo |
+| `Dockerfile` | docker |
+| `.github/workflows/` | ci-cd |
+
+## Structure
+
+```
+hub-guide/
+├── .claude-plugin/
+│   └── plugin.json          # Plugin manifest
+├── hooks/
+│   ├── hooks.json           # Hook configuration
+│   └── scripts/
+│       ├── detect-project.sh    # SessionStart auto-detection
+│       └── detect-file-type.sh  # PreToolWrite language detection
+├── skills/
+│   ├── clean-code/          # +23 more skill directories
+│   ├── ...
+│   └── hub-guide/           # Existing hub monorepo guide
+└── README.md
+```
+
+## Development
+
+Skills are in `skills/<name>/SKILL.md` format (modern Claude Code plugin convention). Each skill includes:
+
+- **Frontmatter** — `name` and `description` with specific trigger phrases
+- **Lean body** — key rules, examples, and anti-patterns (~1500-2000 words)
+
+Hooks use bash scripts. Edits to hooks/scripts/ take effect immediately when installed as a symlink.
+
+## Related
+
+Based on patterns from [kana-best-practice-engineering](https://github.com/asepharyana/kana-best-practice-engineering).