Internal Developer Portals with Backstage and AI: The 2026 Playbook
Backstage is the de facto IDP. Adding AI makes it transformative — auto-generated docs, intelligent search, and self-service infrastructure. Here's the architecture.
AI coding agents in 2026 aren’t just autocomplete on steroids. GitHub Copilot Workspace, Cursor Composer, and similar tools now understand entire codebases, plan multi-file changes, and execute complex refactoring tasks autonomously.
For platform engineering teams, this changes everything.
The jump from code completion to agentic coding:
| Capability | 2024 (Copilot v1) | 2026 (Agentic) |
|---|---|---|
| Scope | Single file | Entire repository |
| Action | Suggest next line | Plan & execute multi-file changes |
| Context | Current file + few neighbors | Full codebase + docs + CI results |
| Autonomy | Human types, AI suggests | AI plans, human approves |
| Testing | None | Generates and runs tests |
AI agents can generate complete service scaffolding from a description:
Prompt: "Create a new Python microservice with:
- FastAPI REST endpoints
- PostgreSQL with SQLAlchemy
- Kubernetes deployment manifests
- Helm chart with configurable replicas
- GitHub Actions CI pipeline
- OpenTelemetry instrumentation"
Agent output: 15 files, properly structured, following team conventionsPoint an AI agent at your infrastructure repos:
agent_task = """
Compare the Terraform state in terraform/production/ with
the Kubernetes manifests in k8s/production/.
Identify any configuration drift:
- Resources in Terraform not in K8s manifests
- Ingress rules that don't match security groups
- Environment variables that differ between environments
"""AI agents can review PRs and update documentation automatically:
# .github/workflows/doc-update.yml
on:
pull_request:
types: [closed]
branches: [main]
jobs:
update-docs:
if: github.event.pull_request.merged
steps:
- uses: actions/checkout@v4
- name: AI Documentation Update
run: |
ai-agent review-pr \
--pr-number ${{ github.event.pull_request.number }} \
--update-docs docs/ \
--create-pr# policy.yml - AI agent guardrails
code_generation:
require_review: true
max_files_per_change: 10
blocked_patterns:
- "eval("
- "exec("
- hardcoded_credentials
required_checks:
- unit_tests_pass
- security_scan_clean
- lint_passDon’t trust AI-generated code blindly. Enforce:
The teams that thrive won’t be those who resist AI coding agents — they’ll be those who integrate them thoughtfully into their platform engineering workflows.
Need help integrating AI coding tools into your platform engineering workflow? Let’s talk.
AI & Cloud Advisor with 18+ years experience. Author of 8 technical books, creator of Ansible Pilot, and instructor at CopyPasteLearn Academy. Speaker at KubeCon EU & Red Hat Summit 2026.
Backstage is the de facto IDP. Adding AI makes it transformative — auto-generated docs, intelligent search, and self-service infrastructure. Here's the architecture.
Schedule Kubernetes workloads when and where the grid is greenest. How carbon-aware scheduling works, the tools available, and the business case for sustainable compute.
Deploy confidential containers on Kubernetes using AMD SEV-SNP and Intel TDX. Protect sensitive AI workloads with hardware-level encryption in untrusted environments.