asepharyana
bc9a88328d
- Replace SessionStart command hook with plugin.json's native sessionStart.skill field (like Superpowers' using-superpowers pattern) - engineering-principles skill auto-loads at every session start - Remove hooks/session-start, hooks/run-hook.cmd scripts - Remove obsolete setup-hooks.sh (references deleted scripts) - Empty hooks.json — hooks not needed, skill auto-load handles it
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
| 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) |
Skills activate automatically when Claude detects relevant context (language, framework, topic).
Hooks for Auto-Activation
| Hook | Trigger | What It Does |
|---|---|---|
| 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
# From anywhere with access to the plugin directory
./install.sh
# Or symlink (edits in this repo are live)
./install.sh --link
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
Structure
code-guide/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── hooks/
│ └── hooks.json # Hook configuration (Stop prompt)
├── skills/
│ ├── clean-code/ # 23 more skill directories
│ └── ...
└── README.md
Development
Skills are in skills/<name>/SKILL.md format (modern Claude Code plugin convention). Each skill includes:
- Frontmatter —
nameanddescriptionwith trigger context - Lean body — key rules, examples, and anti-patterns
The Stop hook injects reminders when mandatory skills aren't being applied.