JunHo Kim
25256ec417
Extracted and cleaned up from a prior WSL/Windows agent-memory setup. Contains only project-agnostic content: - Claude_Memory/: feedback rules, user profile, reusable reference docs, session scratch space (claude_info/, claude_log/), mirrored skill defs - caveman/: ultra-compressed communication mode skill + subcommands - html-slide-deck/: self-contained HTML slide deck builder skill Project-specific knowledge (previously mixed in) was moved out to each project's own repository as part of this cleanup.
46 lines
2.9 KiB
Markdown
Executable File
46 lines
2.9 KiB
Markdown
Executable File
# Agent Memories
|
|
|
|
A portable, project-agnostic memory and skill scaffold for AI coding agents (Claude Code, Gemini/Antigravity, and similar).
|
|
|
|
The core idea: an agent that works across many different codebases accumulates two kinds of knowledge —
|
|
knowledge that is useful *everywhere* (how you like to communicate, how you like commits done, reusable
|
|
tool workflows) and knowledge that only makes sense for *one specific project* (its language, its build
|
|
system, its domain quirks). Mixing the two makes the "everywhere" knowledge unusable when you switch to a
|
|
different project. This repository keeps only the first kind. Project-specific knowledge lives inside each
|
|
project's own repository instead.
|
|
|
|
## Structure
|
|
|
|
```
|
|
Agent_Memories/
|
|
├── Claude_Memory/ # Claude-specific working memory
|
|
│ ├── MEMORY.md # index — start here
|
|
│ ├── claude_info/ # CHECKPOINT / NOTES / TIPS / TODO (session-scoped scratch files)
|
|
│ ├── claude_log/ # dated work logs (LOG_YYYYMMDD_<topic>.md), format only — see README inside
|
|
│ ├── claude_skills/ # mirrored Skill definitions (archive-session, graphify, grill-me, handoff)
|
|
│ ├── feedback_*.md # behavioral rules learned from user corrections/confirmations
|
|
│ ├── user_*.md # stable facts about the user (preferences, profile)
|
|
│ └── reference_*.md # reusable tool/reference documentation (e.g. graphify usage)
|
|
├── caveman/ # ultra-compressed communication mode (skill + subcommands)
|
|
├── html-slide-deck/ # skill for building self-contained HTML slide decks
|
|
└── html-slide-deck.skill # packaged version of the above
|
|
```
|
|
|
|
### Memory file conventions (`Claude_Memory/`)
|
|
|
|
| Prefix | Meaning | Changes how often? |
|
|
|---|---|---|
|
|
| `feedback_*.md` | A behavioral rule learned from an explicit user correction or confirmation. Each file states the rule, **why** it exists, and **how** to apply it. | Rare — only when the user corrects or confirms an approach |
|
|
| `user_*.md` | Stable facts about the user: preferences, working style, profile. | Rare |
|
|
| `reference_*.md` | Documentation for a reusable tool or workflow that isn't tied to any one project. | Occasional |
|
|
| `claude_info/*.md` | Short-lived session scratch space (current status, discoveries, todos). | Every session |
|
|
| `claude_log/*.md` | Dated logs of non-obvious discoveries, kept for future reference. | Per notable discovery |
|
|
|
|
**Rule of thumb**: if a note only makes sense to someone who already knows the specific project you were
|
|
working in, it does not belong here — move it into that project's own memory/notes instead. This repository
|
|
was extracted from a working setup that originally mixed both kinds of content; project-specific material
|
|
was moved out during that cleanup.
|
|
|
|
## Usage
|
|
|
|
1. Clone or copy this repository's contents into wherever your agent looks for pers |