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.