Markdown Is the New Source Code: How to Manage Runbooks, Prompts and Rules for Agents
arpit_bhayani · x · 2026-09-25
arpitbhayani argues that Markdown has become the new "source code" — runbooks, instructions, state, context, scripts, decision records, specs, workflows, prompts and rules all live in it now, and how you manage these in your repos matters a lot.
His take:
- There's no single right way; each repo should keep what matters to it, while org-wide standards ensure consistency
- Use an agents.md file kept up to date with every PR
- Organize the content well, make it discoverable, consolidate it into an org-wide knowledge base, then let your agents run wild
More from coding & agent
- Demo: leave comments on a paper and let your agent address them — Rasmic · 2026-09-25
- Jev becomes fastest-adopted AI model ever, spawning sub-cent browser and trading agents in 3 days — multiply_matrix · 2026-09-25
- Making Games for Agents Means You Have Instant AI Playtesters — One Prompt Upgraded the Graphics — tristanbob · 2026-09-25
- DeepLedger Launches AI Staff Accountant MCP Connector for QuickBooks — modelcontextprotocol · 2026-09-25
- AgentWallet MCP Gives AI Agents Wallet Infrastructure Across Solana and EVM Chains — modelcontextprotocol · 2026-09-25
- New SDK Tests AI Agents on Real Websites and Workflows, Not Mocked Tools — Able-Ingenuity8885 · 2026-09-25