analyzing-kb-gaps

name	analyzing-kb-gaps
description	Use when you have Knowledge Base exports and want to identify user pain points, missing articles, and AI assistance opportunities.

Analyzing KB Gaps

Overview

Uses the Knowledge Base as a proxy for where users struggle. Identifies high-volume topics, missing guidance, and opportunities for better self-service or AI-assisted resolution.

When to Use

• Have KB article exports to analyze
• Want to understand what users struggle with most
• Exploring AI assistant opportunities
• Planning documentation improvements

Core Pattern

Step 1: Gather Sources

Read files in:

• inputs/knowledge_base/ - KB article exports
• outputs/insights/voc-synthesis-*.md - VOC insights (if available, for correlation)

Step 2: Analyze Article Coverage

For each KB article (or category), note:

• Topic / Category
• Article count
• Last updated date
• Estimated complexity (simple how-to vs. complex troubleshooting)

Step 3: Identify Gaps

Look for:

1. High-volume topics - Many articles = users struggle here
2. Outdated articles - Not updated in 6+ months
3. Missing topics - VOC mentions issues with no KB coverage
4. Complex troubleshooting - Multi-step processes that could be simplified

Step 4: Assess AI Opportunities

For each gap, evaluate:

Opportunity Type	Criteria	Risk Level