Practice

Knowledge quality lives between the documents

Every item in a knowledge base can be accurate on its own while the collection disagrees with itself. The Brain checks the collection for contradictions, duplicates and outdated items, and brings each finding to the item’s owner.

ClearMash3 min read

Where knowledge disagrees with itself, it usually does so between items: a warranty period stated one way in the product guide and another way in the returns procedure, the same customer question handled in different words by different teams, a procedure that was replaced in the spring and still turns up in search beside the one that replaced it.

Disagreement builds up on its own, because every item has an owner and the space between items has none. Duplicates show how: identical items drift apart the moment one of them is updated, and the organization holds a contradiction that nobody created.

Quality is a property of the whole collection

Review happens one item at a time. Its owner reads it, checks it against what they know, and approves it. That catches a great deal inside the item. A contradiction with an item the owner never opened sits outside it, where only the whole collection shows it.

Given items that disagree, an AI agent uses one of them, and nothing in what it says shows that it chose. The customer hears one version on Monday and the other on Thursday.

The Brain checks the collection against itself

ClearMash Brain reads across everything it holds. AI analyzes the items and finds those that hold contradictory information, such as a product guide and a returns procedure that state the warranty period differently. It finds identical and near-identical passages in different items, and questions that duplicate questions already asked. It reports the items marked outdated, each pointing at its current equivalent, so the replaced procedure leads to the one in force. And AI compares items to show an owner exactly where they differ.

The checks reach the writing itself:

  • Standardization scores measure each item against the organization’s own rules for content, set for the whole organization and for each item type.
  • Uniformity scores show how far an item’s writing style departs from the rest, so every item reads in the organization’s own voice.
  • Missing term annotations find the terms in a text that still need an explanation, so a reader can follow every word.
  • The questions behind each item are shown to its owner, and every question whose answer was held back marks where the item can give a better answer.

Each owner sees an item. The Brain sees how the items fit together.

Findings reach the owner as recommendations

The editor’s recommendations carry the reports, the scores and suggestions for improving the content. A contradiction arrives with the items that disagree named, so the owner of the returns procedure knows which guide to compare it with. Writing that drifts from the organization’s style can be rephrased to follow the organization’s own language and phrasing rules, or rewritten for a different audience. That turns a report into work that can be done this afternoon.

The owner decides. They accept the suggestion, edit it or set it aside, and the change goes through the same approval path as any other. AI suggests the note that records why a version was created, and a summary of an item’s recent changes shows the next reviewer what moved. When a document that an answer rested on is updated, that answer can return to unverified automatically until it is checked.

Quality becomes a routine

Contradictions surface in a report rather than in a complaint, and the reports are current the moment an owner opens them. Duplicates are found while they still say the same thing, before one of them is updated on its own. The knowledge keeps pace with the business.

For every AI agent, that means fewer contradictions to choose between, fewer outdated items to find, and terms that come with their explanation. The result is more consistent behavior across the AI agents the organization runs.

That is why ClearMash improves the knowledge itself: it reads what the organization has, shows where the collection disagrees with itself, and helps the owners make it right.

When the collection agrees with itself, every channel tells the customer the same thing.

Written by ClearMash. Filed under Practice.

All posts

Read next

  • Product

    In self-service, the Brain is the help center

    In self-service, a customer acts on what they read. So the help center has to be the Brain itself: personalized to their own case, grounded in approved knowledge, and in step with every letter and notice they get.

    3 min read

  • Practice

    Onboarding belongs at the moment of work

    Onboarding teaches in advance what a new employee needs one case at a time. Guidance at the moment of work shortens the path to working on their own, as the organizations that measured it show.

    4 min read

See these ideas working in the product

They are the ideas ClearMash Brain is built on, and a demo shows a position, the conditions that select it, and the step it ends in.

Prefer to start with the numbers? The impact estimator works them out