Issues

An issue is a single unit of work — a bug, task, or improvement tracked in Projects.

Open an issue

Click an issue from the backlog, board, or search results. Each issue has a unique key (for example APP-17) you can reference in conversation and docs.

Issue detail

The issue page typically shows:

• Title and description
• Status — where it sits in your workflow
• Assignee — who owns it
• Comments — discussion with your team
• Links — related specs or conversations when connected

Create an issue

1. Open Projects and choose New issue or add from the backlog.
2. Write a clear title and description.
3. Set priority and assignee if known.
4. Save.

Good issue descriptions include reproduction steps for bugs, or acceptance criteria for features.

Update status

Change status from the issue page or by moving the card on the board.

Agent-generated issues

Agents investigating production problems may suggest issues or specs. Review them like any other work item before prioritizing.