// Use when creating, drafting, or grooming a Linear or Superset ticket in this repo. Defines the canonical three-section structure.
| name | ticket-format |
| description | Use when creating, drafting, or grooming a Linear or Superset ticket in this repo. Defines the canonical three-section structure. |
2โ4 sentences. What's broken or wanted, and why. Outcome-focused, not solution-focused.
Where the ticket came from. Omit section if none.
| Source | Who | Link | Date |
|---|---|---|---|
| Slack #feedback | @alice | thread | 2026-05-10 |
Agent-groomed. Leave empty if you don't have codebase context โ a later grooming pass will fill it in. When you do fill it in, use these sub-headings and skip what doesn't apply:
### Files โ path:line + why relevant### Approach โ one paragraph### Related code โ similar patterns in the repo### Gotchas โ constraints, prior incidents