Skip to content

Instantly share code, notes, and snippets.

Engineering Architecture Decision-Making Strategy

Executive Summary: We will implement a federated architecture decision framework combining team autonomy with coordinated oversight, using Architecture Decision Records for documentation and a lightweight advisory process to eliminate decision-making ambiguity while maintaining engineering velocity.

Policy

Our policies for engineering architecture decision-making are:

1. Federated Decision Authority Framework

  • Team-Level Decisions: Product engineering teams have full authority over architecture decisions that affect only their services and don't create cross-team dependencies

Engineering Strategy Generation Prompt

You are an expert engineering strategist tasked with creating a comprehensive engineering strategy. Use the structured approach from "Crafting Engineering Strategy" and other proven strategy frameworks.

Problem Statement

Our engineering organization lacks a clear, consistent process for making software architecture decisions, leading to friction between engineers who feel excluded from decisions versus those who feel slowed down by lengthy approval processes. This ambiguity around decision-making authority—particularly when a few highly opinionated

Engineering Strategy: Architecture Decision-Making Process

Executive Summary

Our engineering organization needs a structured approach to architecture decision-making that balances engineering velocity with thoughtful technical governance. We will implement a federated advisory model that empowers teams while providing appropriate coordination mechanisms.

Diagnosis

Based on our analysis of the current state and industry research, we've identified the following root causes and constraints:

Technical Constraints

# Engineering Strategy Generation Prompt
You are an expert engineering strategist tasked with creating a comprehensive engineering strategy. Use the structured approach from "Crafting Engineering Strategy" and other proven strategy frameworks.
## Problem Statement
Our engineering organization lacks a clear, consistent process for
making software architecture decisions, leading to friction between
engineers who feel excluded from decisions versus those who feel
slowed down by lengthy approval processes. This ambiguity around
decision-making authority—particularly when a few highly opinionated

Exploration: Engineering Architecture Decision-Making Frameworks

Industry Patterns and Precedents

Based on research across technology organizations, three distinct approaches have emerged for managing architecture decision-making, each with documented successes and failures:

1. Advisory Architecture Process (Stripe/Netflix Model)

Stripe's approach:

Exploration: Engineering Architecture Decision-Making Frameworks

Industry Patterns and Precedents

Based on research across technology organizations, three distinct approaches have emerged for managing architecture decision-making, each with documented successes and failures:

1. Advisory Architecture Process (Stripe/Netflix Model)

Stripe's approach, as documented in their engineering strategy work, employs an advisory architecture review process where:

  • Architecture decisions are made by the implementing team

Engineering Strategy Generation Prompt

You are an expert engineering strategist tasked with creating a comprehensive engineering strategy. Use the structured approach from "Crafting Engineering Strategy" and other proven strategy frameworks.

Problem Statement

Our engineering organization lacks a clear, consistent process for making software architecture decisions, leading to friction between engineers who feel excluded from decisions versus those who feel slowed down by lengthy approval processes. This ambiguity around decision-making authority—particularly when a few highly opinionated

# Engineering Strategy Generation Prompt
You are an expert engineering strategist tasked with creating a comprehensive engineering strategy. Use the structured approach from "Crafting Engineering Strategy" and other proven strategy frameworks.
## Problem Statement
{problem statement}
## Strategy Requirements
Create a complete engineering strategy following this proven structure:
#!/usr/bin/env python3
import argparse
import json
import os
import re
import sys
from urllib import request
from urllib.error import HTTPError
@lethain
lethain / lc.markdown
Last active January 26, 2020 18:16
CFP submission for "Service Mesh in Kubernetes: it’s not that easy"

Successful CFP submission by Lita Cho, included in this list

Service Mesh in Kubernetes: it’s not that easy

KubeCon 2019

In this talk, presenters will share lessons from several years of experience running Envoy in production at scale. They will explore practical techniques for triaging issues in a service mesh, along with the intuition behind them. The presenters will cover a broad range of topics including traffic capture, issues specific to GRPC, health checks, and techniques useful during incident mitigation. The talk will end with a deep dive into Envoy stats and their use in resolving issues.

Envoy 2019