ticket-format

name	ticket-format
description	Use when creating, drafting, or grooming a Linear or Superset ticket in this repo. Defines the canonical three-section structure.

Ticket Format

Context

2-4 sentences. What is broken or wanted, and why. Outcome-focused, not solution-focused.

References

Where the ticket came from. Omit section if none.

Source	Who	Link	Date
Slack #feedback	@alice	thread	2026-05-10

Implementation notes

Agent-groomed. Leave empty if you do not have codebase context; a later grooming pass will fill it in. When you do fill it in, use these sub-headings and skip what does not apply:

• ### Files - path:line plus why relevant
• ### Approach - one paragraph
• ### Related code - similar patterns in the repo
• ### Gotchas - constraints, prior incidents