Write Issues

Write issues a teammate can act on without asking you follow-up questions. Lead with what the reader needs to reproduce or understand the request, not with your analysis.

Show a draft first and let the user react before you create anything in Linear.

1. Title

Prefix the title with the type in parentheses, the same way the repo prefixes PRs.

• (bug) for something broken.
• (feat) for a new capability or improvement.
• Other types as needed: (chore), (docs).

State the symptom or the request in plain words. Keep it short.