Memory

Everything an agent produces is kept in two places: the work itself, and a small record of where that work lives. Unveil Code keeps the work in git and the record in a database.

The work: a branch per agent

Each agent works on its own branch of a shared, version-controlled store. A branch is a private line of changes with its own full history. The agent's files live there, and every change is committed, so nothing is lost and any earlier state can be restored. A fork gives a child its own branch. A merge folds that branch back in. Each branch is named after the agent that owns it (see Naming); where that agent sits in the fork tree is kept in the database below, not in the name.

The record: a small database

A small database sits beside the branches. It tracks which agent is which, how the fork tree is shaped, and each agent's branch name. It also holds the durable queue of messages waiting for a busy or restarting agent, so none is lost. The branches hold the work. The database says where everything is.