GoodVibes Plugin for Claude Code

A comprehensive automation plugin that supercharges Claude Code with intelligent context injection, persistent memory, smart error recovery, automated quality gates, and a library of 170+ development skills.

Plug in. Receive good vibes.

---

What's Inside

| Category | Count | Description | |----------|-------|-------------| | Skills | 172 | Production-ready patterns for frameworks, libraries, and tools | | MCP Tools | 91 | Code intelligence, validation, and automation tools | | Agents | 11 | Specialized AI agents for different development domains | | Hooks | 12 | Lifecycle automation for sessions, tools, and agents | | Output Styles | 2 | Autonomous development modes | | Templates | 3 | Project scaffolding templates |

---

Table of Contents

• Features
• Installation
• Quick Start
• MCP Tools
• Hook Events
• Skills Library
• Agents
• Slash Commands
• Output Styles
• Project Templates
• Configuration
• Memory System
• Directory Structure
• Development
• License

---

Features

Smart Context Injection

Automatically injects project context at session start:

• Stack Detection - Identifies frameworks, languages, and tools (Next.js, Vite, TypeScript, etc.)
• Git Context - Current branch, uncommitted changes, recent commits
• Environment Status - Missing env vars, .env file presence
• Project Health - node_modules status, lockfile issues, TypeScript config
• TODO Scanner - Finds TODOs/FIXMEs in codebase
• Recent Activity - Hotspots, recently modified files
• Port Checker - Active dev servers on common ports

Persistent Memory System

Cross-session memory stored in .goodvibes/memory/:

| File | Purpose | |------|---------| | decisions.md | Architectural decisions and rationale | | patterns.md | Code patterns and conventions discovered | | failures.md | Past failures and solutions | | preferences.md | User preferences learned |

Smart Error Recovery

3-phase error recovery with escalating research:

1. Phase 1 - Fix attempts with existing knowledge
2. Phase 2 - Search official documentation
3. Phase 3 - Search community solutions (Stack Overflow, GitHub)

Pre-Commit Quality Gates

Automatic quality checks before commits:

• TypeScript type checking
• ESLint with auto-fix
• Prettier formatting
• Test runner integration

Subagent Telemetry

Comprehensive tracking of subagent activity:

• Start/stop timestamps and duration
• Task descriptions and outcomes
• Keyword extraction from transcripts
• Monthly JSONL telemetry logs

Auto-Checkpoint Commits

Automatic checkpoint commits based on:

• File modification count thresholds
• Time intervals
• Agent completion events

Crash Recovery

Detects unclean session terminations and provides recovery context.

---

Installation

From Plugin Marketplace

# Add the marketplace
claude plugin marketplace add mgd34msu/goodvibes-plugin

# Install the plugin
claude plugin install goodvibes@goodvibes-market

Manual Installation

# Clone the repository
git clone https://github.com/mgd34msu/goodvibes.sh vibeplug
cd vibeplug

# Install for current project
claude plugin install ./plugins/goodvibes --scope project

# Or install user-wide
claude plugin install ./plugins/goodvibes --scope user

Build from Source

cd plugins/goodvibes

# Install dependencies and build everything
npm install
npm run build

# Or build components individually:
npm run build:registries    # Build skill/agent/tool registries
npm run build:server        # Build MCP server
npm run build:hooks         # Build hook scripts

---

Quick Start

Once installed, GoodVibes automatically enhances your Claude Code sessions:

1. Start a session - Context is automatically injected
2. Use slash commands - /goodvibes:search, /goodvibes:load-skill, /goodvibes:plugin-status
3. Let agents help - Specialists are available for backend, frontend, testing, and more
4. Enable output styles - Try vibecoding or justvibes for autonomous development

---

MCP Tools

GoodVibes provides 91 MCP tools organized into categories:

Discovery & Search (7 tools)

| Tool | Description | |------|-------------| | search_skills | Search skill registry by keyword | | search_agents | Search agent registry by expertise | | search_tools | Search available tools | | recommend_skills | Analyze task and recommend relevant skills | | get_skill_content | Load full skill content by path | | get_agent_content | Load full agent content by path | | skill_dependencies | Show skill relationships and dependencies |

Context Gathering (6 tools)

| Tool | Description | |------|-------------| | detect_stack | Analyze project technology stack | | check_versions | Get installed package versions | | scan_patterns | Identify code patterns and conventions | | fetch_docs | Fetch library documentation | | read_config | Parse configuration files (JSON, YAML, JS, TS) | | get_conventions | LLM-powered convention analysis |

Schema & API (5 tools)

| Tool | Description | |------|-------------| | generate_openapi | Generate OpenAPI spec from routes | | get_schema | Introspect database schema | | get_database_schema | Auto-detect and extract DB schema | | get_api_routes | Extract API routes from frameworks | | get_prisma_operations | Find Prisma usages and N+1 patterns |

LSP Code Navigation (18 tools)

| Tool | Description | |------|-------------| | find_references | Find all references to symbol | | go_to_definition | Go to symbol definition | | get_implementations | Find interface implementations | | rename_symbol | Get edits for safe rename | | get_code_actions | Get quick fixes and refactorings | | apply_code_action | Get file edits for code action | | get_symbol_info | Get detailed symbol information | | get_call_hierarchy | Get call hierarchy (incoming/outgoing) | | get_type_hierarchy | Get type inheritance hierarchy | | get_document_symbols | Get structural outline of document | | get_signature_help | Get signature help at call site | | get_diagnostics | Get TypeScript diagnostics | | find_dead_code | Find unused exports and functions | | get_api_surface | Analyze public vs internal API | | safe_delete_check | Confirm zero external usages | | get_inlay_hints | Get inferred types where implicit | | workspace_symbols | Search symbols across workspace | | semantic_diff | LLM-powered type-aware diff |

Frontend Analysis (11 tools)

| Tool | Description | |------|-------------| | get_react_component_tree | Build React component hierarchy | | analyze_stacking_context | Analyze z-index and stacking contexts | | analyze_responsive_breakpoints | Analyze Tailwind responsive classes | | trace_component_state | Trace React state through component trees | | analyze_render_triggers | Analyze React re-render causes | | analyze_layout_hierarchy | Analyze CSS layout hierarchy | | diagnose_overflow | Diagnose CSS overflow issues | | get_accessibility_tree | Build a11y tree and detect WCAG issues | | get_sizing_strategy | Analyze element sizing strategy | | analyze_event_flow | Analyze event handling and propagation | | analyze_tailwind_conflicts | Detect conflicting Tailwind classes |

Validation & Testing (7 tools)

| Tool | Description | |------|-------------| | validate_implementation | Check code matches skill patterns | | run_smoke_test | Quick verification of generated code | | check_types | Run TypeScript type checking | | validate_edits_preview | Preview edit impact before applying | | find_tests_for_file | Find tests covering a source file | | get_test_coverage | Parse test coverage reports | | suggest_test_cases | LLM-powered test case suggestions |

Error & Debugging (4 tools)

| Tool | Description | |------|-------------| | parse_error_stack | Parse and analyze error stacks | | explain_type_error | Explain TS errors with fixes | | detect_memory_leaks | Monitor memory usage for leaks | | log_analyzer | Analyze logs for patterns and anomalies |

Dependency Analysis (3 tools)

| Tool | Description | |------|-------------| | analyze_dependencies | Find unused/missing/outdated packages | | find_circular_deps | Detect circular import dependencies | | detect_breaking_changes | LLM-powered breaking change detection |

Security (2 tools)

| Tool | Description | |------|-------------| | scan_for_secrets | Scan for credentials and sensitive data | | check_permissions | Analyze file/network/system access |

Environment & Package (4 tools)

| Tool | Description | |------|-------------| | get_env_config | Find all env variable usages | | validate_env_complete | Validate env vars complete and documented | | upgrade_package | Upgrade npm package with breaking change detection | | query_database | Execute SQL queries (PostgreSQL, MySQL, SQLite) |

Build & Performance (2 tools)

| Tool | Description | |------|-------------| | analyze_bundle | Analyze bundle size and tree-shaking | | profile_function | Profile function performance |

Process Management (3 tools)

| Tool | Description | |------|-------------| | start_dev_server | Start dev server and return when ready | | health_monitor | Monitor URL endpoint health | | watch_for_errors | Monitor logs for errors |

Runtime Verification (4 t