asepharyana
e513cddd68
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.
3.5 KiB
3.5 KiB
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
# 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)
# 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-codeactivates - "Write a test for this" →
testingactivates - "Design an API endpoint" →
api-designactivates - Working with
.tsfiles →typescriptactivates - Project with
Cargo.toml→rustactivates (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 —
nameanddescriptionwith 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.