# Obsidian Second Brain Vault for AI Agents

**Purpose**: This vault implements Julian Goldie's "Obsidian as 2nd Brain for AI" / Infinite Context Engine concept. 
It serves as the **single source of truth shared memory** for all your AI agents (Hermes, Leonard, Charlie, Athena, Claude, local LLMs via LM Studio, etc.).

Instead of each agent having siloed, disposable context, **every agent reads from and writes back to this local Markdown vault**. 
It becomes your portable, future-proof, vendor-independent long-term memory.

## Core Architecture (Goldie + Your Stack)

1. **Capture** — Agent activity logs, conversation summaries, cron jobs, manual dumps from other AIs. (Optional: add OMI wearable later for passive screen/mic capture)
2. **Organize** — Agents (primarily Hermes or Claude Desktop) clean, structure, link, and summarize daily/weekly.
3. **Store** — This Obsidian vault (local-first, plain Markdown + YAML frontmatter). Git-optional for versioning.
4. **Deploy** — Every agent session starts by loading relevant notes from the vault (via the `obsidian-second-brain` skill or direct folder access in Claude Desktop / custom pipelines).

**The Loop**: After any meaningful agent work, the agent writes structured updates back into the vault. Tomorrow's agents wake up smarter.

**Your Advantage**: You already have the `obsidian-second-brain` cross-CLI skill installed locally. It handles self-rewriting notes, hybrid search, scheduled maintenance agents, and multi-agent access (Claude Code, Codex, Gemini, OpenCode, Hermes, Pi). This vault is the data layer that skill operates on.

## PARA Organization (Projects / Areas / Resources / Archives)

- **Projects/** — Time-bound initiatives with clear goals and end dates (e.g. AI Research Oracle v1 launch).
- **Areas/** — Ongoing spheres of responsibility (e.g. AI Agent Development, Content Creation, Business Operations).
- **Resources/** — Evergreen knowledge, references, tools, prompts, model evals.
- **Archives/** — Completed or hibernated items. Move here instead of deleting.

**Every note uses YAML frontmatter** for agent visibility:
```yaml
---
title: "Note Title"
tags: [project/ai-research-oracle, hermes-managed, priority/high]
updated: 2026-07-15
updated_by: "Hermes"
status: active
related: ["[[AI-Talk-Show-Leonard-Charlie]]"]
---
```

Tags + wikilinks (`[[Note Name]]`) are the connective tissue agents use for retrieval.

## Quick Start (for your machine)

1. Copy this entire folder to your local machine (e.g. `~/Obsidian-Vaults/Second-Brain-for-AI/` or `~/second-brain`).
2. Open it in Obsidian (free from obsidian.md). Install community plugins if desired: Dataview, Periodic Notes, Git (optional), Advanced URI, etc. Keep plugins minimal.
3. Point your agents at it:
   - **Claude Desktop**: Open the folder as a project or use Artifacts / file access.
   - **Hermes / local agents**: Use the installed `obsidian-second-brain` skill — it exposes the vault to your agents.
   - **LM Studio / local LLMs**: Use system prompt that includes "You have access to the Obsidian vault at [path]. Use the provided tools or read relevant .md files before answering."
4. Run the **Initialization Prompt** (see Meta/Agent-Prompts.md) with Hermes or Claude to seed initial memories from what you already know about your projects.
5. Set up **daily maintenance** (cron or scheduled agent task):
   - Once per day (or on demand): "Run daily Obsidian vault maintenance: summarize yesterday's activity, update project notes, prune old context, create daily log if needed."
6. **Backup**: rsync or git push to a private repo / cloud (Obsidian Sync optional). Do a full backup quarterly.

## Token Discipline (Important for local RTX 3060)

- Do **not** dump entire chat history every turn.
- Use **daily batch summaries** only.
- The `obsidian-second-brain` skill + scheduled agents already implement this.
- When context grows, ask agent: "Reconsider and compress the last 7 days of activity into concise project updates in the vault."

## Why This Unlocks Your Workflow

- **Leonard & Charlie** (AI Talk Show): Persistent character memories, show history, episode ideas, audience feedback all live here. They "remember" across sessions without prompt stuffing.
- **Hermes + Athena (AI Research Oracle)**: Daily news pipeline outputs, source credibility notes, article drafts, performance metrics stored and queryable.
- **OmniRoute**: Routing logic, API key rotation history, failover test results, model benchmarks in one place.
- **Phoenix Salon + Spa**: Client photos, branding guidelines, social content calendar, A/B test results — all agent-accessible for content gen.
- **Future-proof**: When you add a new agent or switch models (Qwen → newer), just point it at this vault. It instantly knows your entire context, goals, and history.
- **Self-awareness**: Use Obsidian Graph or Memory Galaxy-style views to see which projects/notes are "brightest" (most updated).

## Next Actions for You

- [ ] Copy vault to your machine and open in Obsidian.
- [ ] Run initialization with your main agent (Hermes or Claude).
- [ ] Create first daily maintenance cron/scheduled task.
- [ ] Add OMI later if you want passive capture (optional — your agent logs already provide strong signal).
- [ ] Version the vault lightly with Git (track only the note folders, ignore .obsidian/ cache).

This vault + your existing skill + local models = a truly sovereign, compounding AI memory system.

**"The vault doesn't just store what you tell it, it stores what your agents actually worked on."** — Goldie

Now go build the infinite context engine. Your agents will thank you (and perform better every day).