Hamburger Cross Icon
Backstage Guardrails - Catalog Info Valid

Catalog Info Valid

✓ Guardrail Backstage Guardrails Beta Repository And Ownership
backstage.catalog-info-valid

Verifies that the catalog-info.yaml file is syntactically valid and passes Backstage descriptor schema checks (no lint errors reported by the collector). Fails if the file is missing or has lint errors.

backstage catalog-info lint schema validation
Get Started View All Backstage Guardrails

Compatible Integrations

This guardrail works with the following integrations. Click to see how to use Catalog Info Valid with each collector.

+
Catalog Info Valid + Backstage Collector Provides parsed Backstage catalog metadata at .catalog.native.backstage
→

Enable This Guardrail

Add the parent policy to your lunar-config.yml to enable this guardrail.

📄 lunar-config.yml 
policies:
  - uses: github://earthly/lunar-lib/policies/backstage@v1.0.5
    include: [catalog-info-valid]
    # with: ...

How This Guardrail Works

This guardrail is part of the Backstage Guardrails policy. It evaluates data collected by integrations and produces a pass/fail check with actionable feedback.

When enabled, this check runs automatically on every PR and in AI coding workflows, providing real-time enforcement of your engineering standards.

Learn How Lunar Works →
1
↓ Integrations Gather Data
Collectors extract metadata from code, CI pipelines, tool outputs, and scans
2
{ } Centralized as JSON
All data merged into each component's unified metadata document
3
✓ This Guardrail Checks Current
Catalog Info Valid runs and provides pass/fail feedback

Related Guardrails

Other guardrails in the Backstage Guardrails policy.

Guardrail Repository And Ownership
Catalog Info Exists

Verifies that a catalog-info.yaml file exists in the repository. Every Backstage-managed service must have a catalog...
Guardrail Repository And Ownership
Owner Set

Validates that the owner field (spec.owner) is populated in the catalog-info.yaml. Ownership is required for incident...
Guardrail Repository And Ownership
Lifecycle Set

Validates that the lifecycle stage (spec.lifecycle) is defined in the catalog-info.yaml. Lifecycle stages (production,...
Guardrail Repository And Ownership
System Set

Validates that the system grouping (spec.system) is defined in the catalog-info.yaml. System assignment enables...
Backstage Guardrails

Backstage Guardrails

This guardrail is part of the Backstage Guardrails policy, which includes 5 guardrails for repository and ownership.

View Policy

Ready to Automate Your Standards?

See how Lunar can turn your AGENTS.md, engineering wiki, compliance docs, or postmortem action items into automated guardrails with our 100+ built-in guardrails.

Works with any process
check AI agent rules & prompt files
check Post-mortem action items
check Security & compliance policies
check Testing & quality requirements
Automate Now
Paste your AGENTS.md or manual process doc and get guardrails in minutes
Book a Demo