Ticket Writing

When To Use

• Creating or editing a ticket in any tracker
• Filing deferred work from a review or a workflow
• Recording a decision on a ticket

When NOT To Use

• Writing the ADR or spec itself (see Skill(leyline:decision-journal))
• Writing a merge request description (see Skill(sanctum:pr-prep))

The Glance Test

Picture a reader arriving from the merge request. On the first screen of the ticket, without scrolling or opening a comment, they can answer two questions: what was decided, and why. If the why is too long for that screen, they find one link to the document that holds it. A ticket failing this test is not done.