AI Coding Tip 028 - Build a Company Brain
One Second Brain doesn't scale past one skull.

I’m a senior software engineer loving clean code, and declarative designs. S.O.L.I.D. and agile methodologies fan.
TL;DR: Wire a skill into your company's live systems so every answer carries a source and a freshness check.
Common Mistake ❌
As a single contributor, you can build a personal Second Brain, and it works beautifully for that one person.
The company's actual knowledge still sits scattered across Confluence, Slack threads, Jira tickets, CMSs, Wikis, Salesforce notes, and a wiki nobody has touched since the last reorg.
Your AI searches your own vault perfectly, then guesses the moment a question needs an answer that lives in a coworker's head, a stale runbook, or a system you never gave it access to.
Problems Addressed 😔
Company knowledge fragments across four to a dozen SaaS tools: document stores, chat, issue trackers, and business systems, each with its own API and its own silo.
Individual Second Brains compound personally but don't share, so a new hire repeats the exact search a colleague already ran last month.
Stale, obsolete documentation answers confidently and wrong, the same way an obsolete comment lies inside a function, except now hundreds of employees and an AI treat the lie as ground truth.
Every team wires its own one-off integration to its own AI assistant instead of sharing a connector layer, duplicating auth, indexing, and permission logic per tool.
Naive integrations flatten access control when they index everything under one service account, so a cited answer can surface a document the requester was never allowed to open.
Engineers already burn 3 to 10 hours a week hunting for undocumented answers, a form of comprehension debt that works in the same way technical debt does.
Unreviewed content decay costs companies an estimated $12.9 million a year in wasted time and wrong answers.
How to Do It 🛠️
Inventory every system employees actually consult before opening a ticket: wiki (Confluence, Notion, Trello), chat (Slack, Teams), issue tracker (Jira, Linear), code (GitHub, GitLab), CRM (Salesforce, HubSpot), and shared drives (Google Drive, SharePoint).
Connect each source through its own MCP server instead of a custom API integration per tool, the same give-the-AI-direct-access pattern extended with vendor servers like Atlassian's remote MCP server or GitHub's.
Write a skill that declares an explicit persona, such as "You are the company librarian," and lists exactly which MCP tools it may call for which category of question, so it never guesses the source.
Force the skill to answer only with a citation attached: source URL, system name, and last-modified date on every fact it returns, never a paraphrase without the reasoning behind it.
Pass the requester's own identity token through every connector instead of a shared service account, so retrieval respects the exact permission boundary the source system already enforces.
Add a freshness gate that drops or downweights any document past its review-by date: an outdated Confluence page lies the same way an old comment does, and it deserves the same don't-trust-it treatment.
Log every wrong or unanswered query as a new entry in the skill's pitfalls file, so a human fills the missing connector or fixes the stale source instead of the AI silently guessing again next time.
Re-run the skill weekly against a fixed set of golden questions and diff the answers against last week's run, so a silent schema change in one connector doesn't rot the whole Company Brain unnoticed.
Turn meetings into text too, since the skill can only reason over what it can read: run a transcription bot on the calls that matter and feed the transcript through the same connector pipeline as everything else.
Benefits 🎯
Single entry point: Employees ask one skill instead of hopping across ten browser tabs looking for the same fact.
Attributable answers: Every response carries a citation, which makes review as fast as reviewing a diff instead of trusting a black box.
Access control travels with the query: The retrieval layer checks permissions against the requester's own identity, instead of flattening them behind a shared index.
Staleness becomes visible: The freshness gate flags a document past its review date instead of trusting it forever, closing the same gap an obsolete comment leaves open inside a function.
Faster onboarding: New hires ask the Company Brain instead of interrupting five different colleagues with the same question.
Compounding knowledge: Company-wide knowledge compounds the same way a personal Second Brain compounds, except now every employee's queries feed it.
Visible gaps: An unanswered query becomes a concrete signal that a runbook is missing, instead of silently costing someone an afternoon.
No more knowledge gurus: The skill breaks the informal silos and single points of knowledge teams route around, since anyone can query the same live sources instead of waiting on the one coworker who remembers.
Context 🧠
A Second Brain is one person's plain Markdown files, disciplined by Tiago Forte's CODE framework and Niklas Luhmann's Zettelkasten, under that person's direct control.
A Company Brain stretches that same idea across a hundred people and a dozen systems nobody individually owns.
The failure mode isn't that people are disorganized.
It's that human memory doesn't scale past the one person who holds it.
That's exactly why Glean built its product around that name: a permissions-aware index over 100+ tools that lets teams ask questions, find experts, and trigger workflows from one surface.
A knowledge silo forms the moment only one system, or one person, holds the answer to a recurring question, and that person becomes a bus factor risk: the team's only path to the answer, until they leave.
A Company Brain breaks both silos and gurus the same way: it distributes the answer across every connector it can query, so the response no longer depends on which system or which coworker happens to be reachable that day.
The company-librarian persona from earlier makes that shift concrete.
A real librarian never invents a shelf location: she looks it up or tells you she doesn't have it yet.
That's the same discipline the persona is supposed to enforce on every answer.
A Company Brain isn't a wiki, and it isn't a CRM.
A wiki decays the moment nobody feels responsible for updating it, and a CRM records what a customer told the company, not what an engineer needs when the customer's real objection never made it into a structured field.
Glean reports its retrieval preferred roughly twice as often as a general chatbot's company knowledge, which tracks with what Atolio and Unstructured describe as the core problem: document stores, chat tools, engineering systems, and business systems each speak a different schema, and someone has to normalize all four into one retrieval stream before an AI can answer honestly.
MCP is the plumbing that makes this tractable without a bespoke integration per assistant: each server acts as a gatekeeper to its own system, and the protocol's authorization layer lets a client present the requester's own bearer token so the connector enforces the exact same access policy the source system already has.
A knowledge base, in the sense most RAG products ship, is a copy: a pipeline chunks and embeds your documents into a vector database, and a query searches that copy by similarity, not the source system itself.
That copy only stays accurate if something re-crawls and re-embeds it on a schedule, and the gap between a source edit and the next reindex run is exactly the window where a confident, wrong answer slips through, even inside Glean's own permissions-aware index.
The skill from this tip skips that copy entirely: instead of searching a pre-built index, it calls each MCP connector live at request time, so one question can query Confluence, Salesforce, and GitHub in the same run and return their current state, not a snapshot from last week's crawl.
That's the real difference between a knowledge base and this Company Brain: a knowledge base is one indexed store you search, while this skill is a router that asks several live systems the same question and merges what comes back, with nothing to fall behind because nothing gets cached in between.
Nobody maintains what can't be executed, and that rule applies just as much to a Confluence page as to a // TODO comment nobody deleted.
Stale context produces the same practical outcome as hallucination, a confident, fluent, wrong answer, which is why teams now treat freshness fields and stale-source suppression as first-class retrieval concerns, not an afterthought.
A decision nobody wrote down costs the same inside a codebase as inside a company: the missing rationale lives in someone's head until the day that person leaves.
A Company Brain doesn't fix either smell by itself, but it turns both into a retrieval gap you can see and log instead of tribal knowledge you can only rediscover by accident.
A knowledge base is never finished: content decay is the default failure mode of a wiki at organizational scale, and it decays faster than most teams expect once a product ships a few releases past the last edit.
The fix isn't a bigger vault, it's governance: every article gets a named owner, and review cadence scales with risk the same way a harness enforces standards by severity, so a billing or permissions page gets reviewed after every release while an evergreen explainer gets reviewed twice a year.
Docs-as-code treats documentation like source code and pushes that governance further upstream: version-controlled, peer-reviewed through the same pull request your feature ships in, so the page can't drift out of sync with the system it describes.
The 2026 trend goes one step further with living documentation wired directly into work-management tools, so closing a ticket auto-scaffolds the release note instead of leaving a human to remember it later.
A Company Brain is downstream of all of this: the fresher the source, the less the retrieval skill has to compensate for a Confluence page or a runbook nobody re-read since it was written.
Prompt Reference 📝
Bad Prompt 🚫
Look through company notes and tell me our current refund policy
for enterprise customers. I don't have the Confluence page
handy, so just use whatever you already know.
Good Prompt 👉
Use the company-brain skill. Query Confluence, Salesforce,
and Slack through their MCP connectors for our current
refund policy for enterprise customers.
Cite the source URL and its last-modified date for every fact,
and skip any document past its review-by date.
Considerations ⚠️
Don't let the skill become shadow IT that bypasses your security team's review of each connector.
Every new MCP server is a new access path into a production system.
Redact secrets and PII before indexing anything.
Scope each connector to public channels by default, and tell employees explicitly before you point a connector at anything more private, like email or call recordings.
Treat every connector's token scope as narrower than convenient, never a company-wide service account.
A Company Brain still needs a human owner per source responsible for triaging staleness flags, the same way a codebase needs someone to act on a linter's complaint instead of muting it.
Start with the two or three sources people ask about most, prove the citation and freshness gate work, then expand the connector list.
Type 📝
[X] Semi-Automatic
Limitations ⚠️
Each connector breaks independently when its underlying SaaS API changes, so a Company Brain carries the same maintenance budget as any other production integration.
Running a citation and freshness check on every query costs tokens and latency, which shows up fast at company-wide query volume.
Querying every connector live is slower per question than a single vector search against a pre-built index, since a live approach trades index-refresh lag for round-trip latency to each source system.
A misconfigured freshness gate lets the skill amplify a wrong source faster than a human ever would, so widen its scope only after your golden-question set proves it holds.
When a connector's scope quietly excludes a topic, the skill doesn't say it doesn't know.
It answers anyway, confident and wrong, unless the persona is explicitly told to admit the gap instead of guessing.
Tags 🏷️
- Knowledge Management
Level 🔋
[X] Intermediate
Related Tips 🔗
https://maximilianocontieri.com/ai-coding-tip-010-access-all-your-code
https://maximilianocontieri.com/ai-coding-tip-019-tell-the-ai-why-not-just-what
https://maximilianocontieri.com/ai-coding-tip-020-create-a-second-brain
https://maximilianocontieri.com/ai-coding-tip-024-force-a-criteria-check-before-the-task-ends
https://maximilianocontieri.com/ai-coding-tip-025-pair-every-skill-with-a-pitfalls-file
https://maximilianocontieri.com/ai-coding-tip-026-assign-a-persona-to-every-skill-definition
Conclusion 🏁
Your Second Brain stops at your own skull.
Wire a skill into your company's MCP-connected systems, force every answer to carry a citation and a freshness check, and the same compounding memory that helps one developer starts helping everyone who asks it a question. 🧠
More Information ℹ️
How to Create a Company "Brain" with Glean - phData
Unified Index for Enterprise AI - Glean
Types of Data Sources for Enterprise RAG - Atolio
Enterprise RAG: Why Connectors Matter in Production Systems - Unstructured
Introducing the Model Context Protocol - Anthropic
Introducing Atlassian's Remote MCP Server
Context Freshness: Keeping AI Agent Context Current - Atlan
Why Documentation Debt Will Be the New Technical Debt in 2026
Knowledge Base Content Audit Guide
Knowledge Base Governance Framework
The State of Software Documentation 2026 - FastDoc
LLM Wiki vs RAG: The Karpathy Concept and Enterprise Reality - Atlan
What Is Agentic RAG? - Weaviate
RAG Is Dead, Long Live Agentic Retrieval - LlamaIndex
Also Known As 🎭
- Organizational-Brain
- Enterprise-Knowledge-Graph
- Unified-Company-Search
- Cross-System-RAG
Tools 🧰
Disclaimer 📢
The views expressed here are my own.
I am a human who writes as best as possible for other humans.
I use AI proofreading tools to improve some texts.
I welcome constructive criticism and dialogue.
I shape these insights through 30 years in the software industry, 25 years of teaching, and writing over 500 articles and a book.
This article is part of the AI Coding Tip series.




