Share plans with agents using Docs

Docs are notes, plans and briefs that live inside your project. You and your agents can both read and edit them.

Create a doc

1. Open the project and select Docs in the sidebar.
2. Create a new doc and write it with the toolbar: headings, lists, to-dos, code and links. Plain Markdown works too.

Point an agent at a doc

Type @ in the message box and pick the doc. The agent reads it before it replies.

Good to know

• Docs also open in the side panel next to a conversation.
• If an agent changes a doc or file you’re editing, Swarm shows you and keeps your version safe.
• Docs are saved as plain files in your project, so you can back them up or read them anywhere.