Knowledge & AI
An answer worth opening the source for.
Designing a knowledge base a team can maintain.
By Jay Fan · · Reference design / interactive sample

A team knowledge base should make it easier to find the approved answer and easier to discover when there is no approved answer. The deployment conversation therefore begins with the documents, their owners and who is allowed to read them.
The workflow
- Organise: Choose sources and assign owners.
- Prepare: Extract, version and index content.
- Retrieve: Find material the reader can access.
- Verify: Link the answer back to its source.
Start with a small source collection
A practical pilot might use the team's current onboarding guide, service catalogue and handover checklist. This is an illustrative scope, not a description of a deployed client system. Each document needs a title, owner, revision date and access group before adding an answer interface.
Retrieval needs boundaries
For an AI-assisted deployment, documents are extracted and split into retrievable passages. Access filtering needs to happen before those passages reach the model. The answer should identify its source and revision. If the source does not support a claim, the interface should say that information is missing instead of filling the gap.
Try the small example
The sample here has two approved questions and a third question with no supporting document. It deliberately uses a fixed local lookup so you can inspect the interaction without uploading documents or sending prompts anywhere. A production retrieval system would require a separately scoped index, model, permissions and evaluation set.
Deployment includes maintenance
A knowledge base can run on a local workstation, a private server or a hosted environment, depending on data and access needs. The handover needs an update process, tested restore procedure and a way to retire stale sources. A useful acceptance test includes supported questions, unsupported questions and attempts to retrieve a document outside a user's access group.
Make source ownership and the unsupported-answer state part of the first version.
Scope & status
This is a proposed deployment pattern and a working browser demonstration, not a claim of enterprise access control or a live AI retrieval backend on this website.
The interactive examples are available with JavaScript enabled.
Discuss a project with JayKeep exploring
Business systems
The website is only the beginning.
A website opens the conversation. A CRM gives that conversation an owner, a history and a next step.
Knowledge & AI
From a model to a tool you can use.
Model setup is the beginning. A usable deployment also needs a repeatable workflow, visible progress and an export someone can use.