Architecture & engineering notes

Architecture in Practice

Practical notes on architecture, production engineering, and applied AI from 28 years of building software.

More writing

Engineering field notes

5 min read

Why I’m Building ArchGauge and Acme FieldOps Together

I’m building ArchGauge to review architecture evidence and Acme FieldOps to test those reviews against known strengths, defects, fixes, and gaps in evidence.

  • ArchGauge
  • Acme FieldOps
  • software architecture
6 min read

What I’m Studying for Microsoft’s AI-103 Exam

I am using AI-103 study to connect Azure AI features with the harder work of designing, evaluating, securing, and operating an AI application.

  • AI-103
  • Microsoft Azure
  • Azure AI Foundry
5 min read

How I Make Architecture Decisions Under Uncertainty

Architects rarely receive complete information. A sound decision makes risk visible, gathers useful evidence, and preserves a safe path to correction.

  • solution architecture
  • ADR
  • technical leadership
5 min read

Enterprise AI Needs Governed Data Products First

Before an enterprise connects AI to operational data, it needs data products with an owner, a stable meaning, enforceable access, quality evidence, and a support contract.

  • enterprise AI
  • data architecture
  • Azure
5 min read

Why I’m Building BlazeOS as a Clean-Contract System

BlazeOS carries ListBlaze’s workflow evidence into a rebuild centered on explicit ownership, local-first operation, immutable evidence, and recoverable marketplace effects.

  • BlazeOS
  • software architecture
  • local-first
4 min read

AI Agents Need an Authority Ladder

Give an agent more authority only when the use case has earned stronger identity, evaluation, approval, audit, and recovery controls.

  • AI agents
  • agentic AI
  • security architecture
4 min read

Evaluate AI Before and After Production

AI quality is not one score. It is a versioned agreement about useful behavior, unacceptable failure, and the evidence required for change.

  • AI evaluation
  • Microsoft Foundry
  • AI governance
4 min read

Choose the Smallest Responsible AI Pattern

Not every AI problem needs RAG, tools, or an agent. Add probabilistic behavior and autonomy only when each layer earns its cost and risk.

  • AI architecture
  • RAG
  • AI agents
4 min read

Production Readiness Is an Architecture Discipline

A feature can work and still be unsafe to operate. Production readiness is evidence accumulated across the whole workload, from design through recovery.

  • production readiness
  • software architecture
  • reliability
4 min read

Identity Is the Control Plane for Enterprise AI

An AI agent should not become a shortcut around the identity, authorization, data, and audit controls required by the underlying business action.

  • enterprise AI
  • identity
  • authorization
4 min read

CI/CD Is a Production Control System

A mature pipeline does more than automate deployment. It reduces uncertainty, limits blast radius, and makes recovery a practiced part of delivery.

  • CI/CD
  • DevOps
  • Azure
4 min read

Infrastructure as Code Is a Change System

A template can create resources. A mature IaC practice makes infrastructure changes reviewable, repeatable, observable, and recoverable.

  • infrastructure as code
  • Azure
  • Terraform
4 min read

Build, Buy, or Integrate: Make the Ownership Decision

Choose whether to build, buy, or integrate by weighing which capabilities are worth owning and which risks the organization can support over time.

  • solution architecture
  • build vs buy
  • enterprise software
5 min read

Integration Architecture After Acquisitions

Connecting acquired systems is easy to draw and hard to operate. The work begins with meaning, authority, identity, and a migration path.

  • enterprise integration
  • acquisitions
  • Azure
6 min read

SCADA to Cloud Without Moving the Control Boundary

Cloud analytics can create value from operational data without turning an IT application or AI model into an unrestricted control path.

  • SCADA
  • operational technology
  • oil and gas
6 min read

Offline-First Software Is a Business Decision

Offline-first design changes the product promise: teams must define data authority, conflict handling, security, testing, and support before synchronization.

  • offline first
  • field operations
  • mobile architecture
8 min read

Architecture Starts With the Field Workflow

Good oil and gas software starts with the person, decision, constraint, and operating consequence in the field, then earns its technology choices.

  • oil and gas
  • solution architecture
  • field operations
9 min read

Why I Started Building WellOS

WellOS began with a practical question: how can field work, operational data, and business workflows connect while preserving trustworthy boundaries?

  • WellOS
  • oil and gas
  • product architecture