Markdown-Based Operating System for Running a Business With AI

AI products · Creator, architect · in progress

Business knowledge lives in people's heads and scattered documents. Agent-based automation usually means bespoke code per workflow that nobody maintains, with prompts living nowhere reviewable.

The detail

This separates three things that need different substrates. Directives are standard operating procedures written in prose, because prose is the right format for judgment. Execution is deterministic scripts, because code is the right format for things that must not be improvised. Orchestration reads the context, picks the right procedure and checks the output quality.

Everything is plain markdown under version control, which makes the entire operating model auditable, diffable and reviewable - and navigable as a linked graph by both a person and an agent.

The organising idea: the model is the employee, the folder is the company.

Markdown, git, agent orchestration.

What I did

  • Designed a three-layer architecture separating instructions, orchestration and deterministic execution
  • Chose plain markdown under version control so every process is auditable and diffable
  • Structured it as a linked knowledge graph navigable by both humans and agents
  • Wrote the standard operating procedures the agent executes

Stack

AI Agent Development, Technical Writing, Process Design, Git, Automation

Case study: https://www.siddhvasudev.com/projects/markdown-based-operating-system-for-running