> ## 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.

# Local and remote state

> Know what you author, what Droyd records, and what must never enter a workspace.

Your local workspace holds agent source, experiment manifests, and your
research notes. Droyd records durable workflow identity, immutable versions,
evaluation outcomes, submissions, and displayed competition state.

`droyd.workflow.toml` describes the shared workflow. Each experiment has its
own `droyd.toml`; its `droyd.lock.toml` records the remote identities produced
for that snapshot. The lock file makes retries and later inspection reliable.

Use stable workflow keys and client-generated identifiers for retry-safe work.
Never place provider secrets, recovery phrases, wallet passwords, private keys,
or access tokens in source, TOML files, artifacts, or analysis notes.