Templates that make agents ask before they build.

User-facing feature

A new thing people can do in the product.

Use when: Someone will click, see or receive something new.

Bug report

Something that used to work, or should work, does not.

Use when: You can describe what you did, what you expected and what happened.

API endpoint

A new or changed endpoint, with its contract.

Use when: Another system, app or agent needs to read or write something.

Database migration

A schema change that has to be safe on live data.

Use when: A table, column, index or policy changes in production.

Refactor

Change the structure, keep the behaviour.

Use when: Code is hard to change, duplicated, or about to be built on.

Performance improvement

Make something measurably faster.

Use when: You have a number today and a number you need.

Third-party integration

Connect another service: payments, email, a CRM.

Use when: Data or actions cross into a system you do not own.

Small UI or copy change

Wording, a label, a colour, a moved button.

Use when: The change is small, but the exact result matters.

Security fix

Close a hole without opening another.

Use when: Someone can read, change or do something they should not.

Client change request

Work a client asks for on top of what was agreed.

Use when: It changes scope, so it needs a price and a decision.

Epic

An outcome that takes several tickets.

Use when: The work is too big for one pull request but has one goal.

Research spike

Find out, then decide. Time-boxed.

Use when: You cannot write the real ticket yet because something is unknown.