BuildBetter Docs

AI Features in Projects

Projects ships several AI surfaces. Each one is grounded in your real workspace data — signals, customers, PR activity, Linear tickets, and call transcripts — and most show you the evidence behind every claim.

AI Roadmap (List Page)

The banner at the top of /projects clusters your active and recently shipped projects into themes with a one-sentence narrative. See List & Views for the full controls.

What it does:

Two presentations:

Click Refresh to regenerate the clustering from the latest project state.

Project Rollup (Detail Rail)

An AI synthesis of the project, written in sections: What / Why / Who / How / Risks / Next actions. Rendered as a two-column grid with one-click Copy and Refresh.

Evidence: the rollup reads only approved signals attached to the project. Anything in the "suggested" review state is ignored until you approve it.

Header: "Approved evidence only · [generated timestamp]" — so you can tell at a glance whether the rollup is current.

Suggested Signals Banner

Auto-fires on the detail page when a project has fewer than 5 attached signals and the title is at least 6 characters.

Use it as a quick way to seed evidence early in a project's life — and then approve the signals that actually fit.

Similar Projects Banner

Detects potential duplicates using cosine-distance similarity on project embeddings.

Run this on any project you suspect overlaps with an older one — it catches duplicates that wouldn't share keywords.

AI Status Suggestions

Lives inside the Status at a Glance card. When a real project has zero blockers and zero next actions, a Suggest status button appears.

The agent returns three buckets:

Bucket What It Surfaces
Potential blockers Environmental issues the agent infers (e.g., "waiting on infra team", "design review not started"). Includes reasoning.
Next actions Specific actions to advance the project. Includes reasoning.
Recently done What looks already done from PR/signal evidence, in case it's worth marking complete.

Suggestions render as ghost/muted rows. Click any one to promote it to a real blocker or action.

If the card already has blockers or actions, the AI panel stays out of the way.

AI Routing Suggestions (Triage → Projects)

When a tracked item is in triage, the AI route banner can suggest attaching it to a high-confidence existing project or creating a new one. Accepting the suggestion promotes the item to /projects.

See AI Routing in Triage for the full flow.

Post-Release Monitor

Only appears for projects in the Released stage. The monitoring agent watches signals received after release and flags regressions.

What the AI Doesn't Do Without Your Approval

Tip: If you want to see what evidence drove a particular AI suggestion, expand the rollup or open the related signals — every claim cites the underlying customer signals.