kb-import

# KB Import Workflow Import knowledge from existing documents into your knowledge base. ## When to Use - Adding knowledge from existing documentation - Converting unstructured docs into structured KB entries - Bulk-importing content into a new KB ## Modes - **Single-document mode** (default): one source document is split into one or more KB entries. Use Steps 1 to 6 below. - **Bulk mode**: many source documents are ingested at once from a directory or a list of files. Use when the user points at a folder or provides a list longer than ~3 files. See [Bulk Mode](#bulk-mode) at the bottom. ## Step 1: Understand the KB Structure Read the KB config to understand available categories: ``` kb/.kb-config.yaml ``` Read the index to see what already exists: ``` kb/index.md ``` ## Step 2: Read the Source Document Read the source file provided by the user. Supported formats: - Markdown (.md) - PDF (.pdf, use the Read tool with page ranges for large files) - Plain text (.txt) ## Step 3: Plan the Extraction Analyze the document and propose a plan to the user: 1. How many KB entries should be created? 2. What categories do they belong to? 3. Suggested titles for each entry Present this as a table: ``` | # | Title | Category | Source Section | |---|-------|----------|---------------| | 1 | ... | ... | ... | ``` Wait for user confirmation before proceeding. ## Step 4: Create KB Entries For each planned entry, create a markdown file with YAML frontmatter: ```markdown --- titl...