62 lines
1.8 KiB
Markdown
62 lines
1.8 KiB
Markdown
# cosmic-brain — Claude + Obsidian Wiki Vault
|
|
|
|
This folder is both a Claude Code plugin and an Obsidian vault.
|
|
|
|
**Plugin name:** `cosmic-brain`
|
|
**Skills:** `/wiki`, `/wiki-ingest`, `/wiki-query`, `/wiki-lint`
|
|
**Vault path:** This directory (open in Obsidian directly)
|
|
|
|
## What This Vault Is For
|
|
|
|
[Fill this in when you first scaffold the vault. One sentence describing your purpose.]
|
|
|
|
## Vault Structure
|
|
|
|
```
|
|
.raw/ source documents — immutable, Claude reads but never modifies
|
|
wiki/ Claude-generated knowledge base
|
|
_templates/ Obsidian Templater templates
|
|
_attachments/ images and PDFs referenced by wiki pages
|
|
```
|
|
|
|
## How to Use
|
|
|
|
Drop a source file into `.raw/`, then tell Claude: "ingest [filename]".
|
|
|
|
Ask any question. Claude reads the index first, then drills into relevant pages.
|
|
|
|
Run `/wiki` to scaffold a new vault or check setup status.
|
|
|
|
Run "lint the wiki" every 10-15 ingests to catch orphans and gaps.
|
|
|
|
## Cross-Project Access
|
|
|
|
To reference this wiki from another Claude Code project, add to that project's CLAUDE.md:
|
|
|
|
```markdown
|
|
## Wiki Knowledge Base
|
|
Path: /path/to/this/vault
|
|
|
|
When you need context not already in this project:
|
|
1. Read wiki/hot.md first (recent context, ~500 words)
|
|
2. If not enough, read wiki/index.md
|
|
3. If you need domain specifics, read wiki/<domain>/_index.md
|
|
4. Only then read individual wiki pages
|
|
|
|
Do NOT read the wiki for general coding questions or things already in this project.
|
|
```
|
|
|
|
## Plugin Skills
|
|
|
|
| Skill | Trigger |
|
|
|-------|---------|
|
|
| `/wiki` | Setup, scaffold, route to sub-skills |
|
|
| `ingest [source]` | Single or batch source ingestion |
|
|
| `query: [question]` | Answer from wiki content |
|
|
| `lint the wiki` | Health check |
|
|
|
|
## MCP (Optional)
|
|
|
|
If you configured the MCP server, Claude can read and write vault notes directly.
|
|
See `skills/wiki/references/mcp-setup.md` for setup instructions.
|