guardian

Claude Code Plugins

Personal collection of Claude Code plugins for development workflows, extracted from real-world projects and designed for reusability across codebases.

Table of Contents

• Overview
• Quick Start
• Available Plugins
• Configuration Philosophy
• Plugin Comparison
• Installation Guide
• Usage Examples
• Continuous Integration
• Development
• Architecture
• Contributing
• License

Overview

This repository serves as a local plugin marketplace for Claude Code, containing four production-ready plugins that enhance development workflows:

1. bash-guard - Safety enforcement for shell commands
2. format-and-lint - Automated code quality checks
3. guardian - Test verification and quality gates
4. development-agents - Specialized AI agents for development tasks

All plugins were extracted from the family-assistant and websidian projects, refactored for reusability, and enhanced with comprehensive configuration systems.

Why These Plugins?

These plugins solve real development workflow challenges:

• Prevent mistakes before they happen (bash-guard)
• Maintain code quality automatically (format-and-lint)
• Enforce testing discipline without manual checking (guardian)
• Delegate specialized tasks to focused agents (development-agents)

Quick Start

1. Add the Marketplace

# Local path (for development)
/plugin marketplace add /data/ssd/sync/workspace/src/claude-code-plugins

# Or from git remote
/plugin marketplace add https://github.com/your-username/claude-code-plugins

2. Install Plugins

# Install all plugins
/plugin install bash-guard@werdnum-plugins
/plugin install format-and-lint@werdnum-plugins
/plugin install guardian@werdnum-plugins
/plugin install development-agents@werdnum-plugins

# Or browse and install interactively
/plugin

3. Verify Installation

/plugin list

4. Bootstrap Configuration (Recommended)

Use the /bootstrap-plugins command to automatically configure all plugins:

/bootstrap-plugins

This command will:

• Auto-detect your project type and characteristics
• Ask a few critical configuration questions
• Generate optimal configurations for all plugins
• Set up the marketplace in .claude/settings.json

5. Manual Configuration (Alternative)

If you prefer manual setup, each plugin works out of the box with sensible defaults. To customize:

# Create project-specific config
mkdir -p .claude
echo '{"bannedCommands": {"enabled": true}}' > .claude/bash-guard.json

# Or create global config
mkdir -p ~/.config/claude-code
echo '{"linting": {"enabled": true}}' > ~/.config/claude-code/format-lint.json

Available Plugins

bash-guard

Category: Safety & Protection Hook Type: PreToolUse (Bash) Configuration: bash-guard.json

Prevents dangerous shell commands from executing and enforces best practices. Supports automatic command rewriting and timeout enforcement with suggestion-based feedback.

Key Features:

• Block dangerous commands (rm -rf /, fork bombs, etc.)
• Prevent commits to protected branches (main/master)
• Enforce minimum timeouts for long-running commands
• Block specific commands from running in background
• Auto-fix/Suggestion mode: Suggest command rewrites and timeout adjustments
• Command replacement: Transform problematic commands into safer alternatives

Use Cases:

• Prevent accidental system damage
• Enforce git workflow conventions
• Ensure adequate test timeouts
• Project-specific command restrictions

Full Documentation →

---

format-and-lint

Category: Code Quality Hook Type: PostToolUse (Edit/Write) Configuration: format-lint.json

Automatically format and lint code after edits, providing immediate feedback on code quality issues.

Key Features:

• Python: ruff format, ruff check, basedpyright, ast-grep
• TypeScript/JavaScript: prettier, eslint
• Angular: prettier, eslint for .ts/.html/.css
• File formatters: ensure newline at EOF, trim whitespace
• Informational only (doesn't block)

Use Cases:

• Maintain consistent code style
• Catch type errors immediately
• Enforce project-specific patterns (ast-grep)
• Multi-language projects

Full Documentation →

---

guardian

Category: Quality Gates Hook Types: PreToolUse (Bash), Stop Configuration: guardian.json

Ensures code quality through test verification, pre-commit workflows, and completion validation.