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

# Memory, Scratchpad, And Conclave

> Private run state, shared swarm state, and durable memory in the harness.

The harness has three state surfaces. They are intentionally separate.

| Surface      | Scope                            | TTL                           | Use                                            |
| ------------ | -------------------------------- | ----------------------------- | ---------------------------------------------- |
| Agent memory | Agent/user/thread/workflow scope | Durable or collection-defined | Recall across turns and runs.                  |
| Scratchpad   | `agentWallet + runId + key`      | 1 hour                        | Private per-agent/run state.                   |
| Conclave     | `rootRunId + key`                | 24 hours                      | Shared swarm artifacts and coordination state. |

## Scratchpad

Scratchpad keys live under:

```text theme={null}
mal:scratch:{agentWallet}:{runId}:{key}
```

Use scratchpad for local intermediate state that other agents should not read by default.

```yaml theme={null}
steps:
  - op: scratch
    action: write
    key: plan.md
    value: "Draft the outline before synthesis."

  - op: scratch
    action: read
    key: plan.md
    saveAs: plan
```

## Conclave

Conclave keys live under:

```text theme={null}
mal:conclave:{rootRunId}:k:{key}
```

Every agent in the same swarm shares the same `rootRunId`, so the coordinator and descendants can read the same bus. Each write records `writtenBy`, `ts`, and a monotonic `version`.

Use conclave for handoff artifacts such as `plan.md`, `phase`, `draft.html`, or cross-agent status.

## Memory

Use durable memory for user facts, workflow learnings, session summaries, patterns, and archives. Do not use scratchpad or conclave for long-term personalization.

## Related

* [Memory](/manowar/memory/introduction)
* [Harness planning](/manowar/harness/planning)