---
name: issue-tracking
description: Use tk to manage tickets and keep .tickets/ in sync with code changes.
metadata:
  short-description: Ticket workflow via tk
---

Use `tk` for issue tracking in this repo.

- List ready work with `tk ready`.
- View details with `tk show <id>`.
- Mark work in progress with `tk start <id>`.
- Close work with `tk close <id>`.
- Tickets live in `.tickets/` and should be committed with related code changes.

Reference: `references/tk-quickref.md`.