knowledge-management

Knowledge Management Plugin

Personal knowledge management system for organizing files, cataloging literature, and maintaining consistent knowledge architecture.

Now configurable per-project - works with ANY folder structure, not just the author's.

Quick Start

# 1. Initialize configuration for your project
/km:init

# 2. Start organizing
/organize ~/Downloads/new-paper.pdf
/catalog Literature/Philosophy

Configuration

This plugin requires a configuration file to know YOUR folder structure:

.claude/knowledge-management.local.md

Run /km:init to create this file interactively, or copy from config.example.md.

Minimal Config

---
base_path: ~/Documents

paths:
  areas: ${base_path}/Areas
  library: ${base_path}/Library

library_structure:
  reference: Reference
  guides: Guides
  resources: Resources

literature_path: ${paths.library}/${library_structure.resources}/Literature
---

Full Config Options

See config.example.md for all options including:

• Custom area categories
• Literature topic folders
• Naming conventions
• Classification keywords

Features

Agents

Agent	Purpose
knowledge-architect	Orchestrates organization, decides where content belongs
literature-cataloger	Extracts PDF metadata, generates summaries

Commands

Command	Description
/km:init	Initialize configuration for your project
/catalog [folder]	Catalog PDFs in a Literature folder
/organize [content]	Determine where content belongs

Skills

Skill	Triggers
init-config	"set up knowledge management", "configure km"
catalog-literature	"catalog papers", "index PDFs"
organize-content	"where should I put", "how to organize"

Usage Examples

# Initialize (required first time)
/km:init

# Catalog all PDFs in Philosophy folder
/catalog Literature/Philosophy

# Figure out where to put a file
/organize ~/Downloads/new-paper.pdf

# Use the knowledge architect agent
"Use knowledge-architect to organize my Downloads folder"

How It Works

The plugin reads your .claude/knowledge-management.local.md config to understand:

1. Where your folders are - Areas, Library, GTD, Learning, etc.
2. How you structure knowledge - Reference vs Guides vs Resources
3. Your naming conventions - File patterns, PDF naming
4. Your categories - Life domains, literature topics

Then it applies PKM principles (PARA, Zettelkasten) to help organize content according to YOUR system.

PDF Naming Convention

Default pattern (configurable):

AuthorLastName_Year__ShortTitle.pdf

Examples:
- Kahneman_2011__Thinking-Fast-and-Slow.pdf
- Ries-Trout_2001__Positioning.pdf
- Johnson-etal_2020__ML-Basics.pdf

Privacy

Your config file (.claude/knowledge-management.local.md) is gitignored by default. It contains your personal folder paths and won't be committed to version control.

Installation

# From Claude Code
claude plugins install knowledge-management

# Or clone and install locally
git clone https://github.com/orbruno/knowledge-management.git
claude plugins install ./knowledge-management

---

Author: Orlando Bruno Version: 2.0.0 License: MIT