The Folderbase field guide

Make agent work
easier to continue.

Practical guides to persistent files, reviewable changes, and choosing storage for AI agents. Start with a recurring job and the files it needs.

FOLDERBASE / CONCEPT ILLUSTRATIONFOLDERBASE ANATOMY
ORDINARY FILES / AUTHORITATIVE
Wproduct-brief.docxdocument
Parchitecture.pdfsource
Xforecast.xlsxdataset
Ihero-final.pngasset
ENGINE-MANAGED LAYER.folderbase/
IDENTITYVERSIONSPOLICYPROVENANCEQUERIESRELATIONSHIPS
01Agent workspace continuity6 min readFolderbase

How to Persist AI Agent Files Across Sessions

Keep AI agent files across sessions with durable storage, a clear accepted version, and a repeatable handoff. Includes a practical research-workspace example.

03Agent storage decisions6 min readFolderbase

How to Choose Storage for AI Agents

Compare folders, Git, object storage, persistent volumes, AgentFS, checkpoints, and memory. Choose agent storage around the files your next run needs.

04Folder database fundamentals7 min readFolderbase

What Is a Folder Database?

A folder database keeps ordinary files authoritative while adding durable identity, relationships, versions, permissions, queries, and provenance.

05Agent infrastructure8 min readJerel Velarde

What AI Agents Need From a File System

AI agents need more than read and write access: durable identity, scoped permissions, versions, provenance, conflict handling, and reviewable changes.

08Local-first architecture6 min readJerel Velarde

Why AI Agent Storage Should Be Local-First

Local-first agent storage keeps ordinary files fast and directly usable while adding cloud sync, sharing, recovery, and remote execution explicitly.