Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt

Use this file to discover all available pages before exploring further.

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. 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 '' — 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.

​
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.