From 2892916799290b09b2b4c044d6a360e222ecc867 Mon Sep 17 00:00:00 2001 From: watsonk1998 <1515673657@qq.com> Date: Mon, 13 Apr 2026 22:23:32 +0800 Subject: [PATCH] docs: add domain-specific templates and Obsidian integration guide --- AGENTS.md | 42 ++++++++++++++++++++++++++++++++++++++++++ CLAUDE.md | 42 ++++++++++++++++++++++++++++++++++++++++++ GEMINI.md | 42 ++++++++++++++++++++++++++++++++++++++++++ README.md | 21 +++++++++++++++++++-- 4 files changed, 145 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index ad99e24..1fe5a04 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -98,6 +98,48 @@ source_file: raw/... - Contradicts [[OtherPage]] on: ... ``` +### Domain-Specific Templates + +If the source falls into a specific domain (e.g., personal diary, meeting notes), the agent should use a specialized template instead of the default generic one above: + +#### Diary / Journal Template +```markdown +--- +title: "YYYY-MM-DD Diary" +type: source +tags: [diary] +date: YYYY-MM-DD +--- +## Event Summary +... +## Key Decisions +... +## Energy & Mood +... +## Connections +... +## Shifts & Contradictions +... +``` + +#### Meeting Notes Template +```markdown +--- +title: "Meeting Title" +type: source +tags: [meeting] +date: YYYY-MM-DD +--- +## Goal +... +## Key Discussions +... +## Decisions Made +... +## Action Items +... +``` + --- ## Query Workflow diff --git a/CLAUDE.md b/CLAUDE.md index a57d203..345219f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -101,6 +101,48 @@ source_file: raw/... - Contradicts [[OtherPage]] on: ... ``` +### Domain-Specific Templates + +If the source falls into a specific domain (e.g., personal diary, meeting notes), the agent should use a specialized template instead of the default generic one above: + +#### Diary / Journal Template +```markdown +--- +title: "YYYY-MM-DD Diary" +type: source +tags: [diary] +date: YYYY-MM-DD +--- +## Event Summary +... +## Key Decisions +... +## Energy & Mood +... +## Connections +... +## Shifts & Contradictions +... +``` + +#### Meeting Notes Template +```markdown +--- +title: "Meeting Title" +type: source +tags: [meeting] +date: YYYY-MM-DD +--- +## Goal +... +## Key Discussions +... +## Decisions Made +... +## Action Items +... +``` + --- ## Query Workflow diff --git a/GEMINI.md b/GEMINI.md index d15336b..3025c9d 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -94,6 +94,48 @@ source_file: raw/... - Contradicts [[OtherPage]] on: ... ``` +### Domain-Specific Templates + +If the source falls into a specific domain (e.g., personal diary, meeting notes), the agent should use a specialized template instead of the default generic one above: + +#### Diary / Journal Template +```markdown +--- +title: "YYYY-MM-DD Diary" +type: source +tags: [diary] +date: YYYY-MM-DD +--- +## Event Summary +... +## Key Decisions +... +## Energy & Mood +... +## Connections +... +## Shifts & Contradictions +... +``` + +#### Meeting Notes Template +```markdown +--- +title: "Meeting Title" +type: source +tags: [meeting] +date: YYYY-MM-DD +--- +## Goal +... +## Key Discussions +... +## Decisions Made +... +## Action Items +... +``` + --- ## Query Workflow diff --git a/README.md b/README.md index a0b5a48..4397152 100644 --- a/README.md +++ b/README.md @@ -206,10 +206,27 @@ The schema file tells the agent how to maintain the wiki — page formats, inges | Contradictions surface at query time (maybe) | Flagged at ingest time | | No accumulation | Every source makes the wiki richer | +## Obsidian Integration + +The wiki is designed to be browsed seamlessly in [Obsidian](https://obsidian.md). Since the agent maintains consistent `[[wikilinks]]`, you get a naturally growing knowledge graph in your vault. + +### Vault Symlink Pattern +If you want to keep the LLM Wiki Agent repository separate from your main personal vault, use symlinks: +1. Keep your working agent repository at e.g., `~/llm-wiki-agent` +2. Create a symlink from your main Obsidian vault: + ```bash + ln -sfn ~/llm-wiki-agent/wiki ~/your-obsidian-vault/wiki + ``` +3. Use the [Obsidian Web Clipper](https://obsidian.md/clipper) or write directly to `raw/` in the agent repo to queue items for ingestion. + +> **Note:** If you ever move your local repo directory, remember to update the symlink, otherwise the `wiki/` directory will appear missing in Obsidian. + +### Recommended .obsidian Config +- **Graph View:** Filter out `index.md` and `log.md` (e.g. `-file:index.md -file:log.md`) to avoid them becoming gravity wells in your Obsidian graph. +- **Dataview:** Use the community plugin [Dataview](https://blacksmithgu.github.io/obsidian-dataview/) to query the YAML frontmatter the agent automatically injects (e.g., `type: source`, `tags: [diary]`). + ## Tips -- Use [Obsidian](https://obsidian.md) to browse the wiki — follow links, check graph view, use Dataview for frontmatter queries -- Use [Obsidian Web Clipper](https://obsidian.md/clipper) to clip web articles directly to `raw/` - File good query answers back with `--save` — your explorations compound just like ingested sources - The wiki is a git repo — version history for free - Standalone Python scripts in `tools/` work without a coding agent (require `ANTHROPIC_API_KEY`)