pkm-framework

name	pkm-framework
description	Comprehensive Personal Knowledge Management framework for Obsidian with temporal reviews, capture, linking, and analytics

PKM Framework

A complete Personal Knowledge Management system for Obsidian vaults with temporal reviews, smart capture, note linking, and analytics. Designed to work seamlessly with Periodic Notes and integrate with your daily workflow.

Overview

The PKM Framework provides a structured approach to managing knowledge in Obsidian, with a focus on:

• Temporal Reviews: Daily, weekly, and monthly reflection and planning
• Smart Capture: Quick note and meeting capture workflows
• Note Linking: Intelligent connections between related notes
• Organization: Project management and Zettelkasten support
• Analytics: Insights into your PKM system health and usage

Features

🗓️ Temporal Reviews

Build a consistent review habit with automated temporal note management:

• Daily Setup (/pkm:daily-setup) - Morning routine to start your day with yesterday's summary and carried-over tasks
• Daily Review (/pkm:daily-review) - Evening reflection with tasks completed, time usage, insights, and tomorrow's suggestions
• Weekly Review (/pkm:weekly-review) - Weekly summary aggregating 7 days with KPIs, project status, and next week's priorities
• Monthly Review (/pkm:monthly-review) - Monthly overview aggregating weekly data with goal tracking and long-term patterns

📝 Smart Capture (Coming Soon)

Capture information quickly without disrupting your flow:

• Quick Capture - Rapid note capture to inbox or daily note
• Meeting Notes - Structured meeting notes with calendar integration

🔗 Note Linking (Coming Soon)

Build a connected knowledge base:

• Smart Linking - Automatically suggest relevant note connections
• Backlink Analysis - Analyze note connections and identify clusters

📂 Organization (Coming Soon)

Keep your vault organized and maintainable:

• Project Notes - Project note management and tracking
• Zettelkasten - Atomic note creation with proper linking
• Periodic Cleanup - Archive and cleanup old notes

📊 Analytics (Coming Soon)

Understand your PKM system:

• PKM Statistics - System health, usage statistics, and trends

Quick Start

Prerequisites

1. Obsidian with required plugins:

   • Periodic Notes (required)
   • TaskNotes (required) - For task management

2. Vault structure:

   ~/Obsidian/Altellus/
   ├── 00_Inbox/
   │   └── Tasks/              (TaskNotes tasks)
   ├── 20_Notes/
   │   └── Journal/
   │       └── YYYY/Mnn/
   │           ├── YYYY-MM-DD.md   (daily notes)
   │           ├── YYYY-Www.md     (weekly notes)
   │           └── YYYY-Mmm.md     (monthly notes)
   └── 90_Templates/
       └── Temporal/
           └── Daily.md
   

3. gcalcli (optional, for calendar integration):

   pip install gcalcli
   gcalcli init  # OAuth setup
   

Installation

The PKM Framework is available as a plugin in the Claude Code marketplace:

# Install via marketplace (when available)
/skills install pkm-framework

Basic Workflow

Morning Routine:

/pkm:daily-setup

Evening Routine:

/pkm:daily-review

Weekly Review (Friday or Sunday):

/pkm:weekly-review

Monthly Review (End of month):

/pkm:monthly-review

Commands Reference

Main Command

• /pkm - Main PKM menu (displays available commands)

Temporal Reviews

• /pkm:daily-setup - Generate morning Daily Notes section
• /pkm:daily-review - Complete evening Daily Review section
• /pkm:weekly-review - Generate Weekly Summary
• /pkm:monthly-review - Generate Monthly Summary

Capture (Coming Soon)

• /pkm:quick-capture - Quick capture to inbox or daily note
• /pkm:meeting-notes - Create meeting note with calendar sync

Linking (Coming Soon)

• /pkm:note-linking - Smart linking between related notes
• /pkm:backlink-analysis - Analyze note connections

Organization (Coming Soon)

• /pkm:project-notes - Project note management
• /pkm:zettelkasten - Create atomic note
• /pkm:periodic-cleanup - Archive old notes

Analytics (Coming Soon)

• /pkm:stats - PKM system statistics

Configuration

Obsidian Vault Path

The default vault path is ~/Obsidian/Altellus. If your vault is located elsewhere, you'll need to update the paths in the command files.

Required Obsidian Plugins

1. Periodic Notes - For temporal note structure
2. Templater (optional) - For advanced templates
3. Dataview (optional) - For query-based views

Integration with Google Calendar

The daily review feature integrates with Google Calendar through the gcal-review skill. Ensure you have calendar access configured.

Vault Structure

Required Folders

20_Notes/
  Journal/           # Temporal notes (daily, weekly, monthly)
    YYYY/
      Mnn/
        YYYY-MM-DD.md   # Daily notes
        YYYY-Www.md     # Weekly notes
        YYYY-Mmm.md     # Monthly notes
  Projects/          # Project notes (future)
  Zettels/          # Atomic notes (future)
  Meetings/         # Meeting notes (future)
  Inbox/            # Quick capture (future)

90_Templates/
  Temporal/         # Temporal note templates
    Daily.md        # Daily note template
    Weekly.md       # Weekly note template (future)
    Monthly.md      # Monthly note template (future)

Workflows

Daily Workflow

Morning (5 minutes):

1. Run /pkm:daily-setup
2. Review yesterday's summary
3. Check carried-over tasks
4. Set today's focus

During the day:

• Add notes and tasks to daily note
• Track pomodoros in YAML frontmatter
• Link to related notes

Evening (5-10 minutes):

1. Run /pkm:daily-review
2. Review completed tasks
3. Reflect on time usage
4. Capture insights
5. Plan tomorrow

Weekly Workflow

Friday or Sunday (20-30 minutes):

1. Run /pkm:weekly-review
2. Review weekly highlights
3. Check KPIs and patterns
4. Assess project status
5. Identify blockers
6. Set next week's priorities

Monthly Workflow

End of month (30-45 minutes):

1. Run /pkm:monthly-review
2. Review monthly achievements
3. Check goal progress
4. Identify long-term patterns
5. Address persistent blockers
6. Set next month's objectives

Data Formats

Daily Note YAML Frontmatter (TaskNotes)

---
para: Note
type: journal
pomodoros:
  - id: "1763434005196"
    startTime: 2025-11-18T11:46:45.196+09:00
    endTime: 2025-11-18T12:02:13.144+09:00
    plannedDuration: 25
    type: work
    taskPath: 00_Inbox/ELEGNT 논문.md
    completed: true
---

Task Format (TaskNotes)

• Incomplete: - [ ] [[Task Name]]
• Completed: - [x] [[Task Name]] ✅ 2025-11-19
• Tasks are individual markdown files in 00_Inbox/Tasks/

Pomodoro Display

• Visual: ELEGNT 논문 - 🍅🍅🍅: 3
• Total: 총 🍅🍅🍅🍅: 4 pomodoros
• Count: Length of pomodoros array in YAML

Time Tracking

• Pomodoros: From TaskNotes YAML pomodoros array
• Calendar events: From gcalcli (00_Schedule calendar)
• Task tracking: TaskNotes task files + wikilinks

Integration with TaskNotes

Task Management

• Tasks stored in 00_Inbox/Tasks/ as individual markdown files
• Referenced in daily notes as - [ ] [[Task Name]] wikilinks
• Completed tasks: - [x] [[Task Name]] ✅ YYYY-MM-DD

Pomodoro Tracking

• TaskNotes tracks pomodoros in YAML frontmatter
• Each pomodoro includes: startTime, endTime, taskPath
• PKM Framework reads pomodoros array length for totals

Calendar Sync (gcalcli)

• Time blocks created from tasks: /pkm:gcal-block
• Task completion synced to calendar: /pkm:gcal-complete
• Calendar events displayed in daily review
• 00_Schedule calendar only

Troubleshooting

Daily note not found

• Ensure Periodic Notes plugin is configured correctly
• Check vault path is ~/Obsidian/Altellus
• Verify folder structure exists

Tasks not recognized

• Ensure TaskNotes plugin is installed and configured
• Task files must be in 00_Inbox/Tasks/ folder
• Use wikilink format: - [ ] [[Task Name]]

Calendar integration not working

• Install gcalcli: pip install gcalcli
• Authenticate: gcalcli init
• Verify 00_Schedule calendar exists in Google Calendar

Pomodoros showing zeros

• Verify TaskNotes is tracking pomodoros
• Check YAML frontmatter has pomodoros array
• Ensure pomodoro tracking is enabled in TaskNotes settings

Related notes not auto-filled

• Ensure daily note has Notes section
• Verify pomodoros have taskPath field
• Check wikilinks are properly formatted: [[Note Name]]

Version

Current Version: 1.0.0

What's Included (Phase 1)

• ✅ Daily Setup skill
• ✅ Daily Review skill
• ✅ Weekly Review skill
• ✅ Monthly Review skill
• ✅ Temporal workflow documentation

Coming in Future Versions

• 📝 Capture skills (quick-capture, meeting-notes)
• 🔗 Linking skills (note-linking, backlink-analysis)
• 📂 Organization skills (project-notes, zettelkasten, periodic-cleanup)
• 📊 Analytics skills (pkm-stats)

Contributing

This PKM Framework is designed to be extensible. Future skills can be added to enhance the system.

License

Part of the Collaborator plugin collection.

Support

For issues, questions, or feature requests, please refer to the main documentation in ./docs/pkm/.