---
schema_version: 1
id: RAC-KTQ63DSQDX6Z
type: design
---
# Explorer Health Model

## Context

RAC Core provides repository intelligence including:

- Validation
- Relationships
- Completeness
- Portfolio analysis

Explorer surfaces this information to help users understand repository quality.

Explorer does not calculate health.

It visualizes Core-owned intelligence.

---

## User Need

Users need to quickly answer:

```text
Is this repository healthy?

What needs attention?

Where should I focus?
```

without manually interpreting multiple reports.

---

## Design

Explorer shall provide a repository health experience.

Example:

```text
Repository Health

Score

92%


Attention

2 broken relationships

1 incomplete requirement
```

---

## Attention Items

Issues should be:

- Actionable
- Linked to artifacts
- Prioritized

Selecting an attention item opens the affected artifact on its Inspection
tab, where the validation diagnostics explain the finding (v0.8.9) — the
drill-down lands on the reason, never on a dead end.

Example:

```text
REQ-004

Missing Success Metrics


Open →
```

---

## Health Areas

Possible categories:

```text
Completeness

Relationships

Validation

Coverage
```

Final scoring remains owned by RAC Core.

---

## Constraints

Explorer shall not:

- Calculate scores
- Invent recommendations
- Override Core diagnostics

---

## Accessibility

Health indicators shall not rely on colour.

Example:

Good:

```text
✓ Healthy

! Needs Attention

✗ Error
```

Avoid:

```text
Green

Yellow

Red
```

---

## Related Roadmaps

- v0.8.2-explorer-health
- v0.8.9-explorer-live-workspace

---

## Related Decisions

- ADR-015
