What it is
Writing top-down means calling processes before they exist: .do Verify identity today, write “Verify identity” tomorrow. Runic keeps the gap visible without nagging. The line is marked, the sidebar shows a dot, and the fix is one click.
How it works
The reference index checks every .go and .do target against the set of process names, case-insensitive and trimmed, ignoring any arrow caption. Targets with no definition are collected per document.
A broken line gets a pale amber background and, at its end, a chip reading “+ Create as process” whose tooltip names the missing process. Clicking it creates an empty process with exactly that name and switches to it; if the process appeared in the meantime, the click opens it instead.
The sidebar shows an amber dot on any document with broken references, with the count in its tooltip. It clears the moment the last target exists: created, renamed to match, or typo fixed. Clicking a Go or Do card in the diagram runs the same jump, so a missing target can be created from the picture too.
Why it matters
The gap in your documentation becomes the next thing you write. The missing processes are marked in place, counted per document, and turned into real documents with one click, instead of a TODO list kept somewhere else.
Limits
A broken reference is not a parse error: the line still renders as a card and the sync chip stays “In sync”. The chip is hidden in the folded view. With billing configured, creating counts against the free plan’s 10 processes; past that the upgrade dialog opens and nothing changes.
How to use it
- Write the call firstType
.do Verify identityeven though no such process exists. The line renders as a Do card and gets an amber band in the editor. - Read the chipAt the end of the line a chip reads “+ Create as process”. Hover it: “No process is named “Verify identity” — create it now”.
- Click itRunic creates an empty process named “Verify identity”, adds it to the sidebar, and switches the editor to it.
- Write the processDescribe its steps. Switch back to the caller: the amber band is gone and the sidebar dot has cleared.
- Or fix the nameIf the target was a typo, retype it or pick the right process from the .do menu. The marker clears as soon as the names match.
Commands & shortcuts
| + Create as process | Inline chip on a broken .go/.do line |
| Amber band | Editor background on a line whose target is missing |
| Amber dot | Sidebar marker: “N broken references (.go/.do target missing)” |
| Click a Go / Do card | Opens the target, creating it when missing |
Tips
- Draft the main flow with .do calls to processes that do not exist yet, then walk the amber chips top to bottom to write each one.
- Matching is case-insensitive, so “verify identity” and “Verify Identity” resolve to the same process.
- The marker ignores captions:
.do Verify identity: same dayis checked against “Verify identity”. Create the process before adding the caption, because the chip on a captioned line passes the whole tail as the name. - After a rename, glance at the sidebar dots to catch any call site that was not rewritten.
Questions
Why is the broken line not red?
Red marks a line the parser cannot place. A missing target parses fine; it is a workspace-level gap, so it gets amber and a fix instead of an error.
What name does the new process get?
Exactly the text after .go or .do, trimmed. On a line with an arrow caption the chip includes the caption in the name, so add captions after the process exists. Rename it later from the top bar and the call site follows.
Can I create it without leaving the current document?
Not from the chip; it opens the new process so you can write it. Pick the caller in the sidebar to come back, or click the new process’s reference badge and choose the call site.