Product Differentiation Audit — Knowledge Hub
Re-filed S504 (ruling R9), from reference/: a point-in-time audit, not durable facts.
Product Differentiation Audit — Knowledge Hub
Section titled “Product Differentiation Audit — Knowledge Hub”Date: 19 March 2026 Purpose: Sales-ready competitive analysis and demo readiness assessment Context: Pre-client-access audit of what makes Knowledge Hub stand out and what gaps remain before a compelling demo
1. Competitive Landscape (Brief)
Section titled “1. Competitive Landscape (Brief)”Knowledge Hub competes in three overlapping categories. Understanding where it sits relative to each is essential for positioning.
1.1 Generic KB / Document Management
Section titled “1.1 Generic KB / Document Management”Notion, Confluence, SharePoint, Guru
These are general-purpose platforms. Their strengths are breadth, ecosystem integration, and large user bases. Their weaknesses for bid management:
- No semantic search (keyword only, or basic AI bolt-ons)
- No content-to-bid pipeline — no tender upload, no question extraction, no AI drafting
- No content freshness lifecycle — pages go stale silently
- No structured taxonomy with AI classification
- No coverage gap analysis or completeness tracking
- No win-rate feedback loop (which content correlates with winning bids)
Knowledge Hub advantage: Purpose-built for structured knowledge that feeds operational workflows (bids). Not a general wiki with a search bar.
1.2 Bid Management / Proposal Software
Section titled “1.2 Bid Management / Proposal Software”Loopio, RFPIO (Responsive), Qvidian, Breezy, AutogenAI
These focus on the bid/RFP response workflow. Their strengths are answer library management, collaboration, and compliance tracking. Their weaknesses:
- Knowledge base is a secondary feature — an answer library, not a structured KB
- AI features are typically answer suggestion or auto-fill, not a full drafting pipeline
- No progressive depth model (brief/detail/reference for the same content)
- No entity graph or knowledge relationships
- No MCP integration — AI is captive within the product, not accessible from external AI tools
- Vendor lock-in on the AI model (usually GPT-based with no transparency)
Knowledge Hub advantage: The KB is the product, not an accessory. AI is transparent (Claude, with visible confidence postures and citations) and accessible from any MCP-compatible surface.
1.3 AI-Enhanced Knowledge Platforms
Section titled “1.3 AI-Enhanced Knowledge Platforms”Glean, Guru AI, Notion AI, Microsoft Copilot + SharePoint
These bolt AI onto existing content stores. Their strengths are search quality and enterprise integration. Their weaknesses:
- AI is a search/Q&A layer on top of unstructured content — not a structured data model
- No domain taxonomy with provenance tracking (baseline/client/recommended)
- No content quality governance (freshness lifecycle, review-on-change, designated reviewers)
- No bid-specific workflow — these are horizontal tools
- No MCP server — AI interaction is locked to the vendor’s interface
- No content effectiveness tracking (which content leads to won bids)
Knowledge Hub advantage: AI is deeply integrated into the data model, not layered on top. The 4-layer AI architecture (MCP tools, MCP Apps, Plugin skills, Claude Code) is unique in the market.
2. Top 5 Differentiators
Section titled “2. Top 5 Differentiators”These are the features that no competitor offers in combination. Each is supported by evidence from the codebase.
Differentiator 1: Claude as Your KB Manager (The MCP Integration)
Section titled “Differentiator 1: Claude as Your KB Manager (The MCP Integration)”What it is: 38 MCP tools, 11 resources, 5 prompts, 3 interactive MCP Apps, a plugin with 6 commands and 5 domain skills — all accessible from Claude Desktop, Claude.ai, or CoWork. Users manage their knowledge base through natural conversation.
Why it matters: No competing product gives an external AI full read-write access to a structured knowledge base with per-user permissions. Users say “What’s changed since yesterday?” and get a personalised briefing. They say “Draft a response to this ISO 27001 question” and Claude searches the KB, applies UK procurement conventions, drafts with citations, and assesses confidence — all without opening the web app.
Evidence:
lib/mcp/tools/— 10 category files implementing 38 tools with full annotationslib/mcp/tools/search.ts— semantic search with vector embeddingslib/mcp/tools/bids.ts— bid drill-down with section grouping and confidence breakdownmcp-apps/— 3 interactive visual applications that render inside Claude’s conversation.claude/plugins/knowledge-hub/1.0.0/— 5 skills teaching Claude domain expertise (bid-writing, UK procurement, search strategy, knowledge synthesis, content governance)- OAuth 2.1 with per-user RLS — same permissions in Claude as in the web app
Demo moment: Open Claude Desktop, say “Show me the coverage matrix” — an interactive heatmap appears inline. Click a domain, see subtopics, identify gaps, then say “Create a draft article for the Data Handling subtopic” and watch Claude create the content item.
Differentiator 2: AI-Powered Bid Drafting with Evidence Trails
Section titled “Differentiator 2: AI-Powered Bid Drafting with Evidence Trails”What it is: A three-pass AI pipeline (analysis, drafting, quality check) that drafts bid responses sourced from KB content, with inline citations showing exactly which content was used.
Why it matters: Competing bid tools suggest answers from a library. Knowledge Hub drafts complete responses with proper citations, confidence assessment (strong match / partial match / needs SME / no content), and a quality check pass. The drafting pipeline uses three different model tiers (Sonnet for analysis, Opus for drafting, Haiku for quality check), optimising cost and quality.
Evidence:
lib/ai/draft.ts— three-pass pipeline withQuestionAnalysis,DraftResult, citations, cost estimationlib/ai/match.ts— confidence posture assessment with configurable thresholds (0.70 strong, 0.50 partial, 0.30 minimal)lib/ai/quality-check.ts— deterministic + AI quality verificationlib/citations.ts— citation extraction and tracking- Content effectiveness tracking via
get_content_win_rateRPC — which KB content correlates with won bids
Demo moment: Upload a tender PDF, watch questions get extracted with sections and word limits. Click “Draft All” and watch responses stream in with citation markers. Show the confidence posture badges — green for strong match, amber for partial, red for needs SME.
Differentiator 3: Content Quality Governance That Actually Works
Section titled “Differentiator 3: Content Quality Governance That Actually Works”What it is: An automated freshness lifecycle (fresh, ageing, stale, expired), review-on-change triggers, designated reviewers per domain, quality flagging, and a speed-review queue — all driven by configurable governance rules.
Why it matters: Every organisation’s KB decays. Competing products let content rot silently. Knowledge Hub actively monitors freshness, flags stale content, notifies reviewers, and surfaces quality issues. The coverage dashboard shows not just what exists but what is missing and what is going stale.
Evidence:
governance_configtable — per-domain review rules, designated reviewers, timeout settingscontent_historytable — immutable version snapshots with change type and attribution- Freshness cron job — daily automated transition monitoring
- Coverage alerts cron — weekly gap detection with notifications
- Classification quality cron — weekly audit of low-confidence classifications
lib/mcp/tools/quality.ts— 4 quality tools (quality summary, coverage gaps, content audit, duplicate finder)
Demo moment: Open the Coverage dashboard showing the domain-by-subtopic matrix. Red cells = gaps, amber = thin coverage. Click a gap to pre-fill content creation. Show the Review queue with keyboard shortcuts (J/K to navigate, A to approve, F to flag).
Differentiator 4: Structured Data Model with Progressive Depth
Section titled “Differentiator 4: Structured Data Model with Progressive Depth”What it is: Every content item has three human-authored depth fields (brief, detail, reference), AI-generated summaries (executive, detailed, takeaways), 14 content types, a configurable 4-layer vocabulary (Sales Brief, Bid Detail, Company Reference, Research), and a database-driven taxonomy with 7 domains and 34 subtopics.
Why it matters: Competing KBs store flat text. Knowledge Hub structures content so it can be used in different contexts — a sales conversation needs the brief, a bid response needs the detail, a compliance audit needs the reference. The AI classification system automatically assigns taxonomy on ingestion, and the entity graph (999 entities, 913 relationships) creates a knowledge network, not just a document store.
Evidence:
content_itemstable —brief,detail,reference,contentcolumns +summary_dataJSONBlib/client-config.ts— 4 configurable layers with labels and descriptionstaxonomy_domains+taxonomy_subtopicstables —provenancecolumn (baseline/client/recommended)content_entities+entity_relationshipstables — 6 entity types (person, organisation, concept, technology, standard, regulation)- ContentTabs component — tabbed display with human/AI toggle per depth level
Demo moment: Open a content item and show the Brief/Detail/Reference tabs. Toggle between human-authored and AI-generated summaries. Show the entity panel — “This item mentions ISO 27001, Cyber Essentials, and ICO — here are all other items that reference these same entities.”
Differentiator 5: The Feedback Loop (KB Feeds Bids, Bids Feed KB)
Section titled “Differentiator 5: The Feedback Loop (KB Feeds Bids, Bids Feed KB)”What it is: Content is cited in bid responses (tracked via
content_citations), bid outcomes are recorded (won/lost/withdrawn), and
win-rate statistics are calculated per content item. Winning bid responses can
be promoted back into the KB, creating a virtuous cycle.
Why it matters: No competing product tracks which knowledge base content leads to winning bids. This data becomes increasingly valuable over time — the organisation learns which content works and which does not. The win-signal search boost (deployed on both search RPCs) means that content proven in winning bids surfaces higher in future searches.
Evidence:
content_citationstable — tracks which content was used in which bid responseget_content_win_rateRPC — calculates citation count, winning citation count, and win ratecite_contentMCP tool — records citations during draftingget_content_effectivenessMCP tool — surfaces win-rate stats- Win-signal boost in
hybrid_searchandsearch_for_bid_responseRPCs —similarity * (1 + 0.03 * win_rate)
Demo moment: Show a content item’s effectiveness panel: “This ISO 27001 response has been used in 8 bids, 5 of which were won — 63% win rate. It now ranks higher in bid matching because the system knows it works.”
3. Demo Readiness Assessment
Section titled “3. Demo Readiness Assessment”What Is Ready for a 15-Minute Demo
Section titled “What Is Ready for a 15-Minute Demo”| Feature | Status | Demo Impact | Notes |
|---|---|---|---|
| Semantic search | Ready | High | ”What do we have about safeguarding audits?” — instant, meaning-based results |
| Browse with filters | Ready | Medium | 12+ filter dimensions, grid/list toggle |
| Content detail with depth tabs | Ready | High | Brief/Detail/Reference + human/AI toggle |
| Q&A Library | Ready | Medium | Dedicated Q&A management with copy-to-clipboard |
| Bid creation wizard | Ready | High | 3-step dialog: details, upload, review |
| Tender upload + question extraction | Ready | Very High | Upload PDF, AI extracts questions with sections |
| AI bid response drafting | Ready | Very High | 3-pass pipeline with streaming, citations, confidence |
| DOCX/XLSX export | Ready | High | Professional output with cover page and ToC |
| Coverage dashboard | Ready | High | Taxonomy matrix + template coverage |
| Review queue | Ready | Medium | Speed review with keyboard shortcuts |
| Freshness monitoring | Ready | Medium | Colour-coded freshness states |
| MCP tools via Claude | Ready | Very High | 38 tools accessible from Claude Desktop |
| MCP Apps | Ready | Very High | Coverage Matrix and Bid Dashboard render inline in Claude |
| Reorient Me | Ready | High | ”What’s changed since yesterday?” briefing |
| Entity graph | Ready | Medium | 999 entities, 913 relationships |
| Content effectiveness / win rate | Ready | High | Which content wins bids |
| ClaudePromptButton bridge | Ready | Medium | Contextual AI prompts on browse, item detail, bid pages |
What Is NOT Ready
Section titled “What Is NOT Ready”Updated 23/03/2026 — verified against codebase, not documentation.
| Gap | Impact on Demo | Severity | Notes |
|---|---|---|---|
| No onboarding flow | Cannot show “set up your KB in 5 minutes” | Medium | Client config infra exists but no guided setup wizard |
| No multi-client demo data | Only Phew-specific content available | Medium | Single-client KB — need demo content for a second sector |
| No aggregate stats dashboard card | Cannot quickly show “here’s the scale of what the platform manages” | Medium | Dashboard has operational health data but not volume totals (items, entities, bids won) |
| No PDF/A export | Minor — DOCX export is available | Low | |
| No Sector Intelligence Feed | Not demo-blocking | Low | Awaiting Matthew’s prompts |
Resolved since original audit (19 March 2026):
| Previously Listed Gap | Resolution | Session |
|---|---|---|
| No self-service document upload to KB | RESOLVED. Full upload pipeline: web file upload (PDF/DOCX/MD/TXT), URL ingestion, MCP create_content_item, Claude prompt buttons. Includes AI extraction, classification, review step, Q&A auto-split, dedup detection. Multiple entry points. | S98-S107 |
| Content volume is low (186 items) | Improved. Now 257 items (251 active). Pipeline supports batch ingestion. Volume still growing but search quality is good. | S97-S104 |
| CopilotKit has limited tool access vs MCP | Resolved (S109). CopilotKit fully removed. All AI interaction now routes through MCP (38 tools, 11 resources, 5 prompts) or ClaudePromptButton bridge. | S109 |
4. “Wow Factor” Gap Analysis
Section titled “4. “Wow Factor” Gap Analysis”What Would Make Observers Say “I’ve Never Seen That Before”
Section titled “What Would Make Observers Say “I’ve Never Seen That Before””Updated 23/03/2026 — gap status verified against codebase and database.
| Capability | Status | Current State | Remaining Gap |
|---|---|---|---|
| ”Upload and it just works” | RESOLVED | Full pipeline: web upload (PDF/DOCX/MD/TXT), URL ingest, MCP, Claude prompt bridge. AI extraction, classification, review step, Q&A auto-split, dedup, source document tracking. Multiple entry points. | None — exceeds original requirement |
| Live Claude conversation managing the KB | Not investigated | All 38 tools work. MCP Apps render inline. Plugin skills teach Claude domain expertise | Need: polished demo script (0.5 sessions) |
| Before/After comparison | OPEN | Win-rate tracking and content effectiveness MCP tool exist. Dashboard shows operational health (freshness, attention items, bids) but no volume aggregates | Need: dashboard aggregate stats card showing total items, Q&A pairs, entities mapped, bids tracked, bids won. No time-tracking data exists for “hours saved” comparison. Effort: 0.5-1 session for volume stats card |
| Onboarding wizard | Not investigated | Client config infrastructure exists. Taxonomy admin UI exists. Guide management exists | Need: guided setup flow (1 session) |
| Content quality score | RESOLVED | Full implementation: lib/quality-score.ts — 5-component weighted score (freshness 30%, confidence 20%, completeness 20%, summary 15%, citations 15%). Visible as QualityBadge on all browse cards and search results. Database-persisted (quality_score INTEGER column), weekly cron recalculation + real-time updates on create/edit/upload. 7 MCP quality tools + kb://quality-briefing resource. Quality actions engine with prioritised improvement suggestions. Per-domain thresholds in governance_config. | None — fully implemented |
| Real-time collaboration indicators | Not investigated | Not built | Need: show who else is viewing/editing (2+ sessions) |
| Smart content suggestions | RESOLVED | Full implementation: lib/content-suggestions.ts — 5 suggestion types (empty subtopics, template gaps, stale-only, thin coverage, missing layers). Dashboard section with per-suggestion “Create” buttons generating Claude prompts. suggest_content_creation MCP tool (#31). Coverage page gap cells with “Ask Claude” buttons. Weekly cron for gap detection. Quality actions engine for improving existing items. | Minor: “Create” buttons copy prompt to clipboard and open Claude externally rather than drafting in-app |
The Single Biggest Gap (Updated)
Section titled “The Single Biggest Gap (Updated)”Self-service document-to-KB ingestion — RESOLVED. The upload pipeline
now supports web file upload, URL ingestion, MCP pathway, Claude prompt bridge,
and CLI scripts. The review step includes draft mode, Q&A auto-split preview,
deduplication warnings, and bulk actions.
Revised biggest gap: Dashboard aggregate stats and onboarding wizard. The platform lacks a prominent “here’s the scale of what we manage” card on the dashboard (total items, entities, bids, win rate) and a guided first-session setup flow. Both are relatively low-effort to implement and would significantly improve demo impact and first impressions.
5. Recommended Quick Wins for Demo Impact
Section titled “5. Recommended Quick Wins for Demo Impact”These are ranked by demo-impact-to-effort ratio.
Updated 23/03/2026 — items 3, 4, 5 verified against codebase.
| # | Quick Win | Status | Effort | Impact | Details |
|---|---|---|---|---|---|
| 1 | Write a polished demo script | Open | 2 hours | Very High | Script the 15-minute demo: (a) show homepage Reorient Me, (b) search “ISO 27001”, (c) show content detail with depth tabs, (d) upload a document and show AI processing + review step, (e) upload tender PDF, (f) extract questions, (g) draft one response with citations, (h) switch to Claude Desktop and show MCP tools, (i) show Coverage Matrix MCP App, (j) show win-rate stats, (k) show quality score badge and quality actions |
| 2 | Populate demo-quality content | Open | 4-6 hours | Very High | Now 257 items (up from 186). Create 20-30 high-quality articles across 4-5 domains with all depth fields populated, good classifications, and entity relationships. Quality over quantity |
| 3 | Create a composite quality score | DONE | — | — | Implemented S100-S107. lib/quality-score.ts — 5-component weighted score (freshness 30%, confidence 20%, completeness 20%, summary 15%, citations 15%). QualityBadge on all browse cards and search results. DB-persisted with weekly cron + real-time recalculation. 7 MCP quality tools. Quality actions engine. Per-domain governance thresholds. |
| 4 | Add “Upload to KB” via MCP pathway | DONE | — | — | Implemented S98-S107. Full web upload pipeline (PDF/DOCX/MD/TXT) with AI extraction, classification, review step, Q&A auto-split, dedup detection. MCP create_content_item supports full AI processing. CopilotKit sidebar has 3 ingestion actions. Claude prompt buttons on upload UI. Far exceeds the original “MCP-only” recommendation. |
| 5 | Dashboard aggregate stats card | OPEN | 1-2 hours | Medium | Dashboard currently shows freshness breakdown (via QuickStatsStrip) and operational attention items, but does NOT show volume aggregates: total items classified, Q&A pairs, entities mapped, bids tracked, bids won. The CoverageSummaryCards component on the Coverage page has the right visual pattern (prominent number + label) — could be adapted for the dashboard. Data is readily available via existing queries. |
6. Sales Narrative Suggestions
Section titled “6. Sales Narrative Suggestions”Narrative 1: “The Web App Is the Dashboard, Claude Is the Interface”
Section titled “Narrative 1: “The Web App Is the Dashboard, Claude Is the Interface””For audiences familiar with AI tools.
“Most knowledge bases ask you to come to them. Knowledge Hub meets you where you already work — inside Claude. Your team is already using AI daily. Knowledge Hub gives that AI access to your company’s actual knowledge: policies, certifications, bid history, win rates. Instead of Claude making things up, it searches your verified knowledge base, cites its sources, and tells you when it is not confident. The web app exists for governance, review, and configuration. The daily work happens through conversation.”
Narrative 2: “Your Knowledge Base Gets Smarter Every Time You Win”
Section titled “Narrative 2: “Your Knowledge Base Gets Smarter Every Time You Win””For bid management audiences.
“Every bid tool helps you write responses. Knowledge Hub helps you win more over time. When you use content from the KB in a bid response, the system tracks the citation. When you record the outcome — won, lost, withdrawn — the system calculates which content correlates with winning. Next time you search, content with a proven track record surfaces first. Your knowledge base learns from your success.”
Narrative 3: “We Solved the Content Decay Problem”
Section titled “Narrative 3: “We Solved the Content Decay Problem””For knowledge management audiences.
“Every organisation has the same problem: you build a knowledge base, it is great for three months, then it decays. Nobody updates the ISO certification date. The competitor analysis is two years old. Nobody notices until a bid goes out with expired information. Knowledge Hub has an automated freshness lifecycle. Content transitions from fresh to ageing to stale to expired on a configurable schedule. The system notifies designated reviewers. The coverage dashboard shows gaps in real time. Quality does not depend on someone remembering to check.”
Narrative 4: “One Record, Many Views”
Section titled “Narrative 4: “One Record, Many Views””For audiences concerned about content duplication.
“Most organisations maintain three copies of the same information: one for sales, one for bids, one for compliance. They inevitably drift apart. Knowledge Hub follows the Wikipedia principle — one authoritative record per topic, with progressive depth (brief for sales conversations, detail for bid responses, reference for audits) and configurable content layers. The sales team sees the positioning. The bid team sees the evidence. The compliance team sees the technical detail. All from the same source.”
7. Key Metrics to Highlight in Sales Conversations
Section titled “7. Key Metrics to Highlight in Sales Conversations”| Metric | Current Value | What It Demonstrates |
|---|---|---|
| MCP tools | 38 | Depth of AI integration |
| MCP Apps | 3 interactive | Visual richness inside Claude |
| AI service modules | 12 | Breadth of AI capability |
| Content types supported | 15 | Flexibility of data model |
| API routes | ~131 | Platform maturity |
| Test coverage | 5,131+ JS + 555 Python + 15 E2E specs | Engineering quality |
| Taxonomy domains | 7 (expandable) | Configurable structure |
| Entity relationships | 913 | Knowledge graph depth |
| Database tables | 30 | Schema sophistication |
| RLS policies | 107 | Security rigour |
8. Positioning Summary
Section titled “8. Positioning Summary”Knowledge Hub is not a document store with a search bar. It is a structured knowledge engine with a 4-layer AI integration, built for organisations whose knowledge directly determines revenue.
The competitors fall into two camps: generic tools that are broad but shallow (Notion, Confluence), and bid-specific tools that are narrow but deep (Loopio, RFPIO). Knowledge Hub occupies the space between — deep enough to run a bid lifecycle end-to-end, broad enough to serve as the organisational knowledge backbone, and uniquely integrated with external AI via MCP so that users can work in their preferred environment.
The single most powerful differentiator in a demo is the MCP integration. No competitor offers anything comparable. Showing a user managing their knowledge base through natural conversation with Claude, with interactive visual apps rendering inline, with per-user permissions carried over from the web app — that is a “never seen that before” moment.
Produced: 19 March 2026. Updated: 23 March 2026 (Sections 3, 4, 5 verified
against codebase). Sources:
docs/audits/strategic/strategic-product-assessment.md,
docs/reference/state-of-the-product.md,
docs/reference/ai-integration-layers.md,
docs/reference/Knowledge Hub — Platform Overview.md,
docs/reference/Knowledge Hub — Claude Integration Guide.md,
docs/client-documentation/markdown/Product_KB_Dev_Brief.md, lib/mcp/tools/,
lib/ai/, lib/client-config.ts