Create a YAML file under .cortex/scorecards/ in your scorecard repository with top-level fields name, tag (unique identifier), and description.
Define a ladder block with named levels (e.g., Bronze, Silver, Gold), each having a rank (integer), optional description, and optional color.
Under rules, list each rule with a title, expression (a Cortex expression that evaluates to true/false for a given service), and weight (relative contribution to the score).
Optionally add a failureMessage to each rule to give engineers actionable context when the rule is not satisfied.
Connect your scorecard repository to Cortex GitOps integration; Cortex polls the repository and applies any changes detected in .cortex/scorecards/.
View per-service scorecard results in the Cortex UI to confirm rules are evaluating correctly and scores are populating for each registered service.
Known gotchas
When GitOps is enabled for scorecards, edits made in the Cortex UI are overwritten on the next GitOps sync; treat the YAML file as the single source of truth.
Cortex scorecard expressions reference service catalog data (e.g., git metadata, on-call, CI/CD stats); rules that reference integrations not connected for a service silently evaluate to false rather than erroring.
The tag field is the stable identifier used in API references and reporting; renaming it creates a new scorecard and loses historical score data for all previously tracked services.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp