# Readiness Dashboard

Track and analyze your organization's Agent Readiness scores in the Factory App.

The Agent Readiness dashboard provides a centralized view of your organization's readiness scores across all repositories, with historical trends and detailed breakdowns.

![Agent Readiness dashboard](/docs-assets/images/web/readiness-dashboard.png)

---

## Accessing the dashboard

Navigate to **Settings → Analytics → Agent Readiness** in the Factory App.

---

## Main dashboard view

The dashboard shows an organization-level overview with three main sections:

### Summary cards

At the top, you'll see key metrics:

| Metric                   | Description                                                                 |
| :----------------------- | :-------------------------------------------------------------------------- |
| **Organization Score**   | Average readiness level across all measured repositories (rounded down)      |
| **Repositories Tracked** | Number of repositories with readiness reports vs. total enabled repositories |
| **Last Updated**         | Time since the most recent readiness evaluation                              |

### Progress graph

A time-series chart showing your organization's readiness level over time. Use the period filters to view different time ranges:

<PropertyList>
  <Property name='7d'>Last 7 days.</Property>
  <Property name='1m'>Last month.</Property>
  <Property name='6m'>Last 6 months.</Property>
  <Property name='1y'>Last year.</Property>
  <Property name='all'>All time.</Property>
</PropertyList>

### Repositories table

A searchable, paginated table of all repositories showing:

<PropertyList>
  <Property name='Repository name'>Click to view details.</Property>
  <Property name='Level'>Current readiness level (1-5).</Property>
  <Property name='Progress'>Percentage complete toward next level.</Property>
  <Property name='Last Update'>When the repository was last evaluated.</Property>
</PropertyList>

Use the search bar to filter repositories by name or URL.

---

## Repository detail page

Click any repository row to view its detailed readiness breakdown.

![Repository Detail Page](/docs-assets/images/web/readiness-criteria.png)

### Header

Shows the repository name, current level achieved, last evaluation time, and a **Refresh** button to trigger a new evaluation.

### Level accordions

Each readiness level (Functional through Autonomous) has an expandable accordion section showing:

- **Percentage complete**: How much of that level's criteria are passing
- **Lock status**: Levels are locked until the previous level reaches 80%

### Criterion rows

Within each level, individual criteria display:

| Element       | Description                                        |
| :------------ | :------------------------------------------------- |
| **Name**      | The criterion being evaluated                      |
| **Score**     | Format `[X/Y]`: numerator/denominator             |
| **Status**    | Pass (green) or fail (red) indicator               |
| **Rationale** | Click to expand and see the evaluation explanation |

### Remediation

<Badge variant='info'>Planned</Badge> Failing criteria will display a **Fix** button that triggers automated remediation. Select the criteria you want to fix, and the system will implement the necessary changes to your repository.

---

## Triggering a refresh

There are two ways to refresh a readiness evaluation:

### From the Factory App dashboard

1. Navigate to the repository detail page
2. Click the **Refresh** button in the header
3. A new session starts to evaluate the repository
4. Once done, the dashboard will update with results from the latest report

### From the Droid CLI

Start Droid while in the repository directory:

```bash
droid
```

Then enter the `/readiness-report` [slash command](/agent-readiness/readiness-report):

```text
> /readiness-report
```

<Note>
  Re-evaluations run the full readiness assessment against the current state of
  your repository. This is useful after making infrastructure improvements or
  merging changes that can affect a readiness criterion.
</Note>

---

## Understanding the metrics

### Organization level calculation

The organization-level score is calculated as the **average of all repository levels, rounded down**. For example:

- Repo A: Level 3
- Repo B: Level 2
- Repo C: Level 3

Organization Level = floor((3 + 2 + 3) / 3) = floor(2.67) = **Level 2**

### Repository level calculation

A repository's level is determined by the **80% threshold system**:

1. Start at Level 1
2. If 80% of Level 1 criteria pass → achieve Level 2
3. If 80% of Level 2 criteria pass → achieve Level 3
4. Continue through Level 5

The percentage shown for each level indicates progress toward completing that level's criteria.

---

## Best practices

{/* sweep-allow: term-bullets */}

- **Regular evaluations:** Run readiness reports after significant infrastructure changes
- **Focus on current level:** Address failing criteria in your current level before jumping ahead to focus on foundational improvements first
- **Track trends:** Use the progress graph to monitor improvement over time
- **Prioritize high-impact fixes:** The action items in CLI reports highlight the most impactful improvements

<RelatedLinks>
  <RelatedLink href='/agent-readiness/readiness-report' title='Readiness Report Command'>
    Run `/readiness-report` to evaluate a repository from the CLI.
  </RelatedLink>
  <RelatedLink href='/agent-readiness/overview' title='Agent Readiness'>
    Learn the five readiness levels and how scoring works.
  </RelatedLink>
</RelatedLinks>