MythEclipse/asepharyana-hub-guide
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

refactor: rename hub-guide → code-guide, remove project-specific content

Browse Source 
- Rename all references from hub-guide to code-guide
- Remove project-specific hub-guide skill (100% Asepharyana Hub specific)
- Genericize examples in monorepo, docker, ci-cd, engineering-principles skills
- Use generic service names (frontend, api, worker instead of hub, scraper)
- Use generic registry paths instead of ghcr.io/asepharyana/asepharyana-hub
- Remove project-specific deployment and infrastructure references
This commit is contained in:
asepharyana
2026-07-26 12:28:25 +07:00
parent fa2f1fe838
commit 8bcccfc022
9 changed files with 71 additions and 257 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+14 -42
View File
@@ -1,10 +1,10 @@
# hub-guide — Comprehensive Programming Best-Practice Plugin
# code-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
### 24 Best-Practice Skills
| Category | Skills |
|----------|--------|
@@ -13,27 +13,21 @@ A Claude Code plugin serving as a complete engineering guide for **all programmi
| **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
### Hooks for Auto-Activation
| 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 |
| **Stop** | Before stopping | Verifies mandatory skills are being applied (engineering-principles, clean-code, clean-architecture, testing, error-handling, security, git-workflow, api-design) |
## Installation
### Quick Install
```bash
# Clone
git clone https://github.com/asepharyana/asepharyana-hub-hub-guide.git
cd asepharyana-hub-hub-guide
# Install as one unit (recommended)
# From anywhere with access to the plugin directory
./install.sh
# Or symlink (edits in this repo are live)
@@ -49,37 +43,19 @@ Example triggers:
- *"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 |
- Project with `Cargo.toml` → `rust` activates
## Structure
```
hub-guide/
code-guide/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
│ └── plugin.json # Plugin manifest
├── hooks/
│ ├── hooks.json # Hook configuration
│ └── scripts/
│ ├── detect-project.sh # SessionStart auto-detection
│ └── detect-file-type.sh # PreToolWrite language detection
│ └── hooks.json # Hook configuration (Stop prompt)
├── skills/
│ ├── clean-code/ # +23 more skill directories
│ ├── ...
│ └── hub-guide/ # Existing hub monorepo guide
│ ├── clean-code/ # 23 more skill directories
│ └── ...
└── README.md
```
@@ -87,11 +63,7 @@ hub-guide/
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)
- **Frontmatter** — `name` and `description` with trigger context
- **Lean body** — key rules, examples, and anti-patterns
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).
The Stop hook injects reminders when mandatory skills aren't being applied.