The Charlotte Mercury's Most Important File Is Markdown

The most important file in the company has the same format as a grocery list.

It's markdown: plain text, a few pound signs for headings, some asterisks. No code, no database, nothing a programmer would be proud of. And it holds the closest thing The Charlotte Mercury has to a soul.

Institutions have run on documents like this for a long time. Around the year 530, a monk named Benedict wrote a rule for his monks: 73 short chapters on how to pray, eat, work, sleep and settle disputes. He called it "a little rule for beginners." Benedictine monasteries still live by it, nearly 1,500 years later. Nobody would call it software. It runs the place all the same.

Brian Alvey, the chief technology officer of WordPress VIP, described the modern version on a podcast this week. To hand your work to an AI, he said, you have to write down everything you know: every preference, every standard, every decision you'd make if you were in the room. The guidelines and checklists you write, he said, become "obsidian vaults" for your agent, "keeping the context and learning as you go." That's what lets an AI run part of your business instead of just answering questions about it.

He was describing one. We built one.

What's in the vault

The Charlotte Mercury runs on a folder of plain-text files that define how the whole operation works. There are files for every publication, every beat and the house style. And there's a master document that holds what the company knows: the people, the terms, the decisions we've made and why we made them.

Directions versus keys

Most people building with AI start with a prompt, a paragraph telling the model what to do. That works for one task. It doesn't work for an operation that publishes three newspapers with different beats and different readers.

A prompt is directions to your house. The vault is the keys. Directions get you one trip. The vault gives an AI enough context to do the work the way you would: to know that The Farmington Mercury covers a Connecticut town of fewer than 30,000 people, and that getting a council member's name wrong is not a minor error.

When the vault is right, a session picks up where the last one left off. When it's wrong, when a detail is out of date or a rule is missing, the work drifts, we catch it and we fix the file. Even Benedict left room for that. His rule tells the abbot to fit the monks' clothing to the local climate.

The moat

The conversation about AI in media is fixated on which model to use: GPT or Claude or Gemini or whatever ships next quarter. Models are commodities. They improve on a schedule none of us control, and anyone can rent the same one at the same price.

What isn't a commodity is what you feed them. Two publishers can use the same model and the same tools. One has a vault, a long record of editorial decisions, beat research and production lessons written down where the AI can follow them. The other has a prompt. The work won't be the same. It won't be close.

Alvey put the question directly: "What is the soul of a company?" Ours lives in a folder of markdown that didn't exist a year ago, in the same file format as a grocery list.

The model is the engine. The vault is the driver.

Related coverage

• One Article Is Easy. An Operation Is the Work.

• Multi-Agent Newsrooms: What the Architecture Looks Like