bh

BrightHills Claude Code Plugin Marketplace

Internal Claude Code plugin marketplace for BrightHills.

Plugins

bh — General-purpose tools

Component	Type	Invocation	Description
session	command	/bh:session	Create session summaries to preserve development context before /compact, or organize existing session files into a year/month/day hierarchy with --organize.
hook-logger	hook	(auto-active)	Logs all Claude Code hook events (PreToolUse, PostToolUse, Stop, SessionStart, SessionEnd, etc.) to .claude/hook_logs/{event}.jsonl for debugging and analytics.

bh-agile — Agile toolkit

Component	Type	Invocation	Description
story-writer	skill	/bh-agile:story-writer	Write professional Agile Epics, Stories, and Tasks following vertical slice principles with Given-When-Then acceptance criteria.
implement	skill	/bh-agile:implement	Implement a feature from a ticket (#45) or local documentation (@docs/features/auth/) with structured phases, quality gates, and optional ticket administration.
plan-feature	skill	/bh-agile:plan-feature	Plan a new feature through service design discovery and expert agent consultation. Generates feature documentation in docs/features/.
create-tickets	skill	/bh-agile:create-tickets	Create Epic, Stories, and Tasks in the issue tracker from feature documentation or structured input.
code-review	skill	/bh-agile:code-review	Review code for DRY, SOLID, and Clean Code violations. Also used during implement Phase 3.5.
setup	command	/bh-agile:setup	Project setup wizard: explores codebase, generates clean-code rules from skeletons, copies static rules, creates issue tracking labels (GitHub/GitLab), and generates a platform-specific ticket manager agent.
agile-ticket-manager	agent template	(generated by setup)	Manages Epic/Story/Task hierarchy with status propagation. Generated into .claude/agents/ with platform-specific commands (gh/glab).
qa-tester	agent	(auto-discovered)	Plans, creates, and executes E2E tests based on Story Acceptance Criteria. Analyzes AC to create test plans, writes test code, runs tests, and reports results.
security-auditor	agent	(auto-discovered)	Performs comprehensive security audits focusing on OWASP Top 10 vulnerabilities, data leakage, authentication flows, and sensitive data exposure.

Workflow integration:

/plan-feature "auth system"  →  docs/features/auth/
/create-tickets @docs/features/auth/  →  Epic #1, Stories #2-#5
/implement #2  OR  /implement @docs/features/auth/  →  Implementation

Additional resources in plugin:

Resource	Path	Purpose
Rule skeletons	assets/rules/skeletons/	Instructions for generating project-specific rules (e.g., clean-code)
Static rules	assets/rules/	Pre-built rules copied with path customization (e.g., feature-docs)
Agent template	assets/agents/	Agent template with placeholder-based assembly
Agent fragments	assets/agents/fragments/{github,gitlab}/	Platform-specific command snippets for template assembly

bh-statusline — Custom status line

Component	Type	Invocation	Description
setup	command	/bh-statusline:setup	Install the BrightHills custom status line script (~/.claude/statusline-command.sh) and configure Claude Code to use it. Checks for existing configuration and asks before overwriting.

Displays: Model | Git branch | Context left [████░░░░░░] 72% | Directory | Output style

• Context progress bar color changes: green (>40%), yellow (>20%), red (<=20%)
• Uses Claude Code's pre-calculated remaining_percentage for accuracy
• Requires jq

Naming convention

All BrightHills skills use the bh prefix. Scoped skills use bh-<scope>:

• General: /bh:skill-name
• Agile: /bh-agile:skill-name

Installation

1. Add the marketplace

/plugin marketplace add https://github.com/brighthills/brighthills-cc-plugins.git

2. Install plugins

/plugin install bh@brighthills-cc-plugins-public
/plugin install bh-agile@brighthills-cc-plugins-public
/plugin install bh-statusline@brighthills-cc-plugins-public

3. Run setup commands