# Backstage Catalog

> Use when editing Backstage catalog entities, ownership, relations, annotations, or discovery examples.

- Skill: `paulasilvatech/backstage-catalog-3` (Agent Skill)
- Install (CLI): `npx skillmds@latest add paulasilvatech/backstage-catalog-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/paulasilvatech/backstage-catalog-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: paulasilvatech (https://skillmd.com/u/paulasilvatech)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/paulasilvatech/backstage-catalog-3

---


<!-- Generated from harness/github-copilot/plugins/open-horizons-platform/instructions/backstage-catalog.instructions.md by harness/claude-code/scripts/convert_from_copilot.py. Edit the source, not this file. -->

# Backstage Software Catalog

## Conventions

- Declare `apiVersion`, `kind`, kebab-case `metadata.name`, a useful description, and a resolvable `spec.owner`.
- Use lowercase kebab-case tags and stable namespaces; avoid encoding environments or mutable deployment details in entity identity.
- Express relationships with supported entity references and verify referenced owners, systems, components, APIs, resources, and locations exist.
- Keep `github.com/project-slug`, source locations, and TechDocs annotations pointed at real repositories and tracked paths.
- Use `ohorizons.ai/*` only for Open Horizons agent metadata; do not invent competing top-level fields.
- Keep examples ingestible and sanitized because templates and local catalog bootstrap consume them.
- Avoid duplicate entity triplets of `kind`, `namespace`, and `name`.

## Verification

- Catalog validation resolves owners and relation targets.
- Location targets and source annotations exist.
- Entity examples contain no credentials, tenant IDs, or customer-specific values.

## Do / Do Not

| Do | Do not |
| --- | --- |
| Preserve stable entity identity, ownership, and resolvable relations. | Create duplicate entity triplets or dangling references. |
| Validate locations and sanitize examples. | Put credentials, tenant IDs, or customer data in catalog files. |

## Checklist Before Opening a PR

- [ ] The change matches this instruction's `applyTo` scope.
- [ ] Owners, relations, locations, and source annotations resolve.
- [ ] Entity identity remains unique and stable.
- [ ] Catalog validation passes and examples are sanitized.
- [ ] No unrelated edits or unresolved placeholders remain.