Need Auto-Discovery of API Artifacts
Building an accurate catalog of APIs and services requires automated discovery rather than manual registration that developers resist.
Take Control Of Your Signals — Become a Naftiko Design Partner Today!
Persona Story:
Pat, the head of platforms, needs to build an accurate catalog of APIs and services without requiring developers to manually register and maintain catalog entries.
Problem Context
- Manual catalog registration (YAML files, portal entries) creates extra work developers resist
- Manually entered data goes stale because it’s “an additional process that doesn’t actually do something”
- Teams have existing artifacts (Bruno collections, package.json, code owners, OpenAPI specs) that already define ownership and structure
Problem Impact
- API catalogs are incomplete or outdated because registration is manual
- Platform teams can’t get accurate inventory of what exists
- Developers resist catalog adoption, limiting its value
Naftiko Today
- Backstage Integration provides a catalog infrastructure where capabilities are registered through template scaffolding and one-click creation, reducing manual registration friction
- Capability specs in YAML are machine-readable artifacts that live alongside code in repositories, making them discoverable through standard source-control tooling
- Agent Skills exposure with auto-exposed HTTP APIs for skill discovery/download provides a built-in discovery mechanism for capabilities
- VS Code Extension integrates capability creation into the developer’s existing workflow, so catalog entries are created as a natural byproduct of development
Naftiko Tomorrow
- Capability scaffolding from existing APIs (Second Alpha) would auto-generate capability specs from artifacts teams already have (OpenAPI specs, etc.)
- OpenAPI-to-Naftiko import (May 2026) would bootstrap capability entries from existing API definitions without manual registration
- Naftiko Shipyard MVP (Second Alpha) would provide a centralized discovery layer for all capabilities across the organization
- K8s plugin for Backstage (Beta) would enable runtime discovery of deployed capabilities alongside other platform services