medic8d-dev/shit_in_a_vault
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

reorg: 10-assets->00-assets, add 07-tasks + 06-research, READMEs in all folders

Browse Source
This commit is contained in:
stateofshit
2026-07-29 17:56:26 +00:00
parent e9ef0b0ce8
commit cf545fccfc
16 changed files with 330 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
00-assets/.gitkeep
+1
View File
@@ -0,0 +1 @@
# keep this folder in git
00-assets/README.md
+28
View File
@@ -0,0 +1,28 @@
---
title: "Assets"
status: "active"
folder: "00-assets"
tags: [readme, asset]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
---
# Assets
Attachments — images, PDFs, binaries. Files Obsidian stores for embedding in notes.
## How Obsidian uses this
Configure Obsidian Settings → Files & Links → **Attachment folder**:
- Path: `00-assets`
- New files added: in folder under current date
When you paste an image into a note, Obsidian saves it here and inserts the `![[00-assets/image-name.png]]` link.
## File types
- `.png`, `.jpg`, `.webp` — images
- `.pdf` — documents
- `.mp4`, `.webm` — videos
- `.svg` — vector graphics
00-inbox/README.md
+29
View File
@@ -0,0 +1,29 @@
---
title: "Inbox"
status: "active"
folder: "00-inbox"
tags: [readme, inbox]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
---
# Inbox
Raw dumps, new ideas, unorganized stuff. **No file should live here forever** — process and move out.
## When to use
- Quick capture
- Brain dumps
- Half-baked ideas
- Notes that don't yet have a folder
## When to leave
Move out when:
- It has a clear topic → `02-notes/`
- It's a task → `07-tasks/`
- It's a long research doc → `06-research/`
- It's a model rule → `04-models/`
- It's stale → `03-archive/`
000-shit_admin/dashboard.md
+5 -3
View File
@@ -5,7 +5,7 @@ folder: "000-shit_admin"
tags: [dashboard, home]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
version: "1.1.0"
---
# Dashboard
@@ -95,14 +95,16 @@ LIMIT 5
## Quick Folders
- [[000-shit_admin/README|000-shit_admin]] — your zone
- [[000-configs/README|000-configs]]
- [[00-inbox/README|00-inbox]]
- [[01-logs/README|01-logs]]
- [[02-notes/README|02-notes]]
- [[03-archive/README|03-archive]]
- [[04-models/README|04-models]]
- [[05-handoffs/README|05-handoffs]]
- [[files/README|files]]
- [[tpl/README|tpl]]
- [[06-research/README|06-research]]
- [[07-tasks/README|07-tasks]]
- [[00-assets/README|00-assets]]
## Model Docs
01-logs/README.md
+25
View File
@@ -0,0 +1,25 @@
---
title: "Logs"
status: "active"
folder: "01-logs"
tags: [readme, log]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
---
# Logs
Session logs, daily notes, timestamps.
## Subfolders
| Folder | What |
|---|---|
| [[01-logs/daily/]] | Auto daily notes (Obsidian Daily Notes plugin) |
## Rules
- **Never delete logs.** They are append-only history.
- Daily notes auto-create via the Daily Notes plugin — don't manually create files in `01-logs/daily/`.
- For a session log, prefix with date: `2026-07-29-session-NN.md`.
02-notes/README.md
+29
View File
@@ -0,0 +1,29 @@
---
title: "Notes"
status: "active"
folder: "02-notes"
tags: [readme, notes]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
---
# Notes
Short notes, scratch work, per-topic research notes that aren't substantial enough for `06-research/`.
## When to use
- Quick scratch work
- Per-topic research that's < 1 page
- Notes that reference a task in `07-tasks/`
## When NOT to use
- **Tasks** → use `07-tasks/` (one file per task)
- **Long-form research with citations** → use `06-research/`
- **Daily notes** → use `01-logs/daily/YYYY-MM-DD.md`
## File naming
`topic-slug.md` — kebab-case.
03-archive/README.md
+30
View File
@@ -0,0 +1,30 @@
---
title: "Archive"
status: "active"
folder: "03-archive"
tags: [readme, archive]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
---
# Archive
Done / superseded files. Move here, don't delete.
## When to archive
- Task is done → `07-tasks/<task>.md` → move to `03-archive/`, set `status: "archived"`
- Doc is superseded → move + set `status: "archived"`
- Old config / prompt that's no longer current
## Naming
Keep the original filename. Add a date prefix if helpful:
- `original-name.md`
- `2026-07-29-original-name.md`
## Don't archive
- Logs (`01-logs/`) — append-only
- Daily notes
04-models/README.md
+28
View File
@@ -0,0 +1,28 @@
---
title: "Models"
status: "active"
folder: "04-models"
tags: [readme, model]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
---
# Models
Model behavior docs, prompts, memory files. Read these on boot.
## Files
| File | Purpose |
|---|---|
| [[04-models/Vault-Rules]] | Rules every model must follow |
| [[04-models/model-boot]] | Boot prompt — what to read on start |
| [[04-models/model-memory]] | Persistent memory across sessions |
| [[04-models/model-identity]] | Self-identification doc |
## Rules
- Models edit files in here freely.
- Always bump `version` on edit (use `000-configs/bin/bump-version.sh`).
- Don't move these — they're the rule docs.
04-models/Vault-Rules.md
+20 -12
View File
@@ -6,7 +6,7 @@ model_owner: "none"
tags: [rules, model]
created: "2026-07-28"
updated: "2026-07-29"
version: "1.2.0"
version: "1.3.0"
---
# Vault Rules
@@ -42,12 +42,18 @@ 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` |
| `000-shit_admin` | `#admin` |
| `000-configs` | `#config` |
| `00-inbox` | `#inbox` |
| `01-logs` | `#log` |
| `01-logs/daily` | `#daily` |
| `02-notes` | `#note` |
| `03-archive` | `#archive` |
| `04-models` | `#model` |
| `05-handoffs` | `#handoff` |
| `06-research` | `#research` |
| `07-tasks` | `#task` |
| `00-assets` | `#asset` |
Plus any descriptive tags: `#research`, `#prompt`, `#memory`, `#handoff`, etc.
@@ -76,16 +82,18 @@ draft -> active -> archive
| `000-configs` | Server/model config docs, scripts, templates |
| `000-configs/templates` | Markdown templates |
| `000-configs/bin` | Helper shell scripts |
| `000-configs/tools` | Tool docs (gh, playwright, vite) |
| `000-configs/skills` | Skill docs, plugin recommendations |
| `00-inbox` | Raw dumps, new ideas, unorganized stuff |
| `01-logs` | Session logs |
| `01-logs/daily` | Auto daily notes (Obsidian Daily Notes plugin) |
| `assets` | Attachments |
| `01-logs` | Session logs, daily notes, timestamps |
| `02-notes` | Research notes, findings, reference material |
| `02-notes` | Short notes, scratch work, per-topic research (< 1 page) |
| `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 |
| `06-research` | Long-form research documents with citations |
| `07-tasks` | One file per task. `tags: [task]` |
| `00-assets` | Attachments (images, PDFs) |
## 6. File Naming
05-handoffs/README.md
+39
View File
@@ -0,0 +1,39 @@
---
title: "Handoffs"
status: "active"
folder: "05-handoffs"
tags: [readme, handoff]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
---
# Handoffs
Model-to-model handoffs. When one model picks up where another left off.
## Naming
`handoff-<source>-<dest>.md`
- `handoff-claude-mistral.md`
- `handoff-mistral-user.md`
## Required Frontmatter
```yaml
---
title: "Handoff: <source> → <dest>"
status: "active" | "done"
folder: "05-handoffs"
tags: [handoff]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
from: "model-name"
to: "model-name"
---
```
## Template
`000-configs/templates/handoff.md` — copy + fill in.
06-research/README.md
+40
View File
@@ -0,0 +1,40 @@
---
title: "Research"
status: "active"
folder: "06-research"
tags: [readme, research]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
---
# Research
Long-form research documents. Use the `research.md` template from `000-configs/templates/research.md`.
## Structure
Each research doc gets its own file. Suggested naming:
- `topic-name.md` — short topic slug
## Frontmatter
```yaml
---
title: "Research: <topic>"
status: "active" | "draft" | "archived"
folder: "06-research"
tags: [research, topic-tag]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
source: "url or citation" # optional
---
```
## Versus 02-notes
| Folder | Purpose |
|---|---|
| `02-notes/` | Short notes, tasks, scratch work, per-task research |
| `06-research/` | Long-form, cited research output. Substantial enough to be its own doc. |
07-tasks/.gitkeep
+1
View File
@@ -0,0 +1 @@
# keep this folder in git
07-tasks/README.md
+48
View File
@@ -0,0 +1,48 @@
---
title: "Tasks"
status: "active"
folder: "07-tasks"
tags: [readme, tasks]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
---
# Tasks
Active task tracking. One file per task.
## File naming
`topic-slug.md` — short kebab-case. Not prefixed with `task-` (the `tags: [task]` makes it clear).
## Frontmatter
```yaml
---
title: "Task: <topic>"
status: "active" | "blocked" | "done" | "archived"
folder: "07-tasks"
tags: [task, <topic-tag>]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.0"
priority: "low" | "medium" | "high" | "critical"
due: "YYYY-MM-DD" # optional
owner: "stateofshit"
---
```
## Status workflow
`active` → `blocked` → `done` → `archived`
When done, move to `03-archive/` instead of deleting.
## Template
`000-configs/templates/task.md` — copy + fill in.
## Dashboard
`000-shit_admin/dashboard.md` has Dataview queries that pull all `status: "active"` tasks from this folder.
02-notes/task-vault-setup-test.md → 07-tasks/vault-setup-test.md
+3 -3
View File
@@ -1,11 +1,11 @@
---
title: "Task: Vault setup test"
status: "active"
folder: "02-notes"
status: "done"
folder: "07-tasks"
tags: [task, vault, test]
created: "2026-07-29"
updated: "2026-07-29"
version: "1.0.1"
version: "1.0.2"
priority: "high"
due: "2026-07-30"
owner: "stateofshit"
README.md
+4 -2
View File
@@ -30,11 +30,13 @@ Obsidian vault for openwebui models + research. Private repo.
| [[00-inbox/]] | Raw dumps, unprocessed |
| [[01-logs/]] | Session logs |
| [[01-logs/daily/]] | Auto daily notes (Obsidian Daily Notes plugin) |
| [[02-notes/]] | Research notes + tasks |
| [[02-notes/]] | Short notes, scratch, per-topic research |
| [[03-archive/]] | Superseded |
| [[04-models/]] | Rules, memory, boot prompt, model identity |
| [[05-handoffs/]] | Model-to-model handoffs |
| [[assets/]] | Attachments (images, PDFs) |
| [[06-research/]] | Long-form research with citations |
| [[07-tasks/]] | One file per task (tags: [task]) |
| [[00-assets/]] | Attachments (images, PDFs) |
## For Models
assets/.gitkeep
View File