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

# Project Recommendations

> Recommendations scoped to a single project.

**Recommendations** are directives generated from findings, specific actions IronBee suggests to improve agent behavior, reduce cost, or increase verification effectiveness. Project-level recommendations are produced by the Project Quality, Project Cost, and Project Session Insights analysis runs and reflect what's needed in a specific codebase.

<img src="https://mintcdn.com/ironbee/ulqBeWHO5YWfn8mh/images/console/recommendation/recommendations-project-dark.png?fit=max&auto=format&n=ulqBeWHO5YWfn8mh&q=85&s=6955c25153587e76b44529ab937a2fd4" alt="IronBee Console — Project Recommendations" style={{borderRadius:'8px',width:'100%'}} width="1725" height="944" data-path="images/console/recommendation/recommendations-project-dark.png" />

Select a project from the project picker to view its recommendations.

Recommendations are automatically injected into the agent's context at the start of future sessions. There is no UI indicator when this happens, injection is handled server-side.

## Recommendation statuses

| Status       | Meaning                                       |
| ------------ | --------------------------------------------- |
| `active`     | Visible and being injected into agent context |
| `dismissed`  | Hidden from the list (no UI toggle to view)   |
| `superseded` | Replaced by a newer recommendation hidden     |

Only `active` recommendations appear in the list. Dismissed and superseded recommendations are not shown.

***

## Briefing panel

Shown above the recommendations list on each visit. Reports changes in active recommendation count since your last visit:

* **First visit:** starts tracking from this point; come back to see deltas
* **No changes:** nothing new since your last visit (shows timestamp)
* **Changes detected:** new and resolved recommendations summarized

Dismiss with the × button. Can be toggled in [Settings](/console/settings).

***

## Filters

| Filter        | Options                      |
| ------------- | ---------------------------- |
| Action search | Free text (min 3 characters) |

Active filters appear as chips. Pinned filters (Finding ID, Analysis ID) are cleared individually.

There are no severity or area filters on the recommendations page.

***

## Recommendations table

Two columns, both sortable (no Project column, scope is already fixed to the selected project):

| Column  | Description                                   |
| ------- | --------------------------------------------- |
| Action  | The recommended directive                     |
| Created | How long ago the recommendation was generated |

Default sort: Created, newest first. Page sizes: 20, 50, or 100 rows.

***

## Recommendation detail drawer

Click any row to open the detail drawer:

* **Status badge:** `active` or `dismissed`, shown in the header
* **Metadata line:** scope (project name), created date, dismissed time (if applicable)
* **Action:** full markdown description of the recommended directive
* **Causal chain strip:** three-step provenance trail:
  1. **Recommendation:** this recommendation
  2. **Source Finding:** the finding that triggered it, with severity badge
  3. **Source Analysis:** the analysis run that produced the finding

### Dismiss button

A **Dismiss** button is present in the drawer but is currently disabled ("Dismiss (coming soon)"). Dismissal support is not yet available.