# agricidaniel/compass architecture

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

- Interactive diagram: https://gitdiagram.com/agricidaniel/compass
- Repository: https://github.com/agricidaniel/compass

## Overview

Life OS is an Obsidian vault template for journaling, planning, tracking, reading, task management, and writing, with the Life OS application providing navigation, capture, and live dashboards. The principal workflow starts with daily questions in a journal note, then uses the resulting notes and properties in dashboards and broader planning. The graph preserves the other documented workflows and the optional AI and research layers. Edges are based on the README or sampled view code; unsampled plugin internals are represented only at the documented capability level.

Main entry points: [`01 Journal/Daily`](https://github.com/agricidaniel/compass/tree/main/01%20Journal/Daily) (Daily Journal), [`Meta/Compass Config.md`](https://github.com/agricidaniel/compass/blob/main/Meta/Compass%20Config.md) (Vault Config), [`06 Writing`](https://github.com/agricidaniel/compass/tree/main/06%20Writing) (Writing Boards), [`Templates/Daily Questions Prompt.md`](https://github.com/agricidaniel/compass/blob/main/Templates/Daily%20Questions%20Prompt.md) (Daily Questions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflows["Life Workflows"]
  node_daily["Daily Journal"]
  node_questions["Daily Questions"]
  node_retreat["Quarterly Retreat"]
  node_planning["Multi-scale Planning"]
  node_habits["Habit Tracking<br/>[Habit Canvas.md]"]
  node_reading["Daily Reading"]
  node_tasks["Task Management<br/>[Tasks.md]"]
  node_writing["Writing Boards"]
end

subgraph group_dashboards["Dashboards and Config"]
  node_config["Vault Config<br/>[Compass Config.md]"]
  node_dashboard["Compass Dashboard"]
  node_setup["Setup Checklist<br/>[Setup.md]"]
  node_question_view["Question Analytics<br/>[dailyquestions.js]"]
  node_habit_view["Habit Canvas View<br/>[habits.js]"]
  node_wheel_view["Retreat Wheel View<br/>[wheel.js]"]
  node_board_view["Boards View<br/>[boards.js]"]
end

subgraph group_app["Life OS Application"]
  node_life_app["Life OS App<br/>[main.js]"]
end

subgraph group_agents["AI and Knowledge"]
  node_prompts["Agent Prompts"]
  node_agent_client["Agent Client<br/>[main.js]"]
  node_knowledge["Knowledge Layer"]
end

subgraph group_research["Research and Publishing"]
  node_research_tools["Research Tools<br/>[plugins]"]
  node_writing_templates["Writing Templates"]
end

node_person(("Vault User"))

node_person -->|"records daily"| node_daily
node_person -->|"answers questions"| node_questions
node_questions -->|"fills properties"| node_daily
node_daily -->|"provides properties"| node_question_view
node_daily -->|"provides properties"| node_habit_view
node_person -->|"reviews quarterly"| node_retreat
node_retreat -->|"provides scores"| node_wheel_view
node_person -->|"plans across scales"| node_planning
node_person -->|"tracks habits"| node_habits
node_person -->|"follows reading plan"| node_reading
node_person -->|"manages tasks"| node_tasks
node_person -->|"moves writing"| node_writing
node_writing -->|"board status read"| node_board_view
node_config -->|"sets question prefix"| node_question_view
node_config -->|"sets habit prefix"| node_habit_view
node_config -->|"sets retreat settings"| node_wheel_view
node_person -->|"navigates and captures"| node_life_app
node_life_app -->|"shows live dashboards"| node_dashboard
node_setup -->|"guides setup"| node_person
node_person -->|"runs recurring prompts"| node_prompts
node_prompts -.->|"invokes agent"| node_agent_client
node_person -.->|"uses knowledge layer"| node_knowledge
node_person -.->|"uses research features"| node_research_tools
node_writing_templates -->|"structures writing"| node_writing

click node_daily "https://github.com/agricidaniel/compass/tree/main/01%20Journal/Daily"
click node_questions "https://github.com/agricidaniel/compass/blob/main/Templates/Daily%20Questions%20Prompt.md"
click node_retreat "https://github.com/agricidaniel/compass/tree/main/02%20Retreats"
click node_planning "https://github.com/agricidaniel/compass/tree/main/03%20Planning"
click node_habits "https://github.com/agricidaniel/compass/blob/main/00%20Dashboards/Habit%20Canvas.md"
click node_reading "https://github.com/agricidaniel/compass/tree/main/09%20Reading"
click node_tasks "https://github.com/agricidaniel/compass/blob/main/08%20Tasks/Tasks.md"
click node_writing "https://github.com/agricidaniel/compass/tree/main/06%20Writing"
click node_config "https://github.com/agricidaniel/compass/blob/main/Meta/Compass%20Config.md"
click node_dashboard "https://github.com/agricidaniel/compass/blob/main/00%20Dashboards/Compass%20Dashboard.md"
click node_setup "https://github.com/agricidaniel/compass/blob/main/00%20Dashboards/Setup.md"
click node_question_view "https://github.com/agricidaniel/compass/blob/main/Meta/views/dailyquestions.js"
click node_habit_view "https://github.com/agricidaniel/compass/blob/main/Meta/views/habits.js"
click node_wheel_view "https://github.com/agricidaniel/compass/blob/main/Meta/views/wheel.js"
click node_board_view "https://github.com/agricidaniel/compass/blob/main/Meta/views/boards.js"
click node_life_app "https://github.com/agricidaniel/compass/blob/main/.obsidian/plugins/life-os-app/main.js"
click node_prompts "https://github.com/agricidaniel/compass/tree/main/Prompts"
click node_agent_client "https://github.com/agricidaniel/compass/blob/main/.obsidian/plugins/agent-client/main.js"
click node_knowledge "https://github.com/agricidaniel/compass/tree/main/wiki"
click node_research_tools "https://github.com/agricidaniel/compass/tree/main/.obsidian/plugins"
click node_writing_templates "https://github.com/agricidaniel/compass/tree/main/Templates"

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_daily,node_questions,node_retreat,node_planning,node_habits,node_reading,node_tasks,node_writing,node_person toneBlue
class node_config,node_dashboard,node_setup,node_question_view,node_habit_view,node_wheel_view,node_board_view toneAmber
class node_life_app toneMint
class node_prompts,node_agent_client,node_knowledge toneRose
class node_research_tools,node_writing_templates toneIndigo
```

## Components

### Life Workflows

- [Daily Journal](https://github.com/agricidaniel/compass/tree/main/01%20Journal/Daily): `01 Journal/Daily`
- [Daily Questions](https://github.com/agricidaniel/compass/blob/main/Templates/Daily%20Questions%20Prompt.md): `Templates/Daily Questions Prompt.md`
- [Quarterly Retreat](https://github.com/agricidaniel/compass/tree/main/02%20Retreats): `02 Retreats`
- [Multi-scale Planning](https://github.com/agricidaniel/compass/tree/main/03%20Planning): `03 Planning`
- [Habit Tracking](https://github.com/agricidaniel/compass/blob/main/00%20Dashboards/Habit%20Canvas.md): `00 Dashboards/Habit Canvas.md`
- [Daily Reading](https://github.com/agricidaniel/compass/tree/main/09%20Reading): `09 Reading`
- [Task Management](https://github.com/agricidaniel/compass/blob/main/08%20Tasks/Tasks.md): `08 Tasks/Tasks.md`
- [Writing Boards](https://github.com/agricidaniel/compass/tree/main/06%20Writing): `06 Writing`

### Dashboards and Config

- [Vault Config](https://github.com/agricidaniel/compass/blob/main/Meta/Compass%20Config.md): `Meta/Compass Config.md`
- [Compass Dashboard](https://github.com/agricidaniel/compass/blob/main/00%20Dashboards/Compass%20Dashboard.md): `00 Dashboards/Compass Dashboard.md`
- [Setup Checklist](https://github.com/agricidaniel/compass/blob/main/00%20Dashboards/Setup.md): `00 Dashboards/Setup.md`
- [Question Analytics](https://github.com/agricidaniel/compass/blob/main/Meta/views/dailyquestions.js): `Meta/views/dailyquestions.js`
- [Habit Canvas View](https://github.com/agricidaniel/compass/blob/main/Meta/views/habits.js): `Meta/views/habits.js`
- [Retreat Wheel View](https://github.com/agricidaniel/compass/blob/main/Meta/views/wheel.js): `Meta/views/wheel.js`
- [Boards View](https://github.com/agricidaniel/compass/blob/main/Meta/views/boards.js): `Meta/views/boards.js`

### Life OS Application

- [Life OS App](https://github.com/agricidaniel/compass/blob/main/.obsidian/plugins/life-os-app/main.js): `.obsidian/plugins/life-os-app/main.js`

### AI and Knowledge

- [Agent Prompts](https://github.com/agricidaniel/compass/tree/main/Prompts): `Prompts`
- [Agent Client](https://github.com/agricidaniel/compass/blob/main/.obsidian/plugins/agent-client/main.js): `.obsidian/plugins/agent-client/main.js`
- [Knowledge Layer](https://github.com/agricidaniel/compass/tree/main/wiki): `wiki`

### Research and Publishing

- [Research Tools](https://github.com/agricidaniel/compass/tree/main/.obsidian/plugins): `.obsidian/plugins`
- [Writing Templates](https://github.com/agricidaniel/compass/tree/main/Templates): `Templates`

### Other components

- **Vault User**

## Connections

- Vault User → Daily Journal: records daily (evidence: `README.md`)
- Vault User → Daily Questions: answers questions (evidence: `README.md`)
- Daily Questions → Daily Journal: fills properties (evidence: `README.md`)
- Daily Journal → Question Analytics: provides properties (evidence: `Meta/views/dailyquestions.js`)
- Daily Journal → Habit Canvas View: provides properties (evidence: `Meta/views/habits.js`)
- Vault User → Quarterly Retreat: reviews quarterly (evidence: `README.md`)
- Quarterly Retreat → Retreat Wheel View: provides scores (evidence: `Meta/views/wheel.js`)
- Vault User → Multi-scale Planning: plans across scales (evidence: `README.md`)
- Vault User → Habit Tracking: tracks habits (evidence: `README.md`)
- Vault User → Daily Reading: follows reading plan (evidence: `README.md`)
- Vault User → Task Management: manages tasks (evidence: `README.md`)
- Vault User → Writing Boards: moves writing (evidence: `README.md`)
- Writing Boards → Boards View: board status read (evidence: `Meta/views/boards.js`)
- Vault Config → Question Analytics: sets question prefix (evidence: `Meta/views/dailyquestions.js`)
- Vault Config → Habit Canvas View: sets habit prefix (evidence: `Meta/views/habits.js`)
- Vault Config → Retreat Wheel View: sets retreat settings (evidence: `Meta/views/wheel.js`)
- Vault User → Life OS App: navigates and captures (evidence: `README.md`)
- Life OS App → Compass Dashboard: shows live dashboards (evidence: `README.md`)
- Setup Checklist → Vault User: guides setup
- Vault User → Agent Prompts: runs recurring prompts (evidence: `README.md`)
- Agent Prompts → Agent Client: invokes agent (evidence: `README.md`)
- Vault User → Knowledge Layer: uses knowledge layer (evidence: `README.md`)
- Vault User → Research Tools: uses research features (evidence: `README.md`)
- Writing Templates → Writing Boards: structures writing (evidence: `README.md`)