---
title: "Health checks & recommendations"
description: "Get an AI health report on your project with concrete, actionable recommendations."
url: https://evonx.ai/docs/launch/health-checks
locale: en
updated: 2026-09-04
---

# Health checks & recommendations

Get an AI health report on your project with concrete, actionable recommendations.

Open a project's **Health** tab and Evonx scores the codebase two ways: a
deterministic health check of things the platform can measure, and an **AI Health
Check** that reads the same project and returns risks with recommended next
actions.

## What you see

- **Health Check** — a score plus a list of concrete items (buildability, tests,
  configuration gaps). Each item passes or fails for a reason you can inspect.
- **AI Health Check** — a summary, a second score, and a list of **risks** with
  severity and reasoning. High-severity items are the ones worth acting on first.

> **Note**
> The AI report appears after the deterministic check has run for the project. If
> you see "Unavailable", run or refresh the health check first.

## Acting on a finding

1. Open the **Health** tab on the project you care about.

2. Read the AI summary, then the high-severity risks. Each risk names a problem
   in the codebase — not a generic lecture.

3. Turn a risk into work: send it to chat (the panel offers this) so an
   [Evolution Thread](/docs/evolve/evolution-threads) can plan the fix. Verify
   the result in a [preview](/docs/preview-and-debug/preview-hub) before merging.

This is most useful on [imported repositories](/docs/build/import-from-github),
where Evonx didn't write the first version and the scan is how you learn what
you're starting from. Greenfield projects still get a score; treat it as a
baseline, not a verdict.

## Related

- [Import from GitHub](/docs/build/import-from-github) — where health checks
  earn their keep on existing code.
- [Monitoring & publish metrics](/docs/launch/monitoring) — traffic and errors
  once the app is live, which is a different question than codebase health.