Posts

Put Expiration Dates on Your Golden Paths

-
A paved road can become a legacy road Golden paths help engineering teams start quickly and operate consistently. They package sensible defaults for repositories, pipelines, observability, security controls, and runtime configuration. But a golden path is not automatically a current path. Without deliberate maintenance, the recommended approach slowly accumulates outdated dependencies, unnecessary controls, and assumptions that no longer match how teams build software. Because the path carries an official label, developers may continue using it long after better options exist. Platform leaders should treat every golden path as a versioned product with an expiration date. Expiration does not mean automatic deletion. It creates a decision point where the organization must renew, replace, or retire the path. Define renewal criteria before launch A golden path should not remain recommended simply because it still works. Its owners should periodically verify that it remains supportabl...
Post a Comment
Read more

Treat Platform Backlogs as Investment Decisions

-
Platform teams often manage their backlog like a collection of internal feature requests. The loudest stakeholder, the largest team, or the most urgent escalation moves to the front. That approach feels responsive, but it produces a fragmented platform. Teams deliver one-off integrations and narrow workflow improvements while foundational problems remain unresolved. A platform backlog should be treated as an investment portfolio. Every item must compete for limited engineering capacity based on the value it creates across the organization. Prioritize Reusable Leverage The strongest platform investments remove recurring effort from multiple teams. They make a secure, reliable delivery path easier to use without requiring repeated coordination. Evaluate backlog items against a small set of practical questions: How many teams face this problem? How frequently does the friction occur? Does solving it reduce risk, delay, or operational work? Can the solution become a reusable cap...
Post a Comment
Read more

Every Critical Service Needs a Reliability Owner

-
Shared ownership sounds collaborative, but it often produces unclear decisions. When a critical service has no named reliability owner, operational risks remain visible without becoming actionable. A reliability owner is not the person expected to fix every incident. The role is accountable for ensuring that reliability decisions are made, funded, and followed through. That distinction matters. Accountability should be clear even when implementation is distributed across several teams. Ownership Must Include Decision Rights Assigning a name in a service catalog is not enough. The owner needs authority to influence priorities when reliability work competes with feature delivery. For each critical service, the reliability owner should be able to: Define service-level objectives with product and business partners. Escalate unresolved operational risks. Prioritize work triggered by error budget consumption. Confirm that incident actions have owners and deadlines. Challenge d...
Post a Comment
Read more

AI Coding Assistants Need Faster Feedback, Not Bigger Promises

-
Generated Code Is Only the First Step AI coding assistants can reduce the effort required to draft code, tests, documentation, and configuration. That matters, but typing has rarely been the main constraint in software delivery. Code still has to be understood, reviewed, integrated, secured, deployed, and operated. If those feedback loops are slow or unreliable, generating more code simply moves the queue downstream. Technology leaders should therefore treat AI adoption as a delivery-system change, not a tool rollout. The goal is not to maximize suggestions accepted. The goal is to improve the safe flow of valuable changes into production. Find the New Bottleneck Once teams produce changes faster, existing weaknesses become more visible. Test suites may take too long. Review queues may grow. Environments may be difficult to obtain. Security checks may generate noisy findings. Deployment pipelines may require manual coordination. These constraints will limit the value of AI regard...
Post a Comment
Read more

Platform Exceptions Are Signals, Not Policy Failures

-
Platform teams often treat exceptions as a governance problem. A team requests a different deployment pattern, runtime, or security control, and the immediate response is to defend the standard. Standards matter. They reduce cognitive load, improve supportability, and make controls easier to automate. But a platform that cannot learn from exceptions will eventually become a constraint rather than an accelerator. Separate valid constraints from avoidable preferences Not every exception deserves approval. Some requests are simply attempts to preserve familiar tools or bypass reasonable controls. Platform teams should ask for the engineering constraint behind the request, not just the requested solution. A useful exception process should capture: The requirement the standard path cannot meet The operational and security risks introduced The owner and expected duration of the exception The evidence needed to remove or renew it This creates accountability without turning the conv...
Post a Comment
Read more

Incident Reviews Should Change the System, Not Grade the People

-
Incident reviews often begin with the right intention and drift into the wrong question. Instead of asking how the system allowed a failure to reach customers, teams start evaluating whether individuals followed the expected process. That shift produces cautious meetings, shallow conclusions, and action items focused on reminders or training. It may create the appearance of accountability, but it rarely improves reliability. Look Beyond the Last Human Action An engineer’s mistake may be the final event before an incident, but it is seldom the complete cause. Reliable systems assume that people will mistype commands, misunderstand alerts, overlook documentation, and make decisions with incomplete information. The useful question is not, “Why did someone make that mistake?” It is, “Why was one ordinary mistake able to create this level of impact?” That question directs attention toward weak deployment controls, unclear ownership, unsafe defaults, missing observability, excessiv...
Post a Comment
Read more

Documentation Is Part of the Platform Contract and Makes Your Agents Better

-
Platform teams often treat documentation as the final step before launch. That is backwards. If developers cannot understand, evaluate, and safely use a capability, the capability is not finished. Good documentation is more than a collection of setup instructions. It is part of the interface between a platform team and its users. Like any interface, it needs clear ownership, predictable structure, and ongoing maintenance. That has always mattered for developers. In an AI-enabled engineering organization, it matters even more. Documentation exposes platform complexity When a basic task requires a long guide filled with exceptions, the documentation is not necessarily the problem. It may be revealing unnecessary complexity in the product. That makes documentation work valuable design feedback. Ask an engineer unfamiliar with the service to follow the guide. Watch where assumptions appear, terminology shifts, or required decisions lack context. Those points often indicate that the platfor...
Post a Comment
Read more