jutsu-runbooks

Han

A curated marketplace of Claude Code plugins that embody the principles of ethical and professional software development.

What is Han?

Han (藩 - domain/clan) is a marketplace of Claude Code plugins built on the foundation of the seven Bushido virtues. Each plugin helps you write better code through skills, agents, validation hooks, and external integrations.

The marketplace is organized around Japanese martial arts philosophy:

• Bushido (武士道) - The core principles and quality standards
• Jutsu (術) - Techniques: Language and tool skills with validation hooks
• Dō (道) - The Way: Specialized agents for development disciplines
• Hashi (橋) - Bridges: MCP servers providing external integrations

The Seven Virtues

The Bushido Code guides every plugin in this marketplace:

1. Honesty (誠) - Write code with clarity and transparency
2. Respect (礼) - Honor those who came before and those who will follow
3. Courage (勇) - Do the right thing, even when difficult
4. Compassion (同情) - Write with empathy for users and developers
5. Loyalty (忠誠) - Stay committed to quality and continuous improvement
6. Discipline (自制) - Master your tools and craft
7. Justice (正義) - Make fair decisions that serve the greater good

Getting Started

Automatic Installation (Recommended)

Use the han CLI tool to automatically detect and install appropriate plugins:

Important: Han must be installed globally for hooks to work. Hooks run validation commands (tests, linting, etc.) when you stop working, and they require han to be available in your PATH. Using npx will install plugins but hooks will not function.

# Install globally (REQUIRED for hooks)
npm install -g @thebushidocollective/han

# Then install plugins
han plugin install --auto

For other installation methods (Homebrew, curl, manual download), visit han.guru.

The installer will:

• Analyze your codebase using Claude Agent SDK
• Detect languages, frameworks, and testing tools
• Detect git hosting platform (GitHub/GitLab)
• Recommend appropriate plugins
• Configure .claude/settings.json automatically

Via Claude Code /plugin Command

Use Claude Code's built-in plugin command to add the marketplace:

/plugin marketplace add thebushidocollective/han

Then install individual plugins:

/plugin install bushido@han
/plugin install jutsu-typescript@han

Note: For hooks to work, you must also install han globally and ensure it's in your PATH. See Automatic Installation above.

Manual Installation

Add the Han marketplace to your Claude Code settings (.claude/settings.json):

{
  "extraKnownMarketplaces": {
    "han": {
      "source": {
        "source": "github",
        "repo": "thebushidocollective/han"
      }
    }
  },
  "enabledPlugins": {
    "bushido@han": true
  }
}

Then browse available plugins using Claude Code's plugin interface.

Note: For hooks to work, you must also install han globally and ensure it's in your PATH. See Automatic Installation above.

Plugin Categories

🎯 Bushido (Core)

The foundational plugin containing the seven virtues, enforcement hooks, and core quality skills.

Always install this first - it provides the philosophical foundation and universal quality principles (SOLID, TDD, Boy Scout Rule, etc.).

⚔️ Jutsu (Techniques)

Language and tool plugins that provide validation hooks for your development workflow.

Categories:

• Testing Frameworks - Jest, Mocha, Vitest, Pytest, RSpec, Cypress, JUnit, TestNG
• Linting & Formatting - ESLint, Biome, Prettier, Pylint, RuboCop, Clippy, Checkstyle, Markdownlint
• Language-Specific - TypeScript, Go, Rust, Elixir, Crystal, Swift, Kotlin, Scala, and more

Each jutsu plugin includes validation hooks that run on Stop and SubagentStop events, ensuring code quality before you continue.

Browse all jutsu plugins: Check the /jutsu directory in this repository.

🛤️ Dō (The Way)

Specialized agents focused on development disciplines and practices.

Disciplines include:

• Frontend, Backend, Infrastructure
• Security, Quality, Documentation
• Architecture, Product Management
• AI Collaboration and more

Browse all dō plugins: Check the /do directory in this repository.

🌉 Hashi (Bridges)

MCP servers that provide external knowledge and integrations.

Examples:

• Library documentation
• API references
• External service integrations

Browse all hashi plugins: Check the /hashi directory in this repository.

Using the Han CLI

Reminder: Han must be installed globally for hooks to work. See han.guru for installation instructions.

Install Plugins

# Interactive mode - browse and select plugins
han plugin install

# Auto-detect mode - AI analyzes codebase
han plugin install --auto