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

# Use log.md for shared Palette Desktop context

> Use log.md in Palette Desktop to keep a concise shared record of important decisions and changes, so teammates and agents can recover context when needed.

`log.md` is a short, running record of what happened: the decisions you made and the changes worth remembering. It is your team's memory, kept in the workspace instead of in one person's head or one agent's chat history.

The point is that it stays focused. It is not a transcript of everything, which would bloat every session and stop being useful. It is the handful of durable decisions and changes a teammate or an agent would want to know next month.

## What goes in

Dated lines, newest on top. Prefix a real decision with `Decision:` so the important forks are easy to find later.

```markdown theme={null}
**2026-07-15** Decision: moved account briefs from Notion into the workspace.
**2026-07-11** Renamed the "prospects" folder to "accounts".
**2026-07-03** Decision: we sponsor one newsletter a month, not three.
```

Only log what someone revisiting would care about. Routine work does not need a line.

## Tell the agent when to read it

`log.md` is a convention, not a filename agents automatically load. Link it from [CLAUDE.md or AGENTS.md](/docs/desktop/claude-md-and-agents-md), or ask the agent to consult it when earlier decisions matter.

Keep it focused when you do load it. If you pour every message and every small edit into the file, the agent spends its attention on noise. Decisions and notable changes keep it worth reading.

## Logs, not lessons

`log.md` is what *happened* (history, backward-looking). What to do *differently* goes in [lessons.md](/docs/desktop/lessons-md). The decision goes in the log; the rule you draw from it goes in lessons.

## How to add one

Ask your agent, or let it offer at the end of a session.

* "Log that we decided to drop the free tier."
* "Add a log line for the folder rename."

## Shared across your team

Because the log lives in the workspace, it can be shared and versioned. Teammates can point their agents to the same history, but sharing the file does not load it into every session automatically.

## Related

* [Working with lessons.md](/docs/desktop/lessons-md), the other memory file: what to do differently, not what happened
* [Working with CLAUDE.md and AGENTS.md](/docs/desktop/claude-md-and-agents-md), the files an agent reads first
* [Structuring your workspace](/docs/desktop/structuring-your-workspace), the files that keep a workspace current