BuildBetter Docs

Project Detail

The project detail page (/projects/:id) is split into two columns: a left content area with the timeline and signals, and a right rail of cards covering status, rollup, integrations, people, and post-release monitoring.

The stage order is: Triage → Scoping → In progress → In review → Ready to merge → Shipping → Released → Stable.

Left Column

Two tabs:

Right Rail Cards

Cards appear in roughly priority order. Some are conditional on the project's stage or state.

Status at a Glance

The bottleneck card. Answers "what's blocking us and what's next?"

If the card is empty, a Suggest status button kicks off an LLM run that proposes blockers, next actions, and recently-done items as ghost rows you can promote into real items.

Project Rollup

An AI-generated synthesis of the project, with sections for What / Why / Who / How / Risks / Next actions. Rendered as a two-column grid with:

The rollup only reads approved signals — anything in the "suggested" review state is ignored until you approve it. This keeps the rollup grounded in evidence you've vetted.

Integration Issues

Shows attached Linear and Jira tickets. The "+" button searches both providers in parallel; click a result row to attach.

Agent Sessions

Recent auto-routing decisions. Each row shows confidence score and the reason the agent chose this project (e.g., "Routed to Engineering — technical signals + Linear ticket match").

People & Signals

Two tabs in one card.

Click Find related signals to open the search modal and attach matching signals in bulk.

Post-Release Monitor

Only appears when the project is in the Released stage.

After 90 days with no regressions, the project auto-advances to Stable.

Close the Loop

Two parts:

A contact is marked "replied since last status move" automatically when the assignee responds in the designated channel or thread.

Similar Projects

Surfaces up to 3 high-similarity duplicate candidates with a match %. Each row has a Merge button that collapses the candidate into the current project — moves all its signals over and archives the duplicate. The × button dismisses the banner for the session.

Suggested Signals

Auto-fires when a project has fewer than 5 attached signals and the title is long enough to be a useful search query. Shows up to 5 semantic matches with:

Multi-select with checkboxes and click Add N to review to attach as "suggested" (not yet approved).

Area Picker

Shows the current taxonomy area path. Click to open a hierarchical picker and reassign.

Project Type, Status, Assignee, Priority

Dropdowns in the rail or header to update each field inline.

Live Updates

The detail page also listens to the tracked-item event stream. Live toasts surface when a PR moves status, a signal arrives, or a teammate updates the project from another tab.

Tip: The rail cards that surface AI suggestions (Status at a Glance's empty state, Suggested Signals, Similar Projects) read only approved evidence by default. The "suggested" state is for items pending your review — they're never auto-applied.