The editor is the centre pane of claude4spec — the page on the left, your structured entities in the sidebar, the agent chat on the right. You write each spec page the way you'd write any markdown: headings, lists, code blocks, tables, links. What makes it rich is everything you can drop into that prose — live references to your entities, diagrams, todos, and links to other pages — each one a real, clickable object rather than dead text.
Everything you type is saved for you. There's no save button on a page: edits are written to the markdown file on disk about a second after you stop typing, so your spec keeps diffing in git as you work and the agent always reads the current version.
Two ways to insert things
Most of the editor's power is reached through two keystrokes:
/Opens the slash menu — insert an entity reference, a diagram, a todo, a section link, and more. See Slash commands.@Inserts a link to another page in your spec, with autocomplete on the file path. See Inline components.Both work inline, mid-sentence — start typing the trigger and a dropdown filters as you go; use ↑/↓ to choose and Enter to confirm.
Edit anything in place
Once something is inserted — an entity chip, a diagram, a todo, a page link — you don't retype it to change it. Every inserted object opens its own small editor.
Alt-click any inserted object (on a Mac, option-click) to open its edit popover. Each popover has Save, Cancel, and Remove. Removing is undoable — there's no confirmation dialog; just press Ctrl/Cmd+Z to bring it back. Diagrams and todos also respond to a plain double-click.
Navigating a long page
Spec pages get long. A toggleable outline sits in the left gutter of the editor — a sticky, Google-Docs-style list of every heading on the page. Click a heading to jump straight to it. Flip the outline on or off with its toolbar button; on a narrow window it tucks itself away so the text gets the full width.
From here, each capability has its own page: Slash commands, Inline components, Diagrams, and Todos.