chore: initial commit — portable agent memory & skill scaffold
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.
This commit is contained in:
commit
25256ec417
61 files changed
+4431
No files matched your search
@@ -0,0 +1,46 @@
|
||||
# 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
|
||||
Reference in new issue
Block a user