Memory System
Root map of the memory system. Read first, always.
Open source Repository Open in the app JSON README (API)
About
# Memory System
Before any work: read [shared/truth/handbook.md](shared/truth/handbook.md) — the operating rules. A session is not oriented until it has.
## Projects
- [shared](shared/index.md) — cross-project truths: the handbook, the shared lexicon, taste, conventions.
- [ov](ov/index.md) — Overview: browser and editor for every markdown file in the repo. **First project — the week of real use runs here.**
- [lv](lv/index.md) — Tommy's Vineyard Space: the vineyard in descriptions and photos.
- [gallery](gallery/index.md) — drag and drop: lv's whole code copied and renamed, waiting to be taken apart.
- [mj](mj/index.md) — brought up with boilerplate only; what it is for is not written yet.
- [ws](ws/index.md) — webseriously: graph visualization. First truth: the filesystem database.
*(Remaining projects — di, musicology — join here once ov's rhythm holds.)*
## Type vocabulary
`design` · `spec` · `decision` · `principle` · `reference` — every truth file's `type` comes from this l
Details
- Kind
- OKF bundles
- Topic
- AI, RAG & memory
- Publisher
- gizmolab10
- Origin
- okf_github
- Category
- dados
- Version
- 0.1
- Last push
- 2026-09-04T01:47:17Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-09-08 22:11:44
- Updated
- 2026-09-10 23:05:11
- Origin id
gizmolab10/mono:memory/index.md
README
# Shared Documentation & Tools
This repo contains common guides and tools shared across projects.
## Structure
```
shared/
guides/
collaborate/ ← working with co
develop/ ← coding patterns
test/ ← debugging, testing
tools/
lib/ ← TypeScript tools for VitePress docs
```
## Guides
Read these to understand how we work:
- `guides/collaborate/voice.md` — writing style
- `guides/collaborate/chat.md` — problem-solving with co
- `guides/collaborate/workflow.md` — the meta-system
- `guides/develop/markdown.md` — doc formatting patterns
- `guides/test/debugging.md` — systematic debugging
## Tools
TypeScript tools for VitePress documentation management:
- `fix-links.ts` — find and fix broken links
- `merge-files.ts` — merge markdown files, update references
- `sync-sidebar.ts` — regenerate sidebar from filesystem
- `generate-sidebar.ts` — sidebar generation logic
- `markdown-parser.ts` — link parsing and updating
- `link-finder.ts` — file search utilities
- `config-updater.ts` — VitePress config manipulation
### Usage
Projects compile these tools locally:
```bash
cd <project>/notes/tools
npx tsc -p ../../shared/tools/tsconfig.json --outDir ./dist
node dist/fix-links.js
```
## For Projects Using This Repo
Each project's CLAUDE.MD should include:
```markdown
COMMON: Read ../shared/CLAUDE.MD and guides first
```
Clone as sibling:
```
~/GitHub/
shared/ ← this repo
di/ ← project
webseriously/ ← project
```