What specs are for
Use a spec when a feature, refactor, or project is too large to describe in a one-line task. A spec gives you one place to capture scope, constraints, edge cases, and success criteria before work is broken into smaller actions.
How to use specs
Create a spec for the workspace when you want a durable source of truth. Keep the document close to the repo so anyone working in Nora can open it, review it, and use it as the reference point for planning. Once the spec is clear enough, use it to generate task files rather than asking an agent to invent structure from memory.
How specs fit into the rest of Nora
Specs sit upstream of tasks and agent sessions. They are the place to clarify what should happen. Tasks turn that into actionable units. Agents and terminals then execute against those tasks inside isolated worktrees.