From 5fcbae3fdba11f2c49ea65d07150bdf60c428b93 Mon Sep 17 00:00:00 2001
From: phernandez <paul@basicmachines.co>
Date: Fri, 28 Nov 2025 13:58:19 -0600
Subject: [PATCH] feat: Add /organize slash command for knowledge graph
 maintenance
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

User-invoked command to complement the knowledge-organize skill.

Actions:
- /organize health - Quick overview of KB status (default)
- /organize orphans - Find notes with no relations
- /organize duplicates - Find similar/overlapping notes
- /organize relations [note] - Suggest connections for a note
- /organize tags - Review and normalize tag consistency

Always confirms before modifying notes.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: phernandez <paul@basicmachines.co>
---
 PLUGIN.md            | 22 ++++++++++-
 commands/organize.md | 87 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 108 insertions(+), 1 deletion(-)
 create mode 100644 commands/organize.md

diff --git a/PLUGIN.md b/PLUGIN.md
index e957d9f1..75f199c0 100644
--- a/PLUGIN.md
+++ b/PLUGIN.md
@@ -101,6 +101,25 @@ Show recent activity in Basic Memory.
 /recent today specs
 ```
 
+### `/organize [action] [project]`
+
+Organize and maintain your knowledge graph.
+
+```
+/organize                    # Quick health check
+/organize orphans            # Find unlinked notes
+/organize duplicates         # Find similar notes
+/organize relations "Note"   # Suggest links for a note
+/organize tags               # Review tag consistency
+```
+
+Actions:
+- `health` - Overview of knowledge base status (default)
+- `orphans` - Find notes with no relations
+- `duplicates` - Find overlapping notes
+- `relations` - Suggest connections
+- `tags` - Review tag consistency
+
 ---
 
 ## Skills
@@ -232,7 +251,8 @@ basic-memory/
 │   ├── remember.md          # /remember command
 │   ├── continue.md          # /continue command
 │   ├── context.md           # /context command
-│   └── recent.md            # /recent command
+│   ├── recent.md            # /recent command
+│   └── organize.md          # /organize command
 ├── skills/
 │   ├── knowledge-capture/
 │   ├── continue-conversation/
diff --git a/commands/organize.md b/commands/organize.md
new file mode 100644
index 00000000..db5a22c2
--- /dev/null
+++ b/commands/organize.md
@@ -0,0 +1,87 @@
+---
+description: Organize and maintain your Basic Memory knowledge graph
+argument-hint: [health|orphans|duplicates|relations|tags] [project]
+allowed-tools: mcp__basic-memory__search_notes, mcp__basic-memory__read_note, mcp__basic-memory__list_directory, mcp__basic-memory__edit_note, mcp__basic-memory__write_note
+---
+
+# Organize
+
+Help organize, link, and maintain your Basic Memory knowledge graph.
+
+## Arguments
+
+- `$1` - Action (optional): `health`, `orphans`, `duplicates`, `relations`, `tags` (default: `health`)
+- `$2` - Project (optional): defaults to "main"
+
+## Actions
+
+### `/organize` or `/organize health`
+
+Run a quick health check:
+1. Count total notes
+2. Identify orphan notes (no relations)
+3. Check for potential duplicates
+4. Show folder distribution
+5. Report any issues found
+
+### `/organize orphans`
+
+Find and address orphan notes:
+1. Search for notes with empty Relations sections
+2. List orphans found
+3. For each orphan, suggest potential relations based on content
+4. Offer to add relations or create index notes
+
+### `/organize duplicates`
+
+Find potentially duplicate notes:
+1. Search for notes with similar titles
+2. Compare content for overlap
+3. Suggest: merge, differentiate, or link with `supersedes`
+
+### `/organize relations [note-title]`
+
+Suggest relations for a specific note (or recent notes if not specified):
+1. Read the target note
+2. Search for related content
+3. Suggest relation types:
+   - `relates-to` - General connection
+   - `extends` - Builds upon
+   - `implements` - Realizes concept
+   - `depends-on` - Requires understanding of
+4. Offer to add selected relations
+
+### `/organize tags`
+
+Review tag consistency:
+1. Gather all tags across notes
+2. Find similar/duplicate tags (e.g., `arch` vs `architecture`)
+3. Identify over-used or under-used tags
+4. Suggest normalization
+
+## Your Task
+
+Execute: `/organize $ARGUMENTS`
+
+Based on the action requested:
+
+1. **Gather data** using search and list tools
+2. **Analyze** for the specific issue (orphans, duplicates, etc.)
+3. **Present findings** clearly with counts and examples
+4. **Offer solutions** - ask before making changes
+5. **Apply fixes** using edit_note or write_note when user approves
+
+Always confirm before modifying notes. Show what will change and get approval.
+
+## Examples
+
+```
+/organize                    # Quick health check
+/organize health             # Same as above
+/organize orphans            # Find unlinked notes
+/organize duplicates         # Find similar notes
+/organize relations          # Suggest links for recent notes
+/organize relations "My Note" # Suggest links for specific note
+/organize tags               # Review tag consistency
+/organize health specs       # Health check on specs project
+```