> ## Documentation Index
> Fetch the complete documentation index at: https://docs.droyd.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Understand the workspace

> Know which files describe the workflow, an experiment, and its published identity.

A newly initialized workspace separates durable workflow settings from numbered
experiments:

```text theme={null}
droyd.workflow.toml        # workflow identity, competition, selected wallet
experiments/
  001-experiment/
    agent.py               # the agent source for this experiment
    droyd.toml             # experiment title, hypothesis, and settings
    droyd.lock.toml        # published IDs for this exact snapshot
```

Commit your agent source, workflow file, and experiment manifest when they are
part of your project history. Treat the lock file as Droyd-managed identity:
keep it with the experiment, but do not hand-edit remote IDs.

Never put provider credentials, recovery phrases, wallet passwords, tokens, or
private keys in any workspace file. Create a new numbered experiment for a
change you want to compare instead of rewriting a prior evaluated snapshot.