From cf545fccfcf4493887fc13f7a2f16b303e8a415a Mon Sep 17 00:00:00 2001 From: stateofshit Date: Wed, 29 Jul 2026 17:56:26 +0000 Subject: [PATCH] reorg: 10-assets->00-assets, add 07-tasks + 06-research, READMEs in all folders --- 00-assets/.gitkeep | 1 + 00-assets/README.md | 28 +++++++++++ 00-inbox/README.md | 29 +++++++++++ 000-shit_admin/dashboard.md | 8 ++-- 01-logs/README.md | 25 ++++++++++ 02-notes/README.md | 29 +++++++++++ 03-archive/README.md | 30 ++++++++++++ 04-models/README.md | 28 +++++++++++ 04-models/Vault-Rules.md | 32 ++++++++----- 05-handoffs/README.md | 39 +++++++++++++++ 06-research/README.md | 40 ++++++++++++++++ 07-tasks/.gitkeep | 1 + 07-tasks/README.md | 48 +++++++++++++++++++ .../vault-setup-test.md | 6 +-- README.md | 6 ++- assets/.gitkeep | 0 16 files changed, 330 insertions(+), 20 deletions(-) create mode 100644 00-assets/.gitkeep create mode 100644 00-assets/README.md create mode 100644 00-inbox/README.md create mode 100644 01-logs/README.md create mode 100644 02-notes/README.md create mode 100644 03-archive/README.md create mode 100644 04-models/README.md create mode 100644 05-handoffs/README.md create mode 100644 06-research/README.md create mode 100644 07-tasks/.gitkeep create mode 100644 07-tasks/README.md rename 02-notes/task-vault-setup-test.md => 07-tasks/vault-setup-test.md (97%) delete mode 100644 assets/.gitkeep diff --git a/00-assets/.gitkeep b/00-assets/.gitkeep new file mode 100644 index 0000000..a5ef30c --- /dev/null +++ b/00-assets/.gitkeep @@ -0,0 +1 @@ +# keep this folder in git diff --git a/00-assets/README.md b/00-assets/README.md new file mode 100644 index 0000000..87ce8ba --- /dev/null +++ b/00-assets/README.md @@ -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 diff --git a/00-inbox/README.md b/00-inbox/README.md new file mode 100644 index 0000000..1bc300a --- /dev/null +++ b/00-inbox/README.md @@ -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/` diff --git a/000-shit_admin/dashboard.md b/000-shit_admin/dashboard.md index 0e80c55..cd76db4 100644 --- a/000-shit_admin/dashboard.md +++ b/000-shit_admin/dashboard.md @@ -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 diff --git a/01-logs/README.md b/01-logs/README.md new file mode 100644 index 0000000..0365654 --- /dev/null +++ b/01-logs/README.md @@ -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`. diff --git a/02-notes/README.md b/02-notes/README.md new file mode 100644 index 0000000..496e062 --- /dev/null +++ b/02-notes/README.md @@ -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. diff --git a/03-archive/README.md b/03-archive/README.md new file mode 100644 index 0000000..d80c630 --- /dev/null +++ b/03-archive/README.md @@ -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/.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 diff --git a/04-models/README.md b/04-models/README.md new file mode 100644 index 0000000..e1fcbbe --- /dev/null +++ b/04-models/README.md @@ -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. diff --git a/04-models/Vault-Rules.md b/04-models/Vault-Rules.md index af8e12e..0074d24 100644 --- a/04-models/Vault-Rules.md +++ b/04-models/Vault-Rules.md @@ -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 diff --git a/05-handoffs/README.md b/05-handoffs/README.md new file mode 100644 index 0000000..82f5f2f --- /dev/null +++ b/05-handoffs/README.md @@ -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--.md` +- `handoff-claude-mistral.md` +- `handoff-mistral-user.md` + +## Required Frontmatter + +```yaml +--- +title: "Handoff: → " +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. diff --git a/06-research/README.md b/06-research/README.md new file mode 100644 index 0000000..daa3fd6 --- /dev/null +++ b/06-research/README.md @@ -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: " +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. | diff --git a/07-tasks/.gitkeep b/07-tasks/.gitkeep new file mode 100644 index 0000000..a5ef30c --- /dev/null +++ b/07-tasks/.gitkeep @@ -0,0 +1 @@ +# keep this folder in git diff --git a/07-tasks/README.md b/07-tasks/README.md new file mode 100644 index 0000000..dfc71ac --- /dev/null +++ b/07-tasks/README.md @@ -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: " +status: "active" | "blocked" | "done" | "archived" +folder: "07-tasks" +tags: [task, ] +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. diff --git a/02-notes/task-vault-setup-test.md b/07-tasks/vault-setup-test.md similarity index 97% rename from 02-notes/task-vault-setup-test.md rename to 07-tasks/vault-setup-test.md index a89ef08..082eb73 100644 --- a/02-notes/task-vault-setup-test.md +++ b/07-tasks/vault-setup-test.md @@ -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" diff --git a/README.md b/README.md index 25433a8..6b775ed 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/assets/.gitkeep b/assets/.gitkeep deleted file mode 100644 index e69de29..0000000