Documents and plans

When the agent writes or changes a Markdown file, everyone can read the whole document, not only its diff:

• In Files, under Documents, select the file. It opens in a tab next to the terminal, so the session goes on while you read.
• When the agent works on an OpenSpec change, a plan card appears at the top of the Timeline. It shows the change’s title and name, a button for each of its documents in the order of the change’s schema, so your team’s own steps (such as a feature brief) show up too, and how many tasks are done. The task count follows along live while the agent works through the tasks.
• A summary step that wrote or updated the plan offers Read the plan or Read the changes.

Each document opens in a tab of its own. A document of a plan links the plan’s other documents at its top, so you can go from the design to the tasks. In Overview, the newest plan’s first document is in front when you join.

A document tab marks the parts that changed since you last read it as New or Changed; turn Highlight changes since you last read it off to read without the marks. A document you open for the first time has no marks. Very large documents (over 200 KB) cannot be shown whole; the tab shows their changes instead.

A document opens Formatted. Switch it to Source to see the Markdown as written, with line numbers and highlighted syntax; the same parts are marked as new or changed there, line by line. Switching keeps your place in the document, and the next document you open is formatted again.

Plan cards come from the OpenSpec CLI on the host’s computer. Without it, SpecDeck recognises OpenSpec’s default layout (proposal, specs, design and tasks).