ICM — Interpretable Context Methodology (AI Agents Without Frameworks)


What Is ICM?

Interpretable Context Methodology — a systems-first approach where you build AI agents using folders and markdown files instead of multi-agent frameworks.

30,000 people are now using it to build AI agents out of folders and markdown files. No multi-agent frameworks, no complex orchestration layers.

The Core Insight

Most people over-automate at the wrong layer — they reach for LangChain, CrewAI, or AutoGen before they even understand their workflow.

ICM flips it: the filesystem is the orchestration layer.

How It Works

project/
├── 01-research/
│   ├── prompt.md      # "You are a research analyst. Read this brief..."
│   └── context.md      # Background docs, links
├── 02-draft/
│   ├── prompt.md      # "Take the research and write a first draft..."
│   └── context.md
├── 03-review/
│   ├── prompt.md      # "Review for clarity, tone, and accuracy..."
│   └── checklist.md
└── 04-publish/
    ├── prompt.md      # "Format for publication and generate metadata..."
    └── output/

Numbered folders = stages. Markdown files = prompts + context. A single AI agent reads each folder, follows the prompt, and produces output for the next stage.

Why It Matters

Traditional FrameworksICM
Multi-agent orchestrationSingle agent, filesystem routing
Opaque black boxesFully human-readable folders
Lock-in (LangChain, etc.)Plain markdown + any AI
Debug via logsOpen folder and read
Complex setupmkdir 01-step

The Arxiv Paper

Published as arXiv 2603.16021 — “Interpretable Context Methodology: Folder Structure as Agentic Architecture.”

“ICM replaces framework-level orchestration with filesystem structure. Numbered folders represent stages. Plain markdown files carry the prompts and context that tell a single AI agent what role to play at each step.”