best-practices

Claude Code Plugins by DevNogari

🚀 Essential plugins for Claude Code: Slack notifications, PR review automation, and productivity workflows.

TypeScript | Multi-Plugin Architecture | Auto-Triggered | Production Ready

✨ Features

📢 Slack Notifications

• ✅ Auto-Notification: Automatically triggers when all TodoWrite tasks are completed
• 📦 Repository Context: Shows repo name, branch, and commit hash
• 📊 Rich Formatting: Slack Block Kit with tasks, files, time, and errors
• 🔄 Retry Logic: Automatic retry with exponential backoff
• 🛡️ Non-Blocking: Never interrupts Claude Code workflow
• 🎛️ Highly Configurable: Profile-based settings with flexible templates

🔍 PR Review Automation

• ⚡ 3-Minute Polling: 40% faster feedback cycles (down from 5 minutes)
• 📊 State Tracking: Resumes from last processed feedback, no duplicate work
• 🎯 Priority-Based: Processes CRITICAL → IMPORTANT → NICE-TO-HAVE
• 🤖 Superpower Integration: Uses @superpowers:executing-plans for systematic fixes
• 🔒 Thread-Safe: File locking prevents race conditions

⚙️ Configuration System

• 📝 JSON Config Files: Profile-based settings with XDG Base Directory support
• 🎨 Customizable: Message templates, thresholds, and behavior controls
• 🔀 Multiple Profiles: Personal, team, production, minimal, verbose presets
• ⚙️ Priority Merging: CLI args → env vars → config file → defaults
• 🌍 Environment Override: Quick setup with environment variables

🚀 Quick Start

Installation

Via Plugin Marketplace (Recommended)

# Add marketplace
/plugin marketplace add devnogari/devnogari-claude-plugins

# Install plugin
/plugin install devnogari@devnogari

# Verify installation
/help

You should see /devnogari:slack-notify listed in available commands.

Manual Install (Development)

# Clone repository
git clone https://github.com/devnogari/devnogari-claude-plugins.git
cd devnogari-claude-plugins

# Install and build
npm install && npm run build

# Link plugin to Claude Code
mkdir -p ~/.claude/plugins
ln -s "$(pwd)" ~/.claude/plugins/devnogari

# Verify structure (should see commands/ and skills/ directories)
ls -la ~/.claude/plugins/devnogari

Configuration Setup

Option 1: JSON Config File (Recommended)

1. ./.claude-slack-notify.json (project-level, highest priority)
2. ~/.config/claude-slack-notify/config.json ✅ recommended
3. ~/.claude-slack-notify.json (home directory)
4. ~/.config/claude-code/slack-notify.json (legacy)

# Automatic setup (creates config with example settings)
npm run setup-config

# Manual setup
mkdir -p ~/.config/claude-slack-notify
cp config.example.json ~/.config/claude-slack-notify/config.json
vim ~/.config/claude-slack-notify/config.json

# Or use project-level config
cp config.example.json .claude-slack-notify.json

Verify config location:

# Run with debug to see which config file is loaded
SLACK_NOTIFY_DEBUG=true npm run notify -- --tasks "test"
# Output: [DEBUG] Loaded config from: /Users/you/.config/claude-slack-notify/config.json

Option 2: Environment Variables

# Add to ~/.zshrc or ~/.bashrc
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
export SLACK_NOTIFY_PROFILE="production"  # Optional: select profile

# Reload shell
source ~/.zshrc

Get Slack Webhook: https://api.slack.com/messaging/webhooks

Usage Examples

Manual Notification

# Simple notification
npm run notify -- --tasks "Implemented feature X"

# With profile selection
npm run notify -- --profile team --tasks "Feature merged"

# With all options
npm run notify -- \
  --profile production \
  --channel "#alerts" \
  --tasks "Deploy complete,Tests passing,No errors" \
  --startTime $(date +%s000)

Claude Code Commands

# In Claude Code conversation
/devnogari:slack-notify

# With specific channel (when implementing CLI support)
# /devnogari:slack-notify --channel #team-updates

What Gets Installed

• /devnogari:slack-notify - Send task completion notifications to Slack
• Automatic notification on TodoWrite completion (configurable)
• JSON config file support with multiple profiles
• Repository context tracking (name, branch, commit)

Documentation

• Installation Guide - Detailed setup instructions
• Configuration - Environment variables and profiles
• Usage Guide - Examples and workflows
• API Reference - TypeScript API and types
• Troubleshooting - Common issues and solutions

Project Structure