Tools

Documents

How to write notes and specs alongside your project, and turn a spec into tasks or a workflow run.

Write a note or a spec

Notes are for anything you want to keep with the project. A spec describes work too big for one task: its scope, constraints, edge cases and how you'll know it's done. Both are Markdown files, saved in .nora/notes and .nora/specs, so they can live in version control with the code.

  1. Open the Documents tool.
  2. Choose the Notes or Specs tab.
  3. Click + (New note or New spec). Nora creates a dated draft and opens it in the editor.
  4. Write it, and press Mod+S to save.

Start a spec from a web page

In the browser, select text, right-click it and choose Create spec from selection. The new spec contains the selected text.

Find and open a document

Notes and specs are listed in the Documents tool by title.

  1. In the Documents tool, choose Notes or Specs.
  2. Type in Find a document… to filter by title.
  3. Click a document to open it beside the list.

Delete a document

Hover it in the list and click its trash button.

Break a spec into tasks

When a spec is ready to build, have an agent plan it as tasks.

  1. Open the Tasks tool and choose Generate tasks.
  2. Choose your spec in Spec.
  3. Optionally add extra instructions in Planning brief.
  4. Choose Start planning thread.

Build a spec with a workflow

To have a writer and reviewers work through a spec until it's done, run a workflow and choose the Implement spec goal template, then pick your spec.

NextDownload NoraWhat’s newGet support