Health Scores give every family and detail in your Pirros library a 0–100 quality score, computed automatically against a set of configurable rules. Use them to identify content that needs cleanup, track library quality over time, and decide which assets are ready to promote to your Typical library.
Prerequisite: All users with View Families or View Details permission can see scores. Editing health rules and parameter lists requires the Edit Workspace Settings permission (Admin role by default).
What Health Scores Measure
Each family and detail receives a single score from 0 to 100 based on how it performs against the active health factors for your workspace. Scores are color-coded using a stoplight scale so problems are easy to spot at a glance:
Green — meets standards
Yellow — needs attention
Red — failing one or more important factors
Black — critical issues that should be addressed before the asset is used
Families and details are scored independently — they have their own factors, weights, and thresholds. Configuring one doesn't affect the other.
Where to Find Health Scores
Open Pirros and click Management in the top navigation
Click Health
Switch between the Details and Families tabs to see scores for each asset type
The first time you visit the page, Pirros seeds a set of default rules and computes scores for every asset in your library. Initial computation runs in the background and updates every few seconds — you can leave the page once scores start populating.
Individual scores also appear on each asset's detail page (next to the asset name) and on detail/family cards across the app.
Default Family Health Factors
Five factors are seeded for every workspace. Three are active by default; you can enable or disable any of them in settings.
Factor | What it checks | Default threshold | Default weight | Active by default |
Max File Size | RFA file size on disk | 3 MB | 30 | Yes |
Max Nested Families | Count of nested families | 2 | 20 | Yes |
Max Parameters | Count of family parameters | 10 | 20 | Yes |
Contains Bad Parameters | Whether the family contains any parameter on the Bad Parameters list | List-based | 15 | No |
Max Active Flags | Number of unresolved review flags | 1 | 15 | Yes |
Default Detail Health Factors
Detail factors fall into two groups: programmatic factors (always available) and AI-powered factors. Only one factor — Max Active Flags — is on by default; the rest are inactive so you can opt in deliberately.
Programmatic factors:
Contains Bad Tags — fails if the detail has any tag from your Bad Tags list
Max Active Flags — fails if the detail has more than the threshold number of unresolved flags
Contains Restricted Words — fails if any restricted word appears in the detail's text content, view name, title-on-sheet, or sheet name (case-insensitive whole-word match)
AI-powered factors:
Crossing Leaders — detects leader lines that cross each other
Spelling Errors — flags misspelled words in annotations
Abbreviation Compliance — checks abbreviations against your approved list
Text Overlapping — detects text that overlaps with linework or other text
Leaders to Nowhere — finds leader lines that don't terminate on geometry
Text Alignment — checks for inconsistent text alignment
How Scores Are Computed
Each active factor evaluates the asset, returns a tier (Green / Yellow / Red / Black), and earns a portion of its weighted credit based on that tier. The asset's overall score is the sum of weighted credits across all active factors:
Score = ROUND(SUM(normalized_weight × credit / 100))
A few practical implications:
Weights are normalized. The total of your active factor weights doesn't have to add to 100 — Pirros normalizes them. But aiming for 100 makes the math easy to reason about.
Inactive factors are ignored. Disabling a factor removes it from the calculation entirely; remaining factors are re-normalized.
List-based factors with no list configured are skipped. If you enable "Contains Bad Tags" but haven't created a Bad Tags list yet, the factor is silently skipped and its weight is redistributed to the remaining active factors.
Configuring Health Factors
Admins can tune which factors are active, what their thresholds are, and how much each contributes to the final score.
Click your avatar in the top right and open Settings
Go to Workspace → Health
Switch between Details and Families tabs to configure each independently
Toggle factors on or off, edit thresholds inline, and adjust weights
Click Save — Pirros recomputes scores in the background
For each factor you can also configure the tier ranges — the boundaries that map a metric value to Green, Yellow, Red, or Black. Most firms can leave these at the defaults, but they're available if your standards differ.
Parameter, Tag, and Word Lists
List-based factors (Bad Parameters, Bad Tags, Restricted Words, Abbreviations) need a configured list before they can run.
In Workspace Settings → Health, click into the Details or Families tab
Click the Parameters sub-tab
Create a new list, give it a name, and add items one per line
Link the list to a factor (e.g., point the Contains Bad Tags factor at your "Bad Tags" list)
List matching is case-insensitive for tags and words; parameter names are matched exactly.
When Scores Update
Pirros recomputes scores automatically in these situations:
After an upload — newly uploaded families and details are scored as soon as processing finishes (both plugin sync and web upload)
After a settings change — when you adjust weights, thresholds, or tier ranges, Pirros queues a background recompute for affected assets
When opening the asset's page — if the cached score is older than the most recent settings or asset change, Pirros refreshes it on the spot
If a score appears stale, the badge shows an "outdated" indicator and the score will refresh on the next page load.
Using Scores in Practice
A few common ways firms use Health Scores:
Cleanup sprints — sort families or details by score, ascending, and work through the lowest-quality content first
Promotion criteria — require a minimum score before a project detail can be promoted to your Typical library
Library audits — track your average score over time as a quality metric
Targeted reviews — filter to Red and Black assets and assign them for review through your normal flagging workflow
Frequently Asked Questions
Q: Do I need to do anything to enable Health Scores?
A: No. Default rules are seeded the first time you open the Health page, and scores compute automatically. You can start adjusting factors right away if the defaults don't fit your standards.
Q: My weights don't add to 100. Is that a problem?
A: No — Pirros normalizes weights internally. We recommend keeping the active total at 100 just because it makes the math easier to reason about, but it's not required.
Q: Why is my score stuck at 100 for everything?
A: This usually means no factors are active, or every active list-based factor has no list configured (so all factors get skipped). Open Workspace Settings → Health and confirm at least one factor is active and any list-based factors point to a populated list.
Q: Can I create custom health factors beyond the defaults?
A: Custom rules are on the roadmap. Contact your CSM if your firm has a use case that the default factors don't cover and we'll work with you on it.
Q: How do AI factors differ from the programmatic ones?
A: Programmatic factors evaluate database fields directly (file size, parameter count, tag matches, etc.) and run instantly. AI factors send the detail's drawing to our health-check agent for visual analysis (crossing leaders, spelling, text alignment, etc.) and take longer — usually a few seconds per detail. AI factors require AI Vision on your workspace.
Q: Does changing a threshold re-score historical assets?
A: Yes. When you change weights, thresholds, or tier ranges, Pirros queues a background recompute that re-evaluates every asset in your library against the new configuration.
Q: Are scores visible to all users or just admins?
A: Scores are visible to anyone with View Families or View Details permission — that's most users by default. Configuring factors and lists requires the Edit Workspace Settings permission (Admin only).