Bushido
The foundational philosophy and enforcement mechanisms for honorable software development. Contains hooks that enforce the seven virtues, core quality skills, and MCP integrations for maintaining integrity.
Installation
First, install the Han CLI tool:
npm install -g @thebushidocollective/hanThen install the plugin:
han plugin install bushidoOverview
The foundational philosophy and enforcement mechanisms for honorable software development. Contains hooks that enforce the seven virtues, core quality skills, and MCP integrations for maintaining integrity.
Skills
This plugin provides the following skills:
- Baseline Restorer
- Boy Scout Rule
- Code Reviewer
- Orthogonality Principle
- Professional Honesty
- Proof Of Work
- Simplicity Principles
- Solid Principles
- Structural Design Principles
- Test Driven Development
Commands
This plugin provides workflow orchestration commands:
- /agents - Browse and search 30+ specialized DÅ agents for development disciplines
- /skills - Browse and search 100+ skills across all installed plugins
- /feature-dev - 7-phase structured feature development workflow with parallel agent execution
- /review - Multi-agent code review with confidence-based filtering (â¥80% threshold)
- /commit - Smart git commit workflow with validation and conventional commit messages
Usage
Once enabled, Claude will automatically apply these foundational principles and quality practices. The plugin provides:
- Enforcement of software engineering best practices
- Guidance on code quality and maintainability
- Structural design principles and patterns
- Professional development standards
License
Licensed under MIT - see repository for details.
Commands
/architect
Design system architecture and high-level technical strategy
/code-review
Code review a pull request
/debug
Investigate and diagnose issues without necessarily fixing them
/develop
Comprehensive 7-phase workflow for developing new features with quality enforcement
/document
Generate or update documentation for code, APIs, or systems
/explain
Explain code, concepts, or technical decisions in clear, understandable terms
/fix
Debug and fix bugs, errors, or unexpected behavior
/optimize
Optimize code for performance, readability, or efficiency
/plan
Create tactical implementation plan for a feature or task
/refactor
Restructure code to improve quality without changing behavior
/review
Multi-agent code review with confidence-based filtering
/test
Write tests for code using test-driven development principles
Skills
architecture-design
Use when designing system architecture, making high-level technical decisions, or planning major system changes. Focuses on structure, patterns, and long-term strategy.
baseline-restorer
Use when multiple fix attempts fail and you need to systematically restore to a working baseline and reimplement instead of fixing broken code.
boy-scout-rule
Use when modifying existing files, refactoring, improving code quality, or touching legacy code by applying the Boy Scout Rule to leave code better than you found it.
code-reviewer
Use during verification phase when conducting thorough code reviews and providing constructive feedback based on universal software quality principles.
debugging
Use when investigating bugs, diagnosing issues, or understanding unexpected behavior. Provides systematic approaches to finding root causes.
documentation
Use when creating or updating documentation including READMEs, API docs, inline comments, or technical guides. Focuses on clarity and usefulness for the intended audience.
explainer
Use when explaining code, technical concepts, or implementation decisions. Provides structured approach to creating clear, understandable explanations tailored to the audience.
orthogonality-principle
Use when designing modules, APIs, and system architecture requiring independent, non-overlapping components where changes in one don't affect others.
performance-optimization
Use when optimizing code for performance, reducing bundle size, improving load times, or fixing performance bottlenecks. Emphasizes measurement-driven optimization.
professional-honesty
Use when responding to questions or providing information requiring professional honesty and directness over excessive agreeableness.
proof-of-work
Use automatically during development workflows when making claims about tests, builds, verification, or code quality requiring concrete evidence to ensure trust through transparency.
refactoring
Use when restructuring code to improve quality without changing external behavior. Emphasizes safety through tests and incremental changes.
simplicity-principles
Use when designing solutions, adding features, or refactoring by applying KISS, YAGNI, and Principle of Least Astonishment to write simple, predictable code.
solid-principles
Use during implementation when designing modules, functions, and components requiring SOLID principles for maintainable, flexible architecture.
structural-design-principles
Use when designing modules and components requiring Composition Over Inheritance, Law of Demeter, Tell Don't Ask, and Encapsulation principles that transcend programming paradigms.
technical-planning
Use when creating implementation plans for features or tasks. Focuses on tactical execution planning with clear tasks, dependencies, and success criteria.
Hooks
SessionStart
Runs when Claude Code starts a new session or resumes an existing session.
cat "${CLAUDE_PLUGIN_ROOT}/hooks/agent-bushido.md"cat "${CLAUDE_PLUGIN_ROOT}/hooks/no-time-estimates.md"Referenced Files:
UserPromptSubmit
Runs when the user submits a prompt, before Claude processes it.
cat "${CLAUDE_PLUGIN_ROOT}/hooks/ensure-subagent.md"cat "${CLAUDE_PLUGIN_ROOT}/hooks/ensure-skill-use.md"