kb-answer

# KB Answer Workflow Follow these steps in order for every question. For multiple independent questions, use parallel agents. ## Prerequisites Check that `kb/` exists in the project root. If not, tell the user to run `/setup-knowledge-base` first. ## Step 1: Navigate Using the Index **Always start by reading the KB index:** ``` kb/index.md ``` The index provides: - **Keyword Lookup**: find the right file by keyword - **Category overview**: all files grouped by topic If the index is empty or outdated, run the index script first: ```bash python3 scripts/kb-index.py ``` ### Quick Navigation 1. Check the keyword lookup table for matching terms 2. Go to the matching file(s) 3. If no keyword match, browse the category that best fits the question. Categories can be nested (e.g., `security/access/`) — drill down into sub-groups when a broad category has them. ## Step 2: Read Relevant Files Based on the index navigation: 1. Read the most relevant file first 2. Check `related:` links in the frontmatter if the file references other entries 3. Read additional files if the first doesn't fully cover the question ## Step 3: Search (if needed) If the index doesn't point to the right file, run the search script to rank entries by keyword across title, tags, description, category, and body: ```bash python3 scripts/kb-search.py "your keyword" ``` Options worth knowing: - `--category security` restricts to a category (matches nested children like `security/access` too). - `--tag m...