Files

T

asepharyana 95c77c694f fix(hooks): restore Superpowers-style SessionStart command hook

Properly follow Superpowers 6.1.1 pattern:
- SessionStart command hook (type: command) runs run-hook.cmd session-start
- run-hook.cmd is a cross-platform polyglot wrapper (Unix/Windows)
- session-start script reads engineering-principles/SKILL.md and injects
  it as additionalContext wrapped in EXTREMELY_IMPORTANT tags
- The 29 engineering principles are active in context from turn 1

plugin.json: remove sessionStart.skill, keep skills: ./skills/
The command hook is the primary mechanism (just like Superpowers' using-superpowers).

2026-07-26 14:24:52 +07:00

2.7 KiB

Raw Blame History

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.

SessionStart Hook

A SessionStart command hook (identical to Superpowers' pattern) injects the full engineering-principles skill content into context at every session start — all 29 principles covering correctness, YAGNI, KISS, DRY, never assume (show evidence), never suppress lints, root-cause fixes, and more. These rules are active from turn 1.

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-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

Structure

code-guide/
├── .claude-plugin/
│   └── plugin.json           # Plugin manifest
├── hooks/
│   ├── hooks.json            # SessionStart command hook config
│   ├── run-hook.cmd          # Cross-platform polyglot wrapper
│   └── session-start         # Injects engineering-principles into context
├── skills/
│   ├── engineering-principles/  # Auto-injected at session start
│   ├── clean-code/
│   ├── ...
└── README.md

How It Works

SessionStart hook runs hooks/run-hook.cmd session-start which reads skills/engineering-principles/SKILL.md and injects it into the conversation context wrapped in <EXTREMELY_IMPORTANT> tags (same pattern as Superpowers' using-superpowers).
All 24 skills are auto-discovered from the skills/ directory.
Skills activate when Claude detects relevant context — no manual commands needed.

2.7 KiB Raw Blame History