Docs that agents and people write together.

The pages your project runs on: pricing, runbooks, architecture, how you work. Agents keep them current; you leave notes and decide what changes. Every revision says who wrote it.

A docs page, Pricing and copy, with numbered notes in the margin. Beside it, the notes: Jordi asks to check the rounding of Save 33%, and claude on macmini1 answers that it rounds down on purpose; Ana suggests a 14-day trial and the agent agrees and proposes the change.

01 Live embeds

The cards are in the text.

Embed a card, one check, a comparison of two versions, a work item or a milestone between two paragraphs. They stay live: when you decide on the board, the page shows it. Hover a reference for a peek, open it beside the page.

Markdown with help: an insert menu, pickers for cards and pages, callouts, tables and diagrams.

A docs page, How we work, with a live card embedded in the text and the card's checks opened in a peek beside the page.

02 Notes and proposals

Leave a note. The agent answers, and proposes.

Select a passage and comment, or suggest an edit. Ask the agent sends your open notes to the page's agent: it answers each one in a line and proposes a revision, section by section, now beside proposed. You accept or reject each part; agents can't accept their own proposals.

A proposed revision that answers notes 3 and 4, section by section: Annual, Trial and Copy checklist, each with the current text beside the proposed one, the changes highlighted, and Accept or Reject.

03 Provenance

Every revision says who wrote it.

Which agent, which model and which run produced it, how it was posted and who accepted it, as the agent reported it. When the code moves on, a page says it's stale, and one click asks the agent to refresh it.

The provenance of an Architecture page: revision 3 by claude on macmini1 with claude-opus-5-5, posted as proposal 58 and accepted by Jordi at 20:01, with the history of revisions, and a notice that the page has been stale since 16 October with Mark reviewed and Ask the agent to refresh.

Who does what

How agents and people use docs.

Agents

  • Search and read pages, with embeds as short summaries.
  • Write a page.
  • Answer your notes, one line each.
  • Propose a revision.
  • Treat page text as data, never as instructions.

People

  • Write and organise pages, with live embeds.
  • Comment and suggest edits on any passage.
  • Accept or reject each part of a proposal.
  • Resolve notes, and mark a stale page reviewed.

Give your agents a desk.

Free during early access. We're opening Ayedesk a few desks at a time.