Create Scorecards

Learn how to enable and create scorecards to measure software maturity

Scorecards help you measure software maturity and ensure adherence to organizational and industry best practices. Before creating your first scorecard, you need to enable the scorecard components in your IDP catalog.

---

Scorecard view

Scorecards have two main UI components that are developer-facing and displayed in the Catalog:

1. Card: A small card on the Overview page that displays scores

2. Tab: A detailed tab view that shows check details and score computation

---

Enable scorecards

If Scorecard UI components are already visible on your Catalog component pages, you can skip this section and proceed directly to Create a Scorecard.

Follow these steps to add Scorecards to your catalog entities:

1. Navigate to Layout Settings

   • Go to the Configure → Layout in Harness IDP.

   • Go to Catalog Entities.

   • Select the catalog entity type where you want to add Scorecards.

2. Add Scorecard to the Overview Tab

   • Find the Overview tab in the YAML

   • Add the following to its component section:

- component: EntityScoreCard
    specs:
    gridProps:
        md: 6

1. Add Scorecard Tab Component

   • Under the Tabs section, add the following:

- name: Scorecard
  path: /scorecard
  title: Scorecard
  contents:
    - component: EntityScorecardContent

Team entity layouts do not include the scorecard components by default. To see scorecard results on Team pages, add EntityScoreCard and EntityScorecardContent to the Team layout.

---

Create a scorecard

Before you create a Scorecard, ensure that you have created some checks. To learn more about checks, go to Scorecard Checks.

Once you have enabled the Scorecard components, follow these steps to create your first scorecard:

1. Navigate to Scorecards

   • Go to Configure → Scorecards.

   • Select Create New Scorecard.

2. Configure Basic Information

   • Name: Enter a descriptive name for your scorecard.

   • Description: Describe the scorecard's purpose and what it evaluates.

3. Add Filters (Optional)

   Apply filters to specify which Catalog entities the scorecard should evaluate:

   • Kind (mandatory): Select the entity kind (e.g., Component, Service, Teams)

   • Type (mandatory): Select the type for the chosen kind

   • Owners (optional): Select specific entity owners to evaluate

   • Tags (optional): Filter entities by tags

   • Lifecycle (optional): Select lifecycle stages (e.g., production, experimental)

   • Scope (optional): Choose the evaluation scope:

     • Project: Evaluates entities within a specific project

     • Org: Evaluates entities within an organization

     • Account: Evaluates entities across the entire account

     • No selection: Evaluates entities across all scopes

4. Add Checks

   • Select the checks you want to include in your scorecard. To learn more about checks, go to Scorecard Checks.

   • Checks evaluate specific criteria and return Pass or Fail results.

5. Publish Scorecard

   • Review your configuration

   • Click Publish Scorecard to make it active

GITX ENABLED

Scorecard calculations are based on entity data from the default branch of the associated Git repository. If you are using a remote Git repository to manage your Scorecard definitions, ensure that the YAML file is committed and pushed to the default branch. This behavior maintains a single source of truth and prevents confusion from incomplete or in-progress configurations.

---

Next steps

After creating your scorecard:

• Learn how to create custom checks for your scorecards

• Explore available data sources for your checks