Blog

Thoughts on private AI, data sovereignty, and building in the open.

Agent-ready design systems: readable is only half the job

An agent-ready design system is half readable, half enforceable. We tested five claims ours made about our code, all five were wrong, and rebuilt it.

design systemsdesign system enforcementdesign tokensAI agentsdeveloper workflowcode qualityaccessibilityWCAGDESIGN.mdDSDS

We deleted 275,000 lines of agent scaffolding, and the work got better

In August we removed our entire agent development framework. What the research says about context files, why modern coding models need skills less, and the five layers we kept.

claude codeagent skillsAGENTS.mdagent frameworkscodexdeveloper workflowcontext engineeringAI codinghooks

Your design system is documented. The AI does not read it.

We found 56 hardcoded colour values our own design system forbids. What the CHI 2026 research says about AI agents and design systems, and what we built.

design systemsdesign system enforcementdesign tokensAI agentsclaude codedeveloper workflowcode qualitylintingeslint

What is an LLM, and how does it work?

A plain-language explainer of large language models. What they are, how they answer questions, where the math happens, and what to ask any AI vendor about your data.

LLMAI fundamentalshow AI worksopen sourceMistral

Klai and steward ownership: a company without perverse incentives

Klai is becoming a steward-owned company. What steward ownership means, why a not-for-sale structure fits our mission, and how we're getting there.

steward ownershipgovernancemission-driven companycompany legal structureKlaiperverse incentivesnot-for-sale

Not every document is the same

A PDF, a meeting transcript, and a knowledge base article should not be processed the same way. How content profiles control chunking, context, and question generation.

Modelling knowledgeknowledge baseRAGchunkingcontent profilesknowledge architecturedocument processingHyPEknowledge ingestionmulti-stage retrieval

Three signals, one answer

Follow a single user question through a retrieval pipeline: from pronoun resolution to three parallel searches, rank fusion, and a final reranker pass. Discover why one similarity score is not enough.

Modelling knowledgeretrievalknowledge baseRAGhybrid searchvector searchrerankingcoreference resolutionReciprocal Rank Fusionmulti-stage retrievalknowledge architectureQdrant

Own your own future: why we founded Klai

AI needs a foundation of compliance and digital sovereignty. That's why we're building Klai from Groningen, for organisations that won't hand over their data.

digital sovereigntycomplianceAIprivacyopen sourceEU AI ActKlai

Not every question needs the knowledge base

Reduce latency, avoid irrelevant answers, and save GPU costs by skipping knowledge base retrieval for queries that are not questions. How pattern matching and semantic gates filter trivial queries before they hit the vector store.

Modelling knowledgeretrievalknowledge baseRAGpre-retrieval gateknowledge architecturelatencyperformancevector searchsemantic filteringcost optimization

How to know if your knowledge base fix actually worked

Know if your knowledge base fix worked with automatic gap re-scoring. Learn how retrieval validation closes the loop between edits and outcomes.

Modelling knowledgeknowledge gapsgap detectionknowledge baseknowledge managementretrievalRAGclosed-loopcontent strategyknowledge base validationgap resolutionknowledge base fixescontent validation

How to find and prioritize knowledge base gaps

Turn failed searches into a content roadmap. Learn gap detection methods, hard vs soft gaps, and how to systematically fix knowledge base coverage.

Modelling knowledgeknowledge gapsgap detectionknowledge basecontent strategyknowledge managementknowledge architecturefailed searchesanalyticsknowledge base audit

Why knowledge base search fails users

How to bridge the gap between user questions and knowledge base answers. Techniques that work at storage vs query time, and why the retrieval system isn't where the fix happens.

Modelling knowledgevocabulary gapknowledge base retrievalsemantic searchhybrid searchHyPEquery expansionknowledge managementretrievalknowledge architecture

Quality happens at storage, not at search

Retrieval tuning can't fix a storage problem. Learn why knowledge base quality is determined at ingest time, and what contextual retrieval and HyPE actually do.

Modelling knowledgeknowledge architectureknowledge managementknowledge baseretrievalRAGembeddingscontextual retrievalinformation qualityHyPE

The self-managing taxonomy is a myth

AI can classify documents reliably. It cannot design taxonomy structure. Learn why every production knowledge base needs human governance for categories.

Modelling knowledgeknowledge architectureknowledge managementtaxonomyknowledge baseAIclassificationdocument classificationtopic modellinggovernance

Three axes, not one label

Why single type fields fail in knowledge systems. Learn how provenance origin, assertion mode, and synthesis depth drive better metadata design for knowledge bases.

Modelling knowledgeknowledge architectureknowledge managementknowledge artifactsprovenancemetadataknowledge baseassertion modessynthesis depthknowledge classification

Evidence vs. claims: the distinction that changes everything

Evidence vs claims: why source documents and knowledge artifacts require different handling in knowledge systems. A critical distinction for organizational knowledge.

Modelling knowledgeknowledge architectureknowledge managementsource documentsorganizational knowledgeknowledge artifactsknowledge base

Decisions deserve their own data model

Why decision data models matter: structure your organizational decisions with 5 fields. Capture rationale, alternatives, and consequences to build organizational memory.

How an organisation learnsdecision trackingdecision documentationknowledge managementorganizational knowledgeknowledge architecturedecision-making

8 patterns that make Claude Code actually follow your rules

How to organize Claude Code rules and CLAUDE.md into layers so the right context loads when you need it, and every mistake improves the system permanently.

claude codeCLAUDE.mdclaude code tipsclaude code rulescontext managementrules filesdeveloper workflow

The handbook is your knowledge base's first draft

Knowledge bases fail when they compete with culture. Handbook-first organisations document by default, and that foundation is what makes AI-augmented knowledge tools actually useful.

How an organisation learnsknowledge managementhandbookorganizational knowledgedocumentation culturehandbook-first

The self-improving knowledge base

Most knowledge bases decay silently. A self-improving system detects gaps, prioritises fixes, and stays accurate without constant curation. Here is how.

How an organisation learnsknowledge managementknowledge gapsAIorganizational knowledgeself-improving systemsknowledge base maintenance

Why you should never delete knowledge

Most companies delete outdated knowledge. That destroys institutional memory. Here is why knowledge retention means evolving, not overwriting.

How an organisation learnsknowledge managementknowledge evolutionorganizational knowledgedata modeling

Your company knows more than it can find

Most organizational knowledge lives in heads, Slack threads, and meetings. Here is why tacit knowledge loss is expensive, and how to fix it.

How an organisation learnsknowledge managementtacit knowledgeorganizational knowledgeAIknowledge loss

The EU AI Act, explained for people who use AI at work

EU AI Act compliance is now live. Here is what it means for law firms, financial advisors, and healthcare providers using AI day to day.

EU AI ActcomplianceregulationAI infrastructure

Where does your data actually go when you use AI?

Most AI tools send your data to US servers. Here is what that means for GDPR compliance, and what your privacy-first options are.

data privacyGDPRAI infrastructuredata residency