kolu
Docs

before you approve

Read the plan
at full size.

A waterfall writes its plan and its notes into the work’s .waterfall/ folder. Open one and it takes the large side of the Conductor: a reading column, the work’s other files as tabs, and the question about that work pinned above the document.

Open a file

  1. Open a work’s card in the Conductor and go to Files.
  2. Click the file you want. A folder is one chip with its file count: click it to see what is inside. The reader takes the place of the works and the conversation stays beside it, so you can read and talk at the same time.
  3. Click ← Work when you are done. The cards come back exactly as you left them.

When the Conductor asks you to approve a plan, its question carries a Read the plan button that opens the file in one click. The plan never opens by itself.

A file the Conductor names in the chat, like .waterfall/plan.md, is a link to the same reader, on the copy of the piece of work that reply is about. If that work has no such file yet, the link says so instead of opening another work’s. When the reply is about several works, or about none, and more than one holds the file, pressing it lists them as work chips and you choose.

On the card’s Timeline, each Wrote row opens the file it wrote. A folder’s row, such as Wrote mockup/ · 49 files, lists its files under more. On a finished piece of work, that works for the files kolu kept.

On a phone the reader takes the whole screen, with the same way back.

What you get

PartWhat it does
The documentA column of about 50rem at 16px, set for reading. Tables and code blocks use the pane’s full width and scroll sideways rather than squeeze to one word a line.
Rendered / SourceSwitches between the rendered file and its text.
TabsThe work’s other files, on one line in the header that scrolls sideways, opened to the folder of the file you are reading. Clicking one moves the reader to it.
The workIts chip in the header. Clicking it opens the work’s card; a popped-out reader shows it without the click.
The questionThe open question about this work, pinned above the document with its buttons and a line saying how many comments go with your answer.
CommentsSelect text in the document to comment on it, the same comments as on the Code tab. They are sent with your answer.

The file is read live, so a plan an agent is still writing grows under you, and a question that arrives appears at the top.

A file that is not text, such as a font, shows No preview available for this file type rather than its bytes. It is still listed, counted and kept.

Give it more room

  • Fill the screen hides the conversation and gives the whole Conductor to the document. Show the chat gives the conversation its third back.
  • Pop out ↗ opens the same reader in a browser window of its own, which you can move to a second monitor. It is the same live reader, so the file, the question and your answer all work there, and closing the window loses nothing.

Answer where you are reading

A question is one decision with four faces: the work’s card, the chat, the reader and a popped-out reader. Pressing Answer in any of them settles it, and I’d rather not say declines it in any of them.

Nothing is waiting on you while you read. The Conductor has ended its turn, and your answer is what wakes it. See when it asks you.

Next