Can I manually edit the memory files?

Yes, the system uses standard JSON and Markdown formats, allowing developers to review, edit, or prune the memory manually to keep the project context clean.

Does it work across different Claude sessions?

Yes, the protocol is designed specifically for cross-session continuity, ensuring that knowledge gained in one session is available in all future interactions.

How does this skill help avoid repeating mistakes?

It enforces a 'Read Phase' where Claude checks failures.json for past errors and prevention strategies before starting any new task.

What files does the Memory Protocol create?

It creates a .goodvibes directory containing JSON files for machine-readable data (decisions, patterns, failures) and Markdown files for human-readable logs of activity and errors.

Is there a way to validate the memory usage?

The skill includes a validation script (validate-memory-usage.sh) that verifies if the agent is correctly following the read/write phases of the protocol.

GoodVibes Memory Protocol

Name: GoodVibes Memory Protocol
Author: mgd34msu

bymgd34msu

•

Productivity & Workflow

Implements persistent cross-session memory to help Claude learn from past architectural decisions, patterns, and errors.

The GoodVibes Memory Protocol provides a structured framework for Claude to maintain continuity across coding sessions. By capturing architectural decisions, proven implementation patterns, and past failures in machine-readable JSON and human-readable Markdown, it ensures that the AI agent doesn't repeat mistakes or rediscover existing solutions. This skill is essential for long-term project maintenance, allowing Claude to align with project-specific conventions and evolve contextually alongside the codebase.

Key Features

01Timestamp-based ID generation to prevent write collisions

02Dual-layer storage in machine-readable JSON and human-readable Markdown

036 GitHub stars

04Automated failure logging to prevent recurring errors

05Pattern recognition and reuse for optimized development

06Persistent cross-session memory for architectural consistency

Use Cases

01Maintaining architectural alignment across multi-day development tasks

02Preventing the re-introduction of bugs that were previously resolved

03Onboarding Claude to project-specific coding styles and preferences

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mgd34msu/goodvibes-plugin protocol

For use in Claude.ai and ChatGPT

Download Skill