From 9bf0a3c578cf5741bbded4f3240fa843d1fe79ef Mon Sep 17 00:00:00 2001 From: stateofshit Date: Tue, 28 Jul 2026 22:34:11 +0000 Subject: [PATCH] init: vault structure, rules, boot prompt, memory - Folders: 000-admin_shit, 00-inbox, 01-logs, 02-notes, 03-archive, 04-models, 05-handoffs, files, tpl - Vault-Rules.md: YAML frontmatter rules, tag schema, status lifecycle, file naming - model-boot.md: startup prompt for any model entering the vault - model-memory.md: persistent memory file between sessions - .gitignore: exclude .obsidian personal config --- .gitignore | 2 + 04-models/Vault-Rules.md | 96 +++++++++++++++++++++++++++++++++++++++ 04-models/model-boot.md | 60 ++++++++++++++++++++++++ 04-models/model-memory.md | 31 +++++++++++++ README.md | 26 +++++++++++ 5 files changed, 215 insertions(+) create mode 100644 .gitignore create mode 100644 04-models/Vault-Rules.md create mode 100644 04-models/model-boot.md create mode 100644 04-models/model-memory.md create mode 100644 README.md diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a40ae18 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +# Add .obsidian to gitignore so personal config stays local +.obsidian/ \ No newline at end of file diff --git a/04-models/Vault-Rules.md b/04-models/Vault-Rules.md new file mode 100644 index 0000000..2cbe477 --- /dev/null +++ b/04-models/Vault-Rules.md @@ -0,0 +1,96 @@ +--- +title: "Vault Rules" +status: "active" +folder: "04-models" +model_owner: "none" +tags: [rules, model] +created: "2026-07-28" +updated: "2026-07-28" +--- + +# Vault Rules + +Every model using this vault must follow these rules. No exceptions. + +## 1. Always Use YAML Frontmatter + +Every `.md` file starts with: + +```yaml +--- +title: "short desc" +status: "draft" | "active" | "archive" +folder: "04-models" +tags: [tag1, tag2] +created: "YYYY-MM-DD" +updated: "YYYY-MM-DD" +--- +``` + +`folder` must match the physical folder this file lives in. +`updated` gets bumped on every edit. + +## 2. Tags + +Use whatever tags make sense, but always include the folder number: + +| Folder | Required Tag | +|---|---| +| `00-inbox` | `#00-inbox` | +| `01-logs` | `#01-logs` | +| `02-notes` | `#02-notes` | +| `03-archive` | `#03-archive` | +| `04-models` | `#04-models` | +| `05-handoffs` | `#05-handoffs` | + +Plus any descriptive tags: `#research`, `#prompt`, `#memory`, `#handoff`, etc. + +## 3. Status Lifecycle + +``` +draft -> active -> archive +``` + +- Never delete a file. Move to `03-archive` and set `status: "archive"`. +- `00-inbox` items should eventually move to `02-notes` or `04-models`. +- `01-logs` stay forever (don't archive logs). + +## 4. Linking + +- Use `[[filename]]` . Example: `[[Vault-Rules]]` +- Handoffs in `05-handoffs` must link their source in `04-models`. +- Cross-folder links are fine. + +## 5. Folder Purposes + +| Folder | What Goes There | +|---|---| +| `000-admin_shit` | Admin notes, config. User folder — models read-only. | +| `00-inbox` | Raw dumps, new ideas, unorganized stuff | +| `01-logs` | Session logs, daily notes, timestamps | +| `02-notes` | Research notes, findings, reference material | +| `03-archive` | Done / superseded files | +| `04-models` | Model behavior docs, prompts, memory files | +| `05-handoffs` | Handoff docs between models or sessions | +| `files` | Attachments, images, PDFs | +| `tpl` | Templates for new documents | + +## 6. File Naming + +- `Descriptive-Title.md` (words separated with `-`) +- No spaces, no special chars. +- Handoffs: `handoff--.md` + +## 7. Model Prompt (boot this on start) + +When a model starts, it should read these files first: +- `00-inbox/` — anything new to process +- `04-models/Vault-Rules.md` — this file +- `04-models/model-memory.md` — persistent memory + +Then it can create / edit files as needed. + +## 8. Git + +Repo is at `git@github.com:stateofshit/shit_in_a_vault.git`. +Models should commit and push after significant changes. \ No newline at end of file diff --git a/04-models/model-boot.md b/04-models/model-boot.md new file mode 100644 index 0000000..34c5bac --- /dev/null +++ b/04-models/model-boot.md @@ -0,0 +1,60 @@ +--- +title: "Model Boot Prompt" +status: "active" +folder: "04-models" +tags: [rules, model, prompt] +created: "2026-07-28" +updated: "2026-07-28" +--- + +# Model Boot Prompt + +Paste this into any model before it touches the vault: + +--- + +You are working in an Obsidian vault at `/home/user/02-repos/shit_in_a_vault/`. + +## On Startup + +1. Read `04-models/Vault-Rules.md` — the vault rules. +2. Read `04-models/model-memory.md` — persistent memory. +3. Scan `00-inbox/` for unprocessed items. +4. Scan `01-logs/` for recent session context. + +## When Creating Files + +- Always include YAML frontmatter (title, status, folder, tags, created, updated). +- File goes in the folder matching its `folder:` field. +- Use `-` not spaces in filenames. +- Tag with folder number (`#04-models`) + any descriptive tags. + +## When Editing Files + +- Bump `updated:` in frontmatter. +- Don't delete anything. Move to `03-archive` and set `status: archive` instead. +- Link other docs with `[[filename]]`. + +## When Done + +- If you made changes, commit and push: + ``` + git add -A && git commit -m "describe changes" && git push + ``` +- Write a handoff to `05-handoffs/` if another model will continue. +- Move processed inbox items to the right folder (status `active`). + +## Folder Map + +| Folder | What's in it | +|---|---| +| `000-admin_shit` | User stuff — do not touch | +| `00-inbox` | Incoming for you to process | +| `01-logs` | Session logs | +| `02-notes` | Research notes | +| `03-archive` | Dead files | +| `04-models` | Rules, memory, model docs | +| `05-handoffs` | Pass to next model | +| `files` | Attachments | +| `tpl` | Templates | +--- \ No newline at end of file diff --git a/04-models/model-memory.md b/04-models/model-memory.md new file mode 100644 index 0000000..e9b9116 --- /dev/null +++ b/04-models/model-memory.md @@ -0,0 +1,31 @@ +--- +title: "Model Memory" +status: "active" +folder: "04-models" +tags: [memory, model] +created: "2026-07-28" +updated: "2026-07-28" +--- + +# Persistent Model Memory + +This file persists between sessions. Models should read on boot and update before handoff. + +## Current State + +- Vault initialized: 2026-07-28 +- Git remote: `git@github.com:stateofshit/shit_in_a_vault.git` +- User: `stateofshit` +- Server: openwebui + +## Active Projects + +_(add active projects here)_ + +## Recent Handoffs + +_(link recent handoff docs here)_ + +## Notes + +_(anything models need to remember about the user, context, or ongoing work)_ \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..217cf79 --- /dev/null +++ b/README.md @@ -0,0 +1,26 @@ +# shit_in_a_vault + +Obsidian vault for openwebui models + research. + +## Folders + +| Folder | Purpose | +|---|---| +| `000-admin_shit/` | User admin — models read-only | +| `00-inbox/` | Raw dumps, new stuff | +| `01-logs/` | Session logs | +| `02-notes/` | Research notes | +| `03-archive/` | Dead/superseded | +| `04-models/` | Rules, memory, boot prompt | +| `05-handoffs/` | Model handoffs | +| `files/` | Attachments | +| `tpl/` | Templates | + +## For Models + +Boot: read `04-models/model-boot.md` +Rules: read `04-models/Vault-Rules.md` + +## Git + +`git@github.com:stateofshit/shit_in_a_vault.git` \ No newline at end of file