---
name: goodvibes-memory-7ab6fa7869d8
description: "Documents the .goodvibes/memory/ cross-session memory files (decisions, patterns, failures, preferences): what's written automatically, what you should read and write, and the exact JSON shape of each file. Load at the start of a task to check prior context, and before finishing to record what you learned."
---

# goodvibes-memory

Project memory that survives across sessions, stored under `.goodvibes/memory/`.

Four files, each a plain JSON array. Plain JSON is the point: any tool can read or write these
without a parser written specifically for them, so the format cannot drift away from the code
that reads it.

## Files and shapes

`.goodvibes/memory/decisions.json`: architectural choices and why.
```json
[{ "title": "Use tRPC for the API layer", "date": "2026-07-02",
   "rationale": "End-to-end type safety with the existing Next.js app",
   "alternatives": ["REST + OpenAPI", "GraphQL"], "agent": "architect" }]
```

`.goodvibes/memory/patterns.json`: established, reusable approaches.
```json
[{ "name": "Repository pattern for data access", "date": "2026-07-02",
   "description": "All DB access goes through src/repositories/*, never direct Prisma calls in routes",
   "files": ["src/repositories/user-repository.ts"] }]
```

`.goodvibes/memory/failures.json`: approaches that were tried and didn't work.
```json
[{ "date": "2026-07-02", "approach": "Bash failed: npm ERR! ERESOLVE ...",
   "reason": "Exhausted 6 attempts across 3 phases", "suggestion": "Manual intervention required" }]
```
This file is also written automatically: the `PostToolUseFailure` hook appends an entry here
when its 3-phase fix loop exhausts all attempts on a given error (see `post-tool-use-failure.mjs`).
That's the only automatic write in this system. Everything else is something an agent does
deliberately.

`.goodvibes/memory/preferences.json`: project conventions worth remembering.
```json
[{ "key": "test-framework", "value": "vitest", "date": "2026-07-02",
   "notes": "Project already had vitest configured; don't introduce jest" }]
```

## How to use it

**At the start of a task**: check `decisions.json` and `patterns.json` for anything relevant to
what you're about to do, and `failures.json` for approaches already known not to work. Don't
propose one of them again without a reason things have changed. All four files are plain JSON;
read them with `code_read` or native Read, whichever is simpler for a small file.

**When you finish a task**: if you made an architectural choice, found a reusable pattern, or hit
a dead end worth remembering, append an entry to the matching file (read the array, push, write
it back; there's no dedicated write tool, this is a plain file you read-modify-write like any
other project file). Don't write an entry for routine work that isn't worth another session's
attention. This is memory for things that would otherwise be re-discovered the hard way, not a
changelog.

## What this is not

It is not a task queue, not a message bus between agents in the same session (use the
orchestrator/Task tool output for that), and not automatically summarized or pruned. These
files grow with the project's history. If a file gets large enough to be unwieldy, that's a sign
to prune stale/superseded entries by hand, not a reason to stop using it.


---
Source attribution: mgd34msu
Original project: https://github.com/mgd34msu/goodvibes-plugin/blob/d19fa3c57eda377c032d3cd3e897fe127d1e99aa/plugins/goodvibes/skills/goodvibes-memory/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2025 GoodVibes Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: mgd34msu
Original project: https://github.com/mgd34msu/goodvibes-plugin/blob/d19fa3c57eda377c032d3cd3e897fe127d1e99aa/plugins/goodvibes/skills/goodvibes-memory/SKILL.md
Attribution basis: Source repository record

Fields of work: Data & Analytics, Development & Engineering, Product Management
Roles: Data Analyst, ML / AI Engineer, Product Manager
Specialties: API
Tools: Goodvibes
Country applicability: Country not specified
Classification basis: Source category, role and specialization labels
Instruction SHA-256: cb755001cf2e4d7be652b9de29d6219098cc61d69f07b7d0daae199440d400b5