# l4pislazuli/cursor_obsidian_vault architecture

> Architecture diagram of the GitHub repository l4pislazuli/cursor_obsidian_vault, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/l4pislazuli/cursor_obsidian_vault
- Repository: https://github.com/l4pislazuli/cursor_obsidian_vault

## Overview

1. **Repository purpose**
   This repo is not an application codebase; it is a **template Obsidian vault** for working with AI chat notes. It is designed to be cloned, personalized, and used as a combined **chat workspace + long-term knowledge base**.

2. **Top-level architecture**
   The vault is split into a few clear zones: **configuration** (`.cursor/`, `.obsidian/`), **content capture** (`chats/`), **synthesis** (`analysis/`), **personal metadata** (`profile/`), and **media attachments** (`assets/`). That separation is the core architectural boundary.

3. **AI-agent integration layer**
   `.cursor/rules/` contains the operational rules used by Cursor Cloud Agent. These rules define behavior by file scope: a global vault policy, separate handling for temp chats, persistent chats, analysis notes, frontmatter conventions, and Git-related changes. In other words, the repository is partly a **policy-driven workspace** for AI agents.

4. **Obsidian workspace layer**
   `.obsidian/` holds vault settings for Obsidian, including the default note location and community plugin configuration. The repo expects **Templater** to be installed, with `templates/` configured as the template source. This makes note creation a standardized workflow rather than ad hoc editing.

5. **Content lifecycle: temp → persistent → archive**
   `chats/temp/` is the short-lived intake area for transient conversations. Valuable notes are promoted into `chats/persistent/` for long-term retention. Within persistent, `_archive/` stores retired notes. This lifecycle is the main data flow for the vault.

6. **Analytical layer**
   `analysis/` is a separate synthesis space for cross-note analysis of persistent content. It is not just another note folder; it represents an **aggregation and interpretation boundary** above the raw chat notes. The README explicitly treats persistent notes as the source material for analysis notes.

7. **Template system**
   `templates/` contains the note skeletons used to keep metadata and structure consistent: one each for temp chats, persistent chats, and analysis notes. These templates enforce the note lifecycle by making the right frontmatter and layout easy to create repeatedly.

8. **Personalization boundary**
   `profile/user.example.md` is the sample user profile, while `profile/user.md` is the private personal file excluded from Git. This is the repo’s main privacy boundary: the vault is public-template friendly, but user-specific details stay local and untracked.

9. **Media and attachments**
   `assets/` is a shared attachment bucket, typically for images or other files referenced from notes. The naming guidance in the README implies attachments are tied back to note context, supporting traceability across the vault.

10. **Metadata conventions**
   All notes are expected to follow a shared frontmatter schema with fields like `created`, `updated`, `tags`, `source`, `status`, `aliases`, and `related`. Analysis notes additionally track `sources_updated`. This schema is important because it enables AI-agent actions, note promotion, and later cross-note analysis.

11. **Operational and Git policy**
   The repo is meant for normal Git versioning, but with explicit guardrails: note content changes can be committed directly, while rule changes and folder restructuring are expected to go through branch/PR review. `.gitignore` excludes workspace artifacts and `profile/user.md`; `.gitattributes` enforces LF line endings for portability.

12. **Overall flow for diagramming**
   A useful architecture diagram would show: **Obsidian/Cursor users and agents create notes in temp using templates and rules; useful notes are promoted to persistent; persistent notes feed analysis; attachments live in assets; personal data stays in profile/user.md and out of Git; configuration lives in .obsidian and .cursor.** The repo’s architecture is therefore a governed knowledge pipeline rather than a software execution system.

Main entry points: [`.cursor/rules`](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules) (Cursor rules), [`templates`](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/templates) (Note templates), [`chats/persistent`](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/chats/persistent) (Persistent notes), [`chats/temp`](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/chats/temp) (Temp chats)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_config["Configuration"]
  node_node_cursor_rules["Cursor rules<br/>policy set<br/>[rules]"]
  node_node_vault_core_rule["Vault policy<br/>agent rule<br/>[vault-core.mdc]"]
  node_node_temp_rule["Temp chats<br/>agent rule<br/>[chat-temp.mdc]"]
  node_node_persistent_rule["Persistent chats<br/>agent rule"]
  node_node_analysis_rule["Analysis workflow<br/>agent rule"]
  node_node_frontmatter_rule["Frontmatter rules<br/>agent rule"]
  node_node_git_rule["Git policy<br/>agent rule<br/>[git-workflow.mdc]"]
  node_node_obsidian["Obsidian config<br/>workspace settings<br/>[.obsidian]"]
  node_node_templates_cfg["Template source<br/>workspace setting<br/>[templates.json]"]
end

subgraph group_group_content["Content lifecycle"]
  node_node_capture["Temp chats<br/>note zone"]
  node_node_persistent["Persistent notes<br/>note zone"]
  node_node_archive["Archive<br/>retention area"]
end

subgraph group_group_synthesis["Synthesis"]
  node_node_analysis["Analysis notes<br/>synthesis layer"]
end

subgraph group_group_personal["Personal data"]
  node_node_profile_dir["Profile<br/>metadata area"]
  node_node_profile_public["Profile example<br/>template profile<br/>[user.example.md]"]
  node_node_profile_private["Private profile<br/>local profile"]
end

subgraph group_group_support["Support files"]
  node_node_templates["Note templates"]
  node_node_assets[("Attachments<br/>media store")]
end

node_node_agents(("Users & agents<br/>actor"))

node_node_agents -->|"follows"| node_node_cursor_rules
node_node_cursor_rules -->|"includes"| node_node_vault_core_rule
node_node_cursor_rules -->|"includes"| node_node_temp_rule
node_node_cursor_rules -->|"includes"| node_node_persistent_rule
node_node_cursor_rules -->|"includes"| node_node_analysis_rule
node_node_cursor_rules -->|"includes"| node_node_frontmatter_rule
node_node_cursor_rules -->|"includes"| node_node_git_rule
node_node_agents -->|"uses"| node_node_obsidian
node_node_obsidian -->|"configures"| node_node_templates_cfg
node_node_templates_cfg -->|"points to"| node_node_templates
node_node_templates -->|"creates"| node_node_capture
node_node_templates -->|"creates"| node_node_persistent
node_node_templates -->|"creates"| node_node_analysis
node_node_agents -->|"captures"| node_node_capture
node_node_capture -->|"promotes to"| node_node_persistent
node_node_persistent -->|"retires to"| node_node_archive
node_node_persistent -->|"feeds"| node_node_analysis
node_node_agents -->|"attaches"| node_node_assets
node_node_profile_dir -->|"contains"| node_node_profile_public
node_node_profile_dir -->|"contains"| node_node_profile_private
node_node_profile_public -.->|"mirrors"| node_node_profile_private
node_node_git_rule -->|"excludes"| node_node_profile_private

click node_node_cursor_rules "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules"
click node_node_vault_core_rule "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/vault-core.mdc"
click node_node_temp_rule "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/chat-temp.mdc"
click node_node_persistent_rule "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/chat-persistent.mdc"
click node_node_analysis_rule "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/analysis-workflow.mdc"
click node_node_frontmatter_rule "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/obsidian-frontmatter.mdc"
click node_node_git_rule "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/git-workflow.mdc"
click node_node_obsidian "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.obsidian"
click node_node_templates_cfg "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.obsidian/templates.json"
click node_node_capture "https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/chats/temp"
click node_node_persistent "https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/chats/persistent"
click node_node_archive "https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/chats/persistent/_archive"
click node_node_analysis "https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/analysis"
click node_node_profile_dir "https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/profile"
click node_node_profile_public "https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/profile/user.example.md"
click node_node_templates "https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/templates"
click node_node_assets "https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/assets"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_node_cursor_rules,node_node_vault_core_rule,node_node_temp_rule,node_node_persistent_rule,node_node_analysis_rule,node_node_frontmatter_rule,node_node_git_rule,node_node_obsidian,node_node_templates_cfg toneBlue
class node_node_capture,node_node_persistent,node_node_archive toneAmber
class node_node_analysis toneMint
class node_node_profile_dir,node_node_profile_public,node_node_profile_private toneRose
class node_node_templates,node_node_assets toneIndigo
class node_node_agents toneNeutral
```

## Components

### Configuration

Workspace settings and agent policy files.

- [Cursor rules](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules): policy set · Scoped behavior rules for vault use, chat handling, frontmatter, and Git workflow. · `.cursor/rules`
- [Vault policy](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/vault-core.mdc): agent rule · Global rules for how the vault should be treated and edited. · `.cursor/rules/vault-core.mdc`
- [Temp chats](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/chat-temp.mdc): agent rule · Guidance for transient chat notes in the intake area. · `.cursor/rules/chat-temp.mdc`
- [Persistent chats](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/chat-persistent.mdc): agent rule · Guidance for durable chat notes and promotion to long-term storage. · `.cursor/rules/chat-persistent.mdc`
- [Analysis workflow](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/analysis-workflow.mdc): agent rule · Guidance for creating synthesis notes from persistent source material. · `.cursor/rules/analysis-workflow.mdc`
- [Frontmatter rules](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/obsidian-frontmatter.mdc): agent rule · Shared metadata conventions for note structure and fields. · `.cursor/rules/obsidian-frontmatter.mdc`
- [Git policy](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.cursor/rules/git-workflow.mdc): agent rule · Guardrails for commits, review boundaries, and repository changes. · `.cursor/rules/git-workflow.mdc`
- [Obsidian config](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.obsidian): workspace settings · Vault settings and plugin configuration for the note workspace. · `.obsidian`
- [Template source](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/.obsidian/templates.json): workspace setting · Obsidian template configuration pointing at the templates folder. · `.obsidian/templates.json`

### Content lifecycle

Capture, retention, and archival note flow.

- [Temp chats](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/chats/temp): note zone · Short-lived intake area for transient conversations. · `chats/temp`
- [Persistent notes](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/chats/persistent): note zone · Long-term retained chat notes and source material for analysis. · `chats/persistent`
- [Archive](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/chats/persistent/_archive): retention area · Retired persistent notes kept out of the active set. · `chats/persistent/_archive`

### Synthesis

Cross-note analysis layer.

- [Analysis notes](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/analysis): synthesis layer · Cross-note interpretation and aggregation over persistent notes. · `analysis`

### Personal data

User-specific profile metadata.

- [Profile](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/profile): metadata area · Personal metadata area with public example and local-only user data conventions. · `profile`
- [Profile example](https://github.com/l4pislazuli/cursor_obsidian_vault/blob/main/profile/user.example.md): template profile · Sample user profile showing the expected personal metadata shape. · `profile/user.example.md`
- **Private profile**: local profile · User-specific personal file kept private and excluded from Git.

### Support files

Templates and attachments.

- [Note templates](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/templates): templates · Skeletons for temp chats, persistent chats, and analysis notes. · `templates`
- [Attachments](https://github.com/l4pislazuli/cursor_obsidian_vault/tree/main/assets): media store · Shared location for images and other referenced files. · `assets`

### Other components

- **Users & agents**: actor · Cursor and Obsidian users that create, promote, and analyze notes.

## Connections

- Users & agents → Cursor rules: follows · Agents use scoped rules to decide how to edit and organize notes.
- Cursor rules → Vault policy: includes · Global vault behavior.
- Cursor rules → Temp chats: includes · Temp-chat handling.
- Cursor rules → Persistent chats: includes · Persistent-note handling.
- Cursor rules → Analysis workflow: includes · Analysis-note handling.
- Cursor rules → Frontmatter rules: includes · Frontmatter conventions.
- Cursor rules → Git policy: includes · Git and repo-change policy.
- Users & agents → Obsidian config: uses · Obsidian is the primary vault UI.
- Obsidian config → Template source: configures · Sets the template source location.
- Template source → Note templates: points to · Templates provide standard note skeletons.
- Note templates → Temp chats: creates · Temp note skeleton.
- Note templates → Persistent notes: creates · Persistent note skeleton.
- Note templates → Analysis notes: creates · Analysis note skeleton.
- Users & agents → Temp chats: captures · Transient conversations start in temp notes.
- Temp chats → Persistent notes: promotes to · Useful temp notes are retained long-term.
- Persistent notes → Archive: retires to · Old persistent notes move into archive.
- Persistent notes → Analysis notes: feeds · Persistent notes are the source material for analysis.
- Users & agents → Attachments: attaches · Shared media and files are stored centrally.
- Profile → Profile example: contains · Public example profile lives in the profile area.
- Profile → Private profile: contains · Local-only personal profile is kept alongside the example.
- Profile example → Private profile: mirrors · Example profile shows the shape of the private file.
- Git policy → Private profile: excludes · Private profile is kept out of Git.
