← Back to docs
Concept

Filesystem as Database

EvolC stores all business data in plain files and directories. No database required — your business is as portable as copying a folder.

The Core Idea

Instead of PostgreSQL, MongoDB, or any other database, EvolC maps business concepts directly to filesystem primitives:

Directories=Business components (nodes in the knowledge graph)
AGENTS.md=Agent context and instructions
JSON files=Structured data (universe, world state, config)
Git=Version control for the entire business

Directory Structure

A complete business lives in a directory tree:

/my-company/
├── config.json          # Organization settings
├── universe.json        # Business graph structure
├── AGENTS.md            # Company-wide agent context
│
├── marketing/
│   ├── AGENTS.md        # Marketing department context
│   ├── worlds.json      # Agent grid state
│   ├── .agents/
│   │   ├── content-writer.md
│   │   └── seo-optimizer.md
│   ├── content/
│   │   └── blog/        # Agent-created content
│   └── reports/         # Agent-generated reports
│
├── sales/
│   ├── AGENTS.md
│   └── .agents/
│       └── outreach.md
│
└── operations/
    ├── AGENTS.md
    └── .agents/
        └── billing.md

Benefits

Simple

No database setup, migrations, connection pooling, or query optimization. Just files.

Portable

Copy a directory and you have a complete backup of your business. Move between machines trivially.

Version Controlled

Git tracks every change. Roll back mistakes, compare versions, branch for experiments.

Human Readable

Open any file in a text editor and understand it. No special tools needed to inspect your data.

Agent Friendly

AI agents naturally read and write files. No ORM, no SQL — just read a markdown file.

Debuggable

Something wrong? Open the file and look. No query logs to search through, no database consoles.

Trade-offs

This approach has known trade-offs:

  • No complex queries — Can't do SQL JOINs or aggregations natively
  • Scale limits — Not designed for millions of operations per second
  • Concurrency — File locking needed for multi-agent writes

For the scale of AI-driven businesses (dozens of agents, not millions of transactions), these trade-offs are acceptable.

Storage Backends

EvolC supports multiple storage backends through a unified interface:

  • Local filesystem — Default for development
  • Cloudflare R2 — Production object storage

The storage abstraction means your business data works identically whether stored locally or in the cloud.

Related