> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sovara-labs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Track follow-up with issues

> Track investigation, discussion, and fixes from run review.

Use issues to follow up on findings that need more work.

## Create an issue

1. Open <strong><Icon icon="circle-dot" size={14} /> Issues and conversations</strong>
   and choose <strong><Icon icon="plus" size={14} /> New issue</strong>.
2. Add a title and description explaining the problem, expected behavior, and
   next step. Include links to the relevant runs or steps.
3. Assign the relevant people and create the issue.

## Discuss and resolve

Add comments as work progresses. Mention a lesson with `#N` to show it in the
**Lessons mentioned** panel beside the conversation.

When finished, record the outcome and choose **Close issue**. Use **Reopen issue**
if more work is needed. Lesson proposals and annotations must be saved separately.

For terminal workflows, see the [issues CLI](/cli/issues).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.