topic-detail

The topic detail page (/topics/:id) shows everything tied to one topic: the conversation evidence, the participants, the linked tickets, lifecycle history, and the actions available to move the topic into work.

Header

The top of the page shows:

• Topic name with optional description below
• Status badge — Active (green), Stale (amber), or Resolved (gray)
• Type badge — Bug (red), Complaint (orange), Feature Request (blue), Feedback (purple), or Discussion (gray)

Header Actions

Three buttons sit in the top-right:

• Route with AI — opens the AI Route flow to suggest attaching to an existing project or creating a new one
• Attach to existing project — manual picker to link this topic to a tracked item
• Promote to project — two-click confirm to convert the topic into a tracked-item project. The first click shows "Really promote?"; the second click promotes and navigates to the new project with the toast: "Promoted '{topicName}' — attached N signal(s)."

Left: Conversation Evidence

The main pane lists every conversation group attached to the topic. A conversation group is one or more messages from the same conversation that share a topic segment.

Each group shows:

• Provisional name — AI-generated label for the group
• Source label — "Slack" or "Intercom"
• Conversation count and message count
• Expandable thread — click to reveal the full message exchange with speaker names and timestamps

Context Before/After

When you expand a thread, BuildBetter shows the N earlier messages and N later messages that bracket the topic segment. Click the lazy-load button to fetch more context — useful when a segment relies on what came before.

Group Actions

Each group has a three-dot menu with two options:

• Create new topic — splits the group into a new topic. On success, navigates to the new topic page.
• Move to topic... — opens a searchable modal to relocate the group to another existing topic.

See Manual Actions for the full details.

Right Sidebar

Stats

A compact row showing:

• Message count — total messages across all groups
• Group count — distinct conversation groups linked to the topic
• Activity duration — span from first message to last

Priority

A numeric value (1–5) with a visual scale. Topics without a priority show —.

Categories

AI-assigned topic tags as rounded pills.

People

Conversation participants with per-person message counts.

Linked Tickets

External issue tracker links (Jira / Linear / GitHub). Click any ticket to open it in the source system.

History

• Created date
• Resolved date — only if applicable
• Resolution signal — what closed it (manual archive, all conversations closed, inactivity)

When Things Move

The detail page reflects live state. As new conversations come in or messages get added:

• New groups appear in the left pane
• Stats refresh
• Status can flip between active and stale as the lifecycle job runs

You don't need to refresh — the page updates as the data does.