goodvibes-memory

Read and write structured decisions, patterns, failures, and preferences to JSON files.

6|3|Updated Jan 2, 2026
One-click install
npx skills add https://github.com/mgd34msu/goodvibes-plugin --skill goodvibes-memory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goodvibes-memory
Source: https://github.com/mgd34msu/goodvibes-plugin/tree/main/plugins/goodvibes/skills/protocol/goodvibes-memory
Command: npx skills add https://github.com/mgd34msu/goodvibes-plugin --skill goodvibes-memory

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures AI agents retain knowledge across sessions by managing a persistent memory system, preventing repeated errors and promoting consistent decision-making.

Core Features & Use Cases

  • Cross-Session Memory: Stores decisions, patterns, failures, and preferences in structured JSON files.
  • Logging: Maintains human-readable Markdown logs for activity, decisions, and errors.
  • Use Case: An agent encounters a recurring build error. It consults failures.json, finds the previous resolution and prevention strategy, and applies it, avoiding the error entirely.

Quick Start

Before starting any task, read the memory files by running the command: bash plugins/goodvibes/skills/protocol/goodvibes-memory/scripts/validate-memory-usage.sh session-transcript.jsonl .goodvibes/memory/

Frequently Asked Questions about goodvibes-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add persistent memory to an AI agent for cross-session consistency?

You implement persistent memory by defining protocols to read and write structured data, such as decisions and failures, to JSON files. This allows AI agents to retain cross-session knowledge, preventing repeated errors and ensuring consistent decision-making.

Why does my AI agent keep repeating the same build errors across different sessions?

AI agents repeat errors across sessions without persistent memory. By consulting a structured failures log, an agent can find previous resolutions and prevention strategies, avoiding the error entirely in future runs.

What is the best way to log AI agent activity and decisions for future review?

The best way to log AI agent activity is maintaining human-readable Markdown logs alongside structured JSON files. This records decisions, activity, and errors, enabling agents to reuse proven approaches and adhere to architectural conventions.

How do I start a task using an AI agent memory system with JSON files?

To start a task using an AI agent memory system, run the validate-memory-usage script with your session transcript and memory directory. This reads stored patterns and preferences from JSON files before execution, ensuring past knowledge is applied.

Can I use JSON files and Markdown logs to store AI agent preferences and patterns?

Yes, you can use JSON files and Markdown logs to store AI agent preferences and patterns. The system writes structured data to JSON for machine reading and human-readable Markdown for activity logging, supporting cross-session learning.

When should I not use a local JSON file system for agent memory and error handling?

You should avoid a local JSON file system for agent memory when handling highly concurrent writes or needing centralized, remote access. This system targets local, structured logging for individual agent consistency and error handling.