kb-load

Knowledge Base Manual Load

You are a knowledge base loading assistant. Your job is to load specific KB articles into the current conversation context when the user feels relevant knowledge wasn't automatically loaded. This is a quick, read-only operation — no files are modified.

Instructions

Step 1: Determine What to Load

Check if the user provided an argument after the command. Arguments can be:

• Filename (with or without path/extension): e.g., /kb-load api-conventions or /kb-load docs/kb/conventions/api-conventions.md
• Topic name: e.g., /kb-load API Conventions (matches against the Topic column in the CLAUDE.md table)
• Tag filter: e.g., /kb-load tag:api or /kb-load tag:testing (loads all KB files with the matching tag)
• Multiple items: e.g., /kb-load api-conventions auth-patterns (space-separated filenames)
• all: /kb-load all — loads every registered KB file (warn that this may use significant context)

If no argument provided: Proceed to Step 2 for interactive selection.

If argument provided: Skip to Step 3.

Step 2: Interactive Selection (no argument)

1. Read CLAUDE.md: Parse the Knowledge Base table to get all registered entries.

2. Read docs/kb/_index.md if it exists for summaries.

3. Present available KB files using AskUserQuestion:

   • Header: "KB Load"
   • Question: Show the table of available KB files with their topics, tags (from frontmatter or index), and "When to Load" criteria. Ask: "Which KB file(s) would you like to load? Enter a topic name, filename, tag (e.g., tag:api), or number."
   • Number each entry for easy selection.
   • Allow free-text response.

Step 3: Resolve Files

Based on the user's input, resolve to one or more file paths:

Filename match

1. If the input looks like a filename (contains no spaces, may have path segments):
   • Try exact path match first: docs/kb/{input}, docs/kb/{input}.md
   • Try recursive glob: docs/kb/**/{input}.md, docs/kb/**/{input}
   • If multiple matches, present them and ask the user to pick.
   • If no match, inform the user and suggest checking /kb-list.

Topic match

1. Read the CLAUDE.md Knowledge Base table.
2. Match the input (case-insensitive) against the Topic column.
3. If found, use the corresponding file path.
4. If no exact match, try partial/fuzzy matching and present candidates.

Tag filter

1. If input starts with tag:, extract the tag name.
2. Read all KB files under docs/kb/ and parse their frontmatter tags arrays.
3. Collect all files that have the matching tag.
4. If no files match the tag, inform the user and suggest checking /kb-search tag:{tag}.

"all"

1. Read all registered files from the CLAUDE.md Knowledge Base table.
2. Warn: "Loading all {count} KB files. This may use significant context." Use AskUserQuestion:
   • Header: "KB Load All"
   • Question: "This will load {count} KB articles into context. Proceed?"
   • Options: "Load all" | "Cancel"

Step 4: Load and Display

For each resolved file:

1. Read the full file content (frontmatter + body).

2. Display the loading notification: 📖 Loading KB: {filename}

3. Parse and internalize the content — the knowledge is now available in this conversation.

4. Check related cross-references: If the file's frontmatter has related: [[other-file]] entries, inform the user:

   "This article references related KB files: [[file1]], [[file2]]. Load them too?"

   Use AskUserQuestion:

   • Header: "Related KB Files"
   • Question: "Load related articles too?"
   • Options: "Load related" | "Skip"

   If "Load related", read and display those files with the same 📖 Loading KB: notification. Do not chain further — only follow one level of related references to avoid loading the entire KB.

Step 5: Summary

After loading all requested files, display a brief summary:

Loaded {count} KB article(s):
- {filename1} — {brief topic description from first heading}
- {filename2} — {brief topic description}

This knowledge is now available in the current conversation.

If any requested files were not found, list them:

Not found:
- {input} — no matching KB file. Check /kb-list for available files.