Notes
Capture ideas in notes.
Tickets are committed work. Notes are the thinking that comes before. An idea for a feature you're not sure about, a design question you want to sleep on, a decision with rationale worth preserving. Notes live in .story/notes and show up in the Mac app alongside the board.
Follow along
- 1.
Open the notes panel
In the Mac app, press the Notes button in the sidebar. You'll see any existing notes with their tags and linked tickets.
- 2.
Create a note
Click +. Give it a title and write freely in markdown. Tag it with short labels like idea, decision, spike, followup. Tags make notes filterable later.
- 3.
Link to a ticket or leave it free
If a note belongs to a specific ticket (a design alternative, a reviewer concern, a followup), set its relatedTickets field. If it's free-floating thinking, leave it unlinked - notes don't have to belong to anything.
- 4.
Promote to a ticket later
When a note earns its keep and becomes real work, ask Claude Code: "turn note N-004 into a ticket in phase 3." Claude reads the note, drafts a ticket with title, description, and acceptance criteria, and leaves the original note linked for history.