Skip to content

Latest commit

Β 

History

29 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ› οΈ Ultimate Platform Engineering Guide

136 questions across 20 topics - answered to the depth an interviewer actually expects.

Role tracks: Platform Engineer (junior β†’ staff) Β· DevEx Β· Platform Architect Β· Kubernetes Platform Β· Platform Security Β· Platform SRE Β· AWS Β· Azure Β· GCP Β· FinOps Β· Platform Lead

Every answer gives you a short answer you can say out loud, the detail and trade-offs behind it, a runnable example, and the follow-ups to expect.

Validate Questions Topics Difficulty License

Pick your role Β· Browse topics Β· All questions Β· Knowledge graph Β· How answers are structured Β· Contributing

🌌 Explore the knowledge graph β†’ - all 136 questions as a live map of the concepts they share.

⭐ Star the project if it helps you land the role.


🎯 What this guide is

Platform engineering interviews are not infrastructure interviews with a new title. They probe a specific set of judgements: whether you can design an interface other engineers will voluntarily use, where you put a guardrail versus a golden path, how you version a contract forty teams depend on, and how you know whether any of it worked.

This guide is organised around those judgements. It assumes you already know what a Pod is, and spends its pages on the decisions above that line - tenancy boundaries, control-plane design, escapable abstractions, rollout policy, cost attribution, and the operating model of a team whose customers are other engineers.

New to the field, or moving in from DevOps or SRE? Start with Platform Engineering Fundamentals, then Developer Experience. The vocabulary in those two topics is assumed by everything else.


πŸš€ Pick your role

Eleven tracks, each a reading order rather than a pile of links. Start at the left and work right.

Interview in a fortnight? Start with Platform Engineering Interviews - it covers the loop structure, the platform design round, how to present work you have done, and what to ask back, cross-linked to the rest of the guide.

🎯 Target role Read in this order
Interviewing now Interviews β†’ Fundamentals β†’ Architecture β†’ Kubernetes Platform β†’ GitOps
Junior / Associate Fundamentals β†’ Developer Experience β†’ Kubernetes Platform β†’ GitOps β†’ Environments
Senior Platform Engineer Architecture β†’ Control Planes β†’ Multi-Tenancy β†’ Reliability β†’ Security
Platform Architect Architecture β†’ Multi-Tenancy β†’ Control Planes β†’ Multi-Cloud β†’ Governance
Developer Experience Developer Experience β†’ Fundamentals β†’ Environments β†’ GitOps β†’ Operating Model
Kubernetes Platform Kubernetes Platform β†’ Control Planes β†’ Multi-Tenancy β†’ GitOps β†’ Governance
Platform Security Security β†’ Governance β†’ Multi-Tenancy β†’ Control Planes β†’ Observability
Platform SRE Reliability β†’ Observability β†’ Progressive Delivery β†’ Kubernetes Platform β†’ Multi-Tenancy
AWS Platform Engineer AWS β†’ Control Planes β†’ Security β†’ Kubernetes Platform β†’ FinOps
Azure / GCP Platform Azure Β· GCP β†’ Control Planes β†’ Governance β†’ Multi-Cloud β†’ FinOps
Platform Lead / Staff+ Operating Model β†’ FinOps β†’ Fundamentals β†’ Architecture β†’ Reliability

πŸ“š Browse all topics

Grouped by theme, with question counts and difficulty mix. Click a topic to open its index, which opens with what interviewers probe there.

136 questions across 20 topics - 🟒 11 Beginner Β· 🟑 56 Intermediate Β· πŸ”΄ 69 Advanced

🧱 Platform Foundations

Topic Questions 🟒 🟑 πŸ”΄ What it covers
Platform Engineering Fundamentals 8 3 3 2 what a platform actually is, why self-service is the defining property, and where platform…
Developer Experience 7 1 5 1 cognitive load, service catalogues, portals, scorecards, onboarding time, and the metrics that…

πŸ—οΈ Platform Architecture

Topic Questions 🟒 🟑 πŸ”΄ What it covers
Platform Architecture 8 1 3 4 control plane versus data plane, the developer-facing API, escapable abstractions, interface…
Multi-Tenancy and Isolation 6 0 2 4 tenancy models, namespace versus cluster boundaries, noisy neighbours, quotas, network…

☸️ Kubernetes and Control Planes

Topic Questions 🟒 🟑 πŸ”΄ What it covers
Kubernetes Platform 8 1 2 5 cluster topology, node pools and scheduling, fleet upgrades, admission control as a platform…
Control Planes and Abstractions 6 0 1 5 Crossplane, custom resources as platform contracts, workload specifications, Terraform at scale,…

πŸ” Delivery and Progressive Rollout

Topic Questions 🟒 🟑 πŸ”΄ What it covers
GitOps and Continuous Delivery 8 1 4 3 Argo CD and Flux, repository structure at scale, environment promotion, secrets, drift…
Progressive Delivery and Feature Flags 8 0 2 6 flags as a platform capability, flag debt and its SLAs, rollout curves with abort criteria,…
Environments and Ephemeral Infrastructure 6 0 4 2 preview environments per pull request, data seeding without leaking production, environment…

πŸ” Security and Governance

Topic Questions 🟒 🟑 πŸ”΄ What it covers
Platform Security 8 0 2 6 workload identity without long-lived keys, secretless pipelines, secrets management,…
Policy as Code and Governance 6 0 4 2 OPA and Kyverno, rolling out policy without breaking teams, compliance frameworks mapped to…

☁️ Cloud Platforms

Topic Questions 🟒 🟑 πŸ”΄ What it covers
AWS Platform Engineering 7 0 3 4 multi-account organisation design, account vending, EKS pod identity, runtime selection,…
Azure Platform Engineering 6 0 3 3 management groups and landing zones, Azure Policy guardrails, AKS workload identity, runtime…
GCP Platform Engineering 6 0 3 3 the folder and project hierarchy, organisation policies, Workload Identity Federation, GKE…
Multi-Cloud and Hybrid Platforms 5 0 2 3 genuine drivers versus slogans, the cost of portable abstractions, cross-provider primitive…

πŸ“ˆ Reliability and Observability

Topic Questions 🟒 🟑 πŸ”΄ What it covers
Platform Reliability 7 0 2 5 SLOs for a platform rather than an app, error budget policy, platform on-call, incidents where…
Platform Observability 6 0 3 3 OpenTelemetry collectors as shared infrastructure, cardinality and cost control, zero-effort…

πŸ’° Economics and Operating Model

Topic Questions 🟒 🟑 πŸ”΄ What it covers
Platform FinOps 6 1 2 3 cost attribution for shared infrastructure, showback versus chargeback, unit economics,…
Platform Team and Operating Model 7 1 3 3 Team Topologies, staffing, adoption metrics, migration without a mandate, deprecation, the RFC…

🎀 Interview Prep

Topic Questions 🟒 🟑 πŸ”΄ What it covers
Platform Engineering Interviews 7 2 3 2 the loop structure, the platform design round, presenting your own platform work,…

πŸ“‹ All questions

Every question in the repository, collapsed by topic - open only the ones you are studying.

🧱 Platform Foundations

15 questions

Platform Engineering Fundamentals Β· 8 questions Β· 🟒 3 🟑 3 πŸ”΄ 2

Open the Platform Engineering Fundamentals index β†’

No. Question Difficulty
1 What is platform engineering? 🟒 Beginner
2 What is an internal developer platform? 🟒 Beginner
3 How is platform engineering different from DevOps and SRE? 🟒 Beginner
4 What is a golden path and how does it differ from a mandate? 🟑 Intermediate
5 What is the thinnest viable platform? 🟑 Intermediate
6 How do you decide whether your organisation needs a platform team? 🟑 Intermediate
7 What does it mean to run a platform as a product? πŸ”΄ Advanced
8 What are the most common ways platform initiatives fail? πŸ”΄ Advanced
Developer Experience Β· 7 questions Β· 🟒 1 🟑 5 πŸ”΄ 1

Open the Developer Experience index β†’

No. Question Difficulty
9 What is developer experience and how do you measure it? 🟑 Intermediate
10 What is cognitive load and why does it drive platform design? 🟑 Intermediate
11 What is a service catalogue and why does a platform need one? 🟑 Intermediate
12 What is Backstage and when is it the wrong choice? 🟑 Intermediate
13 How do you reduce the time it takes a new engineer to ship to production? 🟑 Intermediate
14 How do you design service scorecards that teams do not resent? πŸ”΄ Advanced
15 How do you run documentation as a platform capability? 🟒 Beginner

πŸ—οΈ Platform Architecture

14 questions

Platform Architecture Β· 8 questions Β· 🟒 1 🟑 3 πŸ”΄ 4

Open the Platform Architecture index β†’

No. Question Difficulty
16 What is the difference between a control plane and a data plane in a platform? 🟑 Intermediate
17 How do you design the developer-facing API of a platform? πŸ”΄ Advanced
18 How do you keep a platform abstraction escapable? πŸ”΄ Advanced
19 How do you version a platform interface and migrate consumers? πŸ”΄ Advanced
20 When should a platform capability be a service, a library, or a template? 🟑 Intermediate
21 How do you write an architecture decision record for a platform choice? 🟒 Beginner
22 How do you choose a datastore for a platform service? 🟑 Intermediate
23 How do you decide whether to build or buy a platform capability? πŸ”΄ Advanced
Multi-Tenancy and Isolation Β· 6 questions Β· 🟒 0 🟑 2 πŸ”΄ 4

Open the Multi-Tenancy and Isolation index β†’

No. Question Difficulty
24 What tenancy models can a platform offer? 🟑 Intermediate
25 When do you give a tenant its own cluster instead of a namespace? πŸ”΄ Advanced
26 How do you stop one tenant degrading another? πŸ”΄ Advanced
27 How do you isolate tenants at the network layer? 🟑 Intermediate
28 How do you isolate tenant identity and data? πŸ”΄ Advanced
29 How do you design tenant onboarding and offboarding? πŸ”΄ Advanced

☸️ Kubernetes and Control Planes

14 questions

Kubernetes Platform Β· 8 questions Β· 🟒 1 🟑 2 πŸ”΄ 5

Open the Kubernetes Platform index β†’

No. Question Difficulty
30 Why does Kubernetes end up as the substrate for most platforms? 🟒 Beginner
31 How do you design cluster topology for a platform? πŸ”΄ Advanced
32 How do you design node pools and scheduling for mixed workloads? 🟑 Intermediate
33 How do you upgrade a fleet of clusters without breaking tenants? πŸ”΄ Advanced
34 What is admission control and how do you use it as a platform lever? 🟑 Intermediate
35 When should you write a Kubernetes operator? πŸ”΄ Advanced
36 How do you run a service mesh as a platform capability? πŸ”΄ Advanced
37 How do you keep platform components consistent across many clusters? πŸ”΄ Advanced
Control Planes and Abstractions Β· 6 questions Β· 🟒 0 🟑 1 πŸ”΄ 5

Open the Control Planes and Abstractions index β†’

No. Question Difficulty
38 What is Crossplane and how does it differ from Terraform? πŸ”΄ Advanced
39 How do you model a platform API with Kubernetes custom resources? πŸ”΄ Advanced
40 What problem does a workload specification like Score solve? 🟑 Intermediate
41 How do you manage Terraform at platform scale? πŸ”΄ Advanced
42 How do you handle resource deletion safely in a control plane? πŸ”΄ Advanced
43 How do you provide self-service infrastructure without handing out cloud credentials? πŸ”΄ Advanced

πŸ” Delivery and Progressive Rollout

22 questions

GitOps and Continuous Delivery Β· 8 questions Β· 🟒 1 🟑 4 πŸ”΄ 3

Open the GitOps and Continuous Delivery index β†’

No. Question Difficulty
44 What is GitOps and what does it actually guarantee? 🟒 Beginner
45 How do Argo CD and Flux differ, and how do you choose? 🟑 Intermediate
46 How do you structure repositories for GitOps at scale? πŸ”΄ Advanced
47 How do you promote a change from staging to production in GitOps? πŸ”΄ Advanced
48 How do you handle secrets in a GitOps workflow? 🟑 Intermediate
49 What is configuration drift and how does a platform detect it? 🟑 Intermediate
50 How do you keep templated manifests reviewable? 🟑 Intermediate
51 How do you give teams self-service pipelines without maintaining 200 of them? πŸ”΄ Advanced
Progressive Delivery and Feature Flags Β· 8 questions Β· 🟒 0 🟑 2 πŸ”΄ 6

Open the Progressive Delivery and Feature Flags index β†’

No. Question Difficulty
52 How do you run feature flags as a platform capability? πŸ”΄ Advanced
53 How do you manage feature flag debt? πŸ”΄ Advanced
54 How do you design a progressive rollout and its abort criteria? πŸ”΄ Advanced
55 How do you design a kill switch you can trust? πŸ”΄ Advanced
56 When do you use a feature flag instead of a canary deployment? 🟑 Intermediate
57 How do you keep percentage rollouts consistent across services? πŸ”΄ Advanced
58 What can a feature flag not roll back? πŸ”΄ Advanced
59 How do you test code that sits behind feature flags? 🟑 Intermediate
Environments and Ephemeral Infrastructure Β· 6 questions Β· 🟒 0 🟑 4 πŸ”΄ 2

Open the Environments and Ephemeral Infrastructure index β†’

No. Question Difficulty
60 What is an ephemeral environment and when is it worth it? 🟑 Intermediate
61 How do you build preview environments for every pull request? πŸ”΄ Advanced
62 How do you seed realistic test data without copying production? πŸ”΄ Advanced
63 What does environment parity actually require? 🟑 Intermediate
64 How do you stop ephemeral environments becoming a cost problem? 🟑 Intermediate
65 How do you give developers a fast inner development loop? 🟑 Intermediate

πŸ” Security and Governance

14 questions

Platform Security Β· 8 questions Β· 🟒 0 🟑 2 πŸ”΄ 6

Open the Platform Security index β†’

No. Question Difficulty
66 How does a platform provide workload identity without long-lived credentials? πŸ”΄ Advanced
67 How do you run a secretless CI/CD pipeline? πŸ”΄ Advanced
68 How do you manage secrets as a platform capability? 🟑 Intermediate
69 How do you secure the software supply chain for everything the platform builds? πŸ”΄ Advanced
70 How do you keep base images patched across every team? 🟑 Intermediate
71 How do you respond to a critical CVE that affects every service on the platform? πŸ”΄ Advanced
72 How do you design break-glass access to production? πŸ”΄ Advanced
73 How do you threat model a platform? πŸ”΄ Advanced
Policy as Code and Governance Β· 6 questions Β· 🟒 0 🟑 4 πŸ”΄ 2

Open the Policy as Code and Governance index β†’

No. Question Difficulty
74 What is policy as code and where does it belong in a platform? 🟑 Intermediate
75 How do Gatekeeper and Kyverno differ, and how do you choose? 🟑 Intermediate
76 How do you roll out a new policy without breaking every team? πŸ”΄ Advanced
77 How do you turn a compliance framework into automated platform controls? πŸ”΄ Advanced
78 How do you handle policy exceptions without eroding the guardrails? 🟑 Intermediate
79 What audit trail does a platform owe its auditors? 🟑 Intermediate

☁️ Cloud Platforms

24 questions

AWS Platform Engineering Β· 7 questions Β· 🟒 0 🟑 3 πŸ”΄ 4

Open the AWS Platform Engineering index β†’

No. Question Difficulty
80 How do you structure a multi-account AWS platform? πŸ”΄ Advanced
81 What is account vending and how do you automate it? πŸ”΄ Advanced
82 How do you give pods on EKS access to AWS resources safely? 🟑 Intermediate
83 How do you choose between ECS, EKS, Lambda, and App Runner for a platform runtime? 🟑 Intermediate
84 How do you manage EKS node capacity with Karpenter? πŸ”΄ Advanced
85 How do you build a paved road for AWS infrastructure self-service? πŸ”΄ Advanced
86 How do you allocate AWS cost back to teams? 🟑 Intermediate
Azure Platform Engineering Β· 6 questions Β· 🟒 0 🟑 3 πŸ”΄ 3

Open the Azure Platform Engineering index β†’

No. Question Difficulty
87 How do you structure an Azure platform with management groups and landing zones? πŸ”΄ Advanced
88 How do you use Azure Policy as a platform guardrail? 🟑 Intermediate
89 How do workload identities work on AKS? 🟑 Intermediate
90 How do you choose between AKS, Container Apps, App Service, and Functions? 🟑 Intermediate
91 How do you use Bicep for platform modules and subscription vending? πŸ”΄ Advanced
92 How do you design private networking for Azure PaaS services? πŸ”΄ Advanced
GCP Platform Engineering Β· 6 questions Β· 🟒 0 🟑 3 πŸ”΄ 3

Open the GCP Platform Engineering index β†’

No. Question Difficulty
93 How do you structure a GCP platform with folders, projects, and organisation policies? πŸ”΄ Advanced
94 How does Workload Identity Federation remove service account keys? 🟑 Intermediate
95 How do you choose between GKE, GKE Autopilot, and Cloud Run? 🟑 Intermediate
96 How do you design Shared VPC for a multi-team GCP platform? πŸ”΄ Advanced
97 How do you use Config Connector and Config Sync as a GCP control plane? πŸ”΄ Advanced
98 How do you automate project vending on GCP? 🟑 Intermediate
Multi-Cloud and Hybrid Platforms Β· 5 questions Β· 🟒 0 🟑 2 πŸ”΄ 3

Open the Multi-Cloud and Hybrid Platforms index β†’

No. Question Difficulty
99 When is multi-cloud a real requirement rather than a slogan? 🟑 Intermediate
100 What does a genuinely portable platform abstraction cost you? πŸ”΄ Advanced
101 How do you map equivalent primitives across AWS, Azure, and GCP? 🟑 Intermediate
102 How do you design a hybrid platform spanning on-premises and cloud? πŸ”΄ Advanced
103 How does data gravity constrain platform design? πŸ”΄ Advanced

πŸ“ˆ Reliability and Observability

13 questions

Platform Reliability Β· 7 questions Β· 🟒 0 🟑 2 πŸ”΄ 5

Open the Platform Reliability index β†’

No. Question Difficulty
104 How do you define SLOs for a platform rather than an application? πŸ”΄ Advanced
105 What does an error budget policy look like for a platform team? πŸ”΄ Advanced
106 How do you run on-call for a platform team? 🟑 Intermediate
107 How do you run an incident when the platform itself is the incident? πŸ”΄ Advanced
108 How do you make a platform degrade gracefully instead of failing closed? πŸ”΄ Advanced
109 How do you plan disaster recovery for the platform itself? πŸ”΄ Advanced
110 How do you use chaos engineering to test platform guarantees? 🟑 Intermediate
Platform Observability Β· 6 questions Β· 🟒 0 🟑 3 πŸ”΄ 3

Open the Platform Observability index β†’

No. Question Difficulty
111 How do you provide observability as a platform capability? 🟑 Intermediate
112 How do you run an OpenTelemetry collector as a platform service? πŸ”΄ Advanced
113 How do you control metric cardinality and observability cost? πŸ”΄ Advanced
114 What telemetry should every service get without writing code? 🟑 Intermediate
115 How do you make traces useful across team boundaries? πŸ”΄ Advanced
116 How do you give teams visibility into platform state that affects them? 🟑 Intermediate

πŸ’° Economics and Operating Model

13 questions

Platform FinOps Β· 6 questions Β· 🟒 1 🟑 2 πŸ”΄ 3

Open the Platform FinOps index β†’

No. Question Difficulty
117 What is FinOps and what part of it does a platform team own? 🟒 Beginner
118 How do you attribute shared platform cost to teams? πŸ”΄ Advanced
119 What is the difference between showback and chargeback, and which works? 🟑 Intermediate
120 How do you build unit economics for a platform? πŸ”΄ Advanced
121 How do you use commitments and spot capacity on behalf of every team? πŸ”΄ Advanced
122 How do you find and remove idle platform cost? 🟑 Intermediate
Platform Team and Operating Model Β· 7 questions Β· 🟒 1 🟑 3 πŸ”΄ 3

Open the Platform Team and Operating Model index β†’

No. Question Difficulty
123 What does Team Topologies say about platform teams? 🟒 Beginner
124 How do you size and staff a platform team? 🟑 Intermediate
125 How do you measure platform adoption and success? 🟑 Intermediate
126 How do you migrate teams onto the platform without a mandate? πŸ”΄ Advanced
127 How do you deprecate a platform capability? πŸ”΄ Advanced
128 How do you run an RFC process for platform decisions? 🟑 Intermediate
129 How do you build a platform roadmap and say no? πŸ”΄ Advanced

🎀 Interview Prep

7 questions

Platform Engineering Interviews Β· 7 questions Β· 🟒 2 🟑 3 πŸ”΄ 2

Open the Platform Engineering Interviews index β†’

No. Question Difficulty
130 What does a platform engineering interview loop look like? 🟒 Beginner
131 How do you answer a platform design interview question? πŸ”΄ Advanced
132 How do you present platform work you have done? 🟑 Intermediate
133 How do you answer 'how would you build a platform from scratch'? πŸ”΄ Advanced
134 How do you handle a troubleshooting round? 🟑 Intermediate
135 What behavioural questions do platform interviews ask, and why? 🟑 Intermediate
136 What should you ask your interviewer about their platform? 🟒 Beginner

🧠 How answers are structured

Every answer follows the same four beats, so you can read one section deep or all four:

Section What it gives you
Short answer Two or three sentences you could say out loud. Start here.
Detail The substance - mechanisms, trade-offs, and the vocabulary that signals experience.
Example Real manifests, policies, commands, or diagrams you can run and adapt.
Interview tips The follow-up questions, the common traps, and the points that separate a strong answer from a memorised one.

Difficulty is marked 🟒 Beginner Β· 🟑 Intermediate Β· πŸ”΄ Advanced. The distribution skews senior, because the field does: most platform roles are filled at senior and above, and the interesting questions are about judgement rather than recall.

Three ways to work through it:

  • Preparing for a specific role - take the track from Pick your role, and read each topic README's "What interviewers probe here" before its questions.
  • Broad revision - read the short answers across a topic, then go deep only where you hesitate.
  • Obsidian / note vault - every file carries YAML frontmatter (title, id, category, difficulty, tags), so the whole repository can be dropped into a vault and browsed by tag.

🌌 The knowledge graph

Platform engineering questions do not sit in neat boxes: tenancy decides your isolation boundary, which decides your policy model, which decides what your golden path can promise. The knowledge graph makes those dependencies visible - every question is a node, and two questions are linked when they genuinely argue about the same concept.

The links are derived, not hand-maintained. Each answer is scanned for the ~70 concepts this field turns on (control plane, golden path, policy as code, blast radius, error budget, chargeback, …), and a pair is linked when the concepts they share are rare across the vault. Rarity weighting is what stops "kubernetes" linking everything to everything; length normalisation stops the longest answers becoming hubs.

python3 scripts/build_knowledge_graph.py --output docs/index.html   # the deployed page
python3 scripts/build_knowledge_graph.py --stats                    # edge counts, hubs, orphans
python3 scripts/build_knowledge_graph.py --json docs/graph.json     # the raw graph
python3 scripts/inject_wikilinks.py                                 # write the same edges into the question files

Three renderings ship with the builder and are selectable with --prototype:

Prototype What it is for
constellation (deployed) Force-directed map of the whole vault, clustered by theme. Click a question to light up its neighbourhood.
atlas The capability map: groups and topics laid out in reading order, with concept links drawn on demand.
pathway Difficulty lanes that generate a study route - the questions to read before the hard one makes sense.

The page is a single self-contained HTML file with no dependencies, deployed to GitHub Pages by knowledge-graph.yml on every push to main.

inject_wikilinks.py writes the same edges into each question's ## Related Questions block, between <!-- RELATED:START --> and <!-- RELATED:END --> markers, as both [[wikilinks]] (for Obsidian-style vaults) and relative links (for GitHub). It is idempotent, and --check fails CI when a block has drifted from the graph.


πŸ› οΈ Repository structure

.
β”œβ”€β”€ platform-engineering-fundamentals/   # topic-slug/
β”‚   β”œβ”€β”€ README.md                        #   generated topic index
β”‚   └── what-is-platform-engineering.md  #   question-slug.md
β”œβ”€β”€ ...
β”œβ”€β”€ scripts/
β”‚   β”œβ”€β”€ lib_content.py                   # shared frontmatter/vault parsing
β”‚   β”œβ”€β”€ generate_indexes.py              # regenerates all indexes from question files
β”‚   β”œβ”€β”€ validate_content.py              # CI validation of the whole vault
β”‚   β”œβ”€β”€ build_knowledge_graph.py         # derives the concept graph, renders the HTML site
β”‚   β”œβ”€β”€ inject_wikilinks.py              # writes graph edges into `## Related Questions` blocks
β”‚   └── topic_meta.json                  # topic registry: order, group, description, study notes
β”œβ”€β”€ docs/
β”‚   └── index.html                       # generated knowledge graph, deployed to GitHub Pages
└── .github/workflows/
    β”œβ”€β”€ validate-and-format.yml          # runs validation + Prettier on every PR
    └── knowledge-graph.yml              # rebuilds and deploys the graph on push to main

Directories and filenames carry no numeric prefixes - they are pure slugs. Ordering comes from two places instead:

  • Topic order - the order field in scripts/topic_meta.json, which is also the registry of which directories count as topics.
  • Question order - the id field in each question's frontmatter, unique across the repository.

Renaming or reordering is therefore a metadata edit, not a mass file rename.

Every question file starts with frontmatter:

---
title: "What is a golden path and how does it differ from a mandate?"
id: 4
category: "Platform Engineering Fundamentals"
difficulty: "Intermediate"
tags:
  - platform-engineering
  - platform-engineering-fundamentals
  - interview-questions
---

The indexes are generated, not hand-written. The question files are the single source of truth; topic READMEs and the tables above are rendered from their frontmatter. After adding or editing a question:

python3 scripts/generate_indexes.py       # rewrite all indexes
python3 scripts/inject_wikilinks.py       # refresh the related-questions blocks
python3 scripts/build_knowledge_graph.py --output docs/index.html   # rebuild the graph page
python3 scripts/validate_content.py       # verify frontmatter, naming, links, index freshness

Both are stdlib-only Python 3.11+ - no dependencies to install. CI runs the same commands and fails the pull request on drift.


🀝 Contributing

New questions, better answers, and corrections are all welcome. CONTRIBUTING.md covers the file format, naming rules, and the local checks to run before opening a pull request.

Not sure where to start? Open an issue - there are templates for a new question, a correction to an existing answer, a new topic, and broken links or tooling.

Two documents set the ground rules: the Code of Conduct - including the rules on interviewer privacy, NDAs, and plagiarism - and the Security Policy, which covers how to report a committed credential, a workflow vulnerability, or a dangerously over-permissive example policy privately.

🧭 Related

Three sibling repositories, same structure, same tooling - pick the one that matches the role you are interviewing for:

  • Ultimate DevOps Guide - DevOps, SRE, DevSecOps, and cloud engineering. Start there for container, CI/CD, Linux, and networking fundamentals; this guide assumes them.
  • Ultimate AI Engineering Guide - LLM fundamentals, prompt engineering, RAG, agents and MCP, fine-tuning, evaluation, and LLMOps. The counterpart for AI platform and AI engineering loops, where this guide covers the infrastructure the models run on.
  • Ultimate Platform Engineering Guide (you are here) - the platform layer between the two: golden paths, control planes, tenancy, and the operating model of a team whose customers are other engineers.

πŸ™ Acknowledgements

The vocabulary this guide uses is not invented here. It leans on the work of the platform engineering community:

  • Team Topologies by Matthew Skelton and Manuel Pais - platform teams as enabling teams, cognitive load as the design constraint, and the thinnest viable platform.
  • CNCF Platforms Working Group - the platform maturity model and the capability-plane vocabulary.
  • Google SRE - SLOs, error budgets, and the toil framing that platform reliability builds on.
  • OpenFeature, OpenTelemetry, Crossplane, Backstage, and Argo CD - the open standards and projects most of these answers reference.
  • DORA - the delivery metrics used throughout to argue about outcomes rather than output.

πŸ“„ License

Released under the MIT License.

About

136 platform engineering interview questions across 20 topics - short answer, detail, worked example, and interview tips for each, plus a derived knowledge graph of the concepts they share.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages