🎯

goodvibes-codebase-review

🎯Skill

from mgd34msu/goodvibes-plugin

What it does

Reviews and analyzes a software project's codebase, identifying potential quality issues, architectural patterns, code complexity, and improvement opportunities across multiple dimensions.

📦

Part of

mgd34msu/goodvibes-plugin(7 items)

goodvibes-codebase-review

Installation

Server ConfigurationMCP server configuration block

{
  "hooks": [
    {
      "name": "SessionStart",
      "enabled": true,
      ...

📖 Extracted from docs: mgd34msu/goodvibes-plugin

Need more details? View full documentation on GitHub →

29Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Overview

# GoodVibes Plugin

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/mgd34msu/goodvibes-plugin)

[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-purple.svg)](https://claude.com/claude-code)

> Plug in. Receive good vibes.

GoodVibes is a comprehensive Claude Code plugin that transforms AI-assisted development through batch-first operations, precision tools, and autonomous execution. Built for high-quality, low(ish)-effort development, it provides a complete ecosystem of agents, skills, and tools for maximum efficiency and quality.

📊 At a Glance

Autonomous AI development that actually works.

Most AI coding tools fail silently. They hit an error, give up, and hand you back a broken mess. GoodVibes doesn't. It recovers, learns, and delivers verified code.

| Component | Count | Description |

|-----------|-------|-------------|

| 🤖 Agents | 9 | Specialized roles (engineer, reviewer, tester, etc.) |

| 📚 Skills | 173 | Reusable knowledge modules across all tech stacks (honestly, skills are becoming less important) |

| 🔧 MCP Tools | 74 | Precision tools across 6 specialized engines |

| 🪝 Hooks | 9 | Lifecycle event handlers for automation (can use all 13 hook types) |

| 🎨 Output Styles | 2 | vibecoding (interactive) and justvibes (autonomous) |

| 📦 Templates | 3 | Production-ready project scaffolds (changing this soon - more targeted) |

---

[GoodVibes Plugin](#goodvibes-plugin)

- [📊 At a Glance](#-at-a-glance)

- [Table of Contents](#table-of-contents)

- [Features Overview](#features-overview)

- [Philosophy](#philosophy)

- [1. Errors Are Recoverable, Not Terminal](#1-errors-are-recoverable-not-terminal)

- [2. Memory That Persists](#2-memory-that-persists)

- [3. Verified Before Committed](#3-verified-before-committed)

- [4. Tools That Respect Your Context](#4-tools-that-respect-your-context)

- [5. Domain Knowledge Built In](#5-domain-knowledge-built-in)

- [Installation](#installation)

- [Prerequisites](#prerequisites)

- [Getting the Plugin](#getting-the-plugin)

- [First Run](#first-run)

- [Basic Usage](#basic-usage)

- [Quick Start](#quick-start)

- [Examples](#examples)

- [Running Your First Skill](#running-your-first-skill)

- [Using an Agent](#using-an-agent)

- [Core Concepts](#core-concepts)

- [Batch-First Architecture](#batch-first-architecture)

- [WRFC Loop (Write-Review-Fix-Check)](#wrfc-loop-write-review-fix-check)

- [Output Modes](#output-modes)

- [Transaction Modes](#transaction-modes)

- [Execution Modes](#execution-modes)

- [MCP Tools](#mcp-tools)

- [Precision Engine (9 tools)](#precision-engine-9-tools)

- [Batch Engine (6 tools)](#batch-engine-6-tools)

- [Registry Engine (7 tools)](#registry-engine-7-tools)

- [Analysis Engine (19 tools)](#analysis-engine-19-tools)

- [Project Engine (22 tools)](#project-engine-22-tools)

- [Frontend Engine (11 tools)](#frontend-engine-11-tools)

- [Agents](#agents)

- [Agent Spawning](#agent-spawning)

- [When to Use Each Agent](#when-to-use-each-agent)

- [Skills](#skills)

- [Skills Overview](#skills-overview)

- [Common Skills (29)](#common-skills-29)

- [WebDev Skills (138)](#webdev-skills-138)

- [Creation Skills (5)](#creation-skills-5)

- [Special Skills](#special-skills)

- [Discovering Skills](#discovering-skills)

- [Using Skills](#using-skills)

- [Slash Commands](#slash-commands)

- [Hooks](#hooks)

- [Hook Configuration](#hook-configuration)

- [Hook Execution Flow](#hook-execution-flow)

- [Output Styles](#output-styles)

- [vibecoding (Interactive)](#vibecoding-interactive)

- [justvibes (Autonomous)](#justvibes-autonomous)

- [Comparison](#comparison)

- [Switching Modes](#switching-modes)

- [Memory System](#memory-system)

- [Directory Structure](#directory-structure)

- [Logs (Session-Level)](#logs-session-level)

- [Memory (Cross-Session)](#memory-cross-session)

- [Memory Operations](#memory-operations)

- [Templates](#templates)

- [1. next-saas](#1-next-saas)

- [2. next-app](#2-next-app)

- [3. vite-react](#3-vite-react)

- [Using Templates](#using-templates)

- [Configuration](#configuration)

- [plugin.json](#pluginjson)

- [.mcp.json](#mcpjson)

- [hooks.json](#hooksjson)

- [Best Practices](#best-practices)

- [Before Any Task](#before-any-task)

- [During Execution](#during-execution)

- [After Execution](#after-execution)

- [Troubleshooting](#troubleshooting)

- [Common Issues](#common-issues)

- [License](#license)

---

Features Overview

GoodVibes provides:

🚀 Batch-First Operations: Execute multi-file operations atomically with automatic rollback
🎯 Precision Tools: Enhanced file operations with extract modes, context control, and validation
🤖 Specialized Agents: 9 role-specific agents (engineer, reviewer, tester, architect, deployer, integrator, planner, factories)
📚 Massive Skills Library: 173 curated skills covering modern web development, AI integration, databases, authentication, deployment, and more
🔍 Advanced Analysis: Stack detection, pattern scanning, breaking change detection, dependency analysis
🎨 Frontend Mastery: Component tree analysis, accessibility auditing, responsive breakpoint analysis, Tailwind conflict resolution
💾 Persistent Memory: Two-tier memory system (session logs + cross-session memory) for decision tracking and pattern recognition
🔄 Quality Assurance: Built-in WRFC loop (Write-Review-Fix-Check) with automatic validation
⚡ Token Efficiency: Output verbosity controls (count_only, minimal, standard, verbose) for optimal performance
🛡️ Enterprise Standards: No mocks, no placeholders, production-ready code only

Philosophy

#### 1. Errors Are Recoverable, Not Terminal

When something fails, GoodVibes doesn't stop. It escalates through three recovery phases:

| Phase | Action |

|-------|--------|

| Phase 1 | Attempt fix with existing knowledge |

| Phase 2 | Search official documentation, inject solutions |

| Phase 3 | Search community (Stack Overflow, GitHub), apply proven fixes |

Most errors resolve without human intervention. Your project keeps moving.

#### 2. Memory That Persists

Every session starts fresh with most AI tools. Not GoodVibes.

Decisions — Architectural choices and their rationale, searchable forever.

Patterns — Code conventions discovered in your codebase, applied consistently.

Failures — Past errors and their solutions. Same bug? Already knows the fix.

Your AI gets smarter the more you use it.

#### 3. Verified Before Committed

The WRFC Loop ensures nothing ships unverified:

```

WORK → REVIEW → FIX → CHECK

↑ |

└──────┘ (repeat until verified)

```

Work: Agent completes the task
Review: Separate reviewer agent evaluates against spec
Fix: If issues found, fix agent addresses them
Check: Reviews fix agent work, sends it back if necessary

When the loop ends for a task, it is committed and we move on.

#### 4. Tools That Respect Your Context

Token-efficient operations with output control:

```typescript

// Need just file paths? Get paths only.

precision_glob({ patterns: ["*/.ts"], output: "paths_only" })

// Need full content? Get full content.

precision_read({ files: ["src/auth.ts"], extract: "content" })

// Need just the function signatures? Get outlines.

precision_read({ files: ["src/auth.ts"], extract: "outline" })

```

Give agents the ability to use only the context they need.

#### 5. Domain Knowledge Built In

170+ skills, most with progressive disclosure, covering real-world development:

Frameworks: Next.js, Nuxt,

More from this repository6

🎯

workflow-patterns🎯Skill

Identifies and recommends optimal workflow strategies and best practices for software development tasks, automatically suggesting structured approaches to coding challenges.

🎯

hook-integration🎯Skill

Manages and coordinates lifecycle event handling across different components, enabling seamless automation and interaction between hooks in the GoodVibes development ecosystem.

🎯

script-best-practices🎯Skill

Analyzes and recommends improvements for script quality, identifying potential code smells, security risks, and optimization opportunities across different programming languages.

🎯

writing-descriptions🎯Skill

Generates concise, contextually-appropriate descriptions for code, files, or project components using AI-driven natural language generation techniques.

🎯

agent-sdk-definitions🎯Skill

Defines and standardizes SDK interface structures and method signatures for GoodVibes agents, enabling consistent and interoperable agent development across the plugin's ecosystem.

🏪

mgd34msu-goodvibes-plugin🏪Marketplace

Enhances audio experiences by providing customizable sound effects, equalizer settings, and streaming integrations for media players.