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.
- Open the Documents tool.
- Choose the Notes or Specs tab.
- Click + (New note or New spec). Nora creates a dated draft and opens it in the editor.
- 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.
- In the Documents tool, choose Notes or Specs.
- Type in Find a document… to filter by title.
- 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.
- Open the Tasks tool and choose Generate tasks.
- Choose your spec in Spec.
- Optionally add extra instructions in Planning brief.
- 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.