Working with log.md

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.

**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, 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. 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, the other memory file: what to do differently, not what happened
• Working with CLAUDE.md and AGENTS.md, the files an agent reads first
• Structuring your workspace, the files that keep a workspace current