tropo

The Agentic Builders / New to Agents · 8 of 14

Why Markdown Files

· 3 min read

New to Agents · Beginner Path · 8 of 14

Of all the choices in Tropo, "store everything as plain markdown files" sounds the most boring. It's the most important.

Markdown is just text with light formatting - headers, lists, bold, links. A person can read it, and so can a machine, with no special software in between. Tropo keeps everything an agent knows - notes, decisions, status, history - in markdown files in ordinary folders. Three reasons that matters far more than it looks:

  • A human and an agent read the same file. No proprietary app, no database you can't open. You can read, edit, and check exactly what your agents are working with, in any text editor. The substrate is transparent - nothing is hidden in a format only the machine understands.
  • No lock-in. Files in folders aren't trapped inside one company's product. They work in any harness that can read files, and they're yours: back them up, move them, track their history with ordinary tools. If the tooling world changes next year, your work comes with you.
  • Memory you can trust. Remember that durable memory is these files. Because they're plain text you can open and read, you can actually verify what your agent remembers and why. A memory you can't inspect is a memory you can't trust - and trust is the whole point once agents do real work.

Plain files feel low-tech. That's exactly the bet: the lowest-tech substrate is the one that survives every change of tool, and the one a human can always read.

One plain file, readable by both sides notes.md Human reads & edits it Agent reads & writes it portable: back it up · version it · move it to any tool - no lock-in, nothing hidden

Why this matters for Tropo

This is Tropo's founding bet, stated plainly: the durable, governable layer of agentic work should be plain files you own, not a proprietary store you rent.

Everything else builds on it. Memory is files. Tools are files. The agents themselves are described in files. Because all of it is text a human can read and an agent can parse, the whole system stays transparent and portable at once - which is what lets you actually trust a crew of agents with real work. Boring, durable, yours. That's the foundation.

Beginner Path · New to Agents ← Before: What is a Tool or Skill · Next: Why a Graph Filesystem Works → Related: What is Memory · See the whole path: New to Agents - Beginner Path