The Ad-Hoc Tax: How Backstage Recovered Platform Capacity for Higher-Value Work
Our platform team was spending roughly half its workload on ad-hoc support before I pushed for Backstage. This wasn't a generic internal-developer-platform argument — the specific pain points were new service creation, onboarding, scattered runtime visibility, difficult Kafka topic observability, and fragmented access to deployment and platform tools.
That framing matters because the effort here is architectural and operational, not cosmetic. It covers the developer problems, the portal capabilities, the target runtime for Backstage itself, the rollout phases, the quality gates, and the success criteria.
1. The platform failure mode was specific, not vague
The platform team was spending about 50 percent of its workload on ad-hoc requests. That's not just a morale issue — it means the platform is failing to encode repeated work into reusable capability. The developer problems that justified an IDP rollout were concrete:
- Navigating disparate tools and services across multiple teams.
- Slow onboarding for new engineers.
- Friction around new service creation and deployment.
- Poor observability for events and Kafka topics.
- Scattered runtime visibility for configs, app versions, and topic usage.
This is more technical than a broad statement about developer experience. Service metadata, deployment state, event topology, and onboarding guidance already existed, but nothing exposed them through one coherent surface — so developers kept falling back to manual requests.
I tied this to automation maturity, targeting a meaningful shift away from manual intervention and toward portal-driven workflows. That's the first concrete problem I was solving: ad-hoc support had become a structural property of the platform, not an exception.
2. The solution was a capability map, not just a portal homepage
The implementation effort really shows in the objectives. I positioned Backstage as a platform surface that could aggregate and expose several specific capability sets:
- Technical OKR visibility such as code quality and security posture.
- Deployment and scaffolding workflows.
- Config management and events management.
- Developer task management such as pending PRs, assigned issues, and approval flow visibility.
- Runtime observability for configs, versions, Kafka topics, and topic consumption.
- Aggregation of platform services that were previously scattered across separate internal tools.
That's why I kept naming concrete artifacts: Service Catalog, API Catalog, Events Catalog, Resource Catalog, Config Management, and Developer Dashboard. Those aren't marketing phrases — they're the actual product surfaces the platform team built and shipped.
Official Backstage documentation mirrors this capability model. The Software Catalog and Software Templates are relevant references here because they map directly to what I was trying to institutionalize: discoverability, scaffolding, and workflow standardization.
3. The architecture defines how Backstage actually runs
The architecture decisions matter as much as the portal UX. I identified the Backstage Framework on Node.js and TypeScript, with GitHub repositories and GitHub Actions as the primary integration surface, and defined an infrastructure path for the portal itself:
- An MVP footprint using separate web and API app services with PostgreSQL.
- A production-oriented target with isolated lower and production environments and dedicated PostgreSQL instances.
- Placement inside shared platform infrastructure for longer-term operation.
Deciding where Backstage itself lives, how it integrates into delivery pipelines, and how much environment separation to require before calling it production-ready was as important as the portal UX itself.
It also clarifies why Backstage over a thinner internal UI. I'm leaning on Backstage's plugin model and its ability to aggregate catalog data, scaffolding, deployments, and observability into a single surface rather than requiring separate custom tools for each concern. The official Backstage overview is relevant here because I'm using Backstage as a platform framework, not just a developer portal skin.
4. The implementation plan is technical, phased, and measurable
The rollout isn't vague. It defines three phases with concrete capability increments:
- Phase 1: Backstage platform scaffolding, Service Catalog, API Catalog, Okta SSO, deployments, microservice scaffolding, and config management.
- Phase 2: production readiness, Events Catalog, Resource Catalog, bulk deployment support, and deeper platform integration.
- Phase 3: work management, personalized developer dashboards, service quality views, and SRE-facing dashboards.
Testing and validation matter too. I run selective developer trials with users both familiar and unfamiliar with Backstage, and pair the rollout with SonarCloud, unit testing, and Dependabot on every merge. The portal gets treated like production platform software, not just an internal utility page.
This isn't merely "phased rollout." It's a concrete backlog of platform capabilities with environment, identity, deployment, catalog, and quality-gate implications.
5. The evaluation criteria show what success looks like
I don't stop at implementation. Here's how I measure whether the portal is actually working:
- Deployment efficiency from PR approval to deployment.
- Deployment frequency improvements.
- Platform responsiveness, reliability, latency, and error rates.
- Reduction in ad-hoc support time.
- Adoption of service catalog, templates, and documentation features.
- Growth in number of services onboarded.
- User satisfaction and onboarding feedback.
- Documentation coverage and cross-team contribution patterns.
That's what makes this credible as engineering work rather than a desired platform state on a slide. It's proof that the platform is reducing toil and improving delivery outcomes. The official Backstage docs on authentication and catalog descriptor format are relevant because they show the operational depth available once the portal moves from concept to actual adoption.
References
- Backstage: What is Backstage?
- Backstage Software Catalog
- Backstage catalog descriptor format
- Backstage Software Templates
- Backstage authentication docs
Closing thought
The technical weight here is in the specifics: service catalog, API catalog, deployment orchestration, event visibility, config management, phased rollout, and measurable adoption criteria. That's why Backstage was worth proposing. It wasn't a nicer dashboard. It was a structured plan to turn platform knowledge into platform software.