Essays · Notes · Research

Writing

Technical writing on ideas, patterns and problems worth examining carefully.

Guided collections

Series

Read focused series, one practical question at a time.

  1. Replayable by Design

    Practical notes on pipelines that can be retried, backfilled and recovered safely.

    Complete · 5 parts
  2. From Image to Production

    Practical notes on turning one container image into a configured, verified production release.

    Complete · 4 parts
  3. Designing Data Systems for Production

    Practical notes on shaping a data solution that can be operated, changed and recovered in production.

    In progress · 1 of 6

Latest first

All writing

Every published essay and note, ordered by publication date.

  1. Part 01 / 06

    Start With the Decision, Not the Stack

    A production data architecture starts with the decision it must support. Define the output grain, freshness, correctness and repair promise before choosing the tools.

    • Data systems
    • Cloud infrastructure
    • Software design
  2. Part 04 / 04

    Production Must Confirm the Release

    A rollout becomes the current release only when production evidence matches the intended artifact, configuration, schema and functional path.

    • Cloud infrastructure
    • Software design
  3. Part 03 / 04

    Deployment Is a State Transition

    A production change is safer when provisioning, schema compatibility, rollout and verification move through named states with explicit stop conditions.

    • Cloud infrastructure
    • Software design
  4. Part 02 / 04

    A Container Needs a Runtime Contract

    A stable image becomes a reliable service only when configuration, secrets, state, probes and shutdown behaviour have explicit owners.

    • Cloud infrastructure
    • Software design
  5. Part 01 / 04

    The Image Is the Release

    Build once, name the result by digest and let environments configure the same artifact instead of quietly creating different releases.

    • Cloud infrastructure
    • Software design
  6. Part 05 / 05

    Proving a Pipeline Is Replayable

    Replayability becomes credible when controlled failures produce independently observed evidence that named invariants still hold.

    • Data systems
    • Software design
  7. Part 04 / 05

    Validation Is Not a Publish Protocol

    Passing checks matters only when the evidence, candidate and reader-visible commit belong to the same revision.

    • Data systems
    • Software design
  8. Part 03 / 05

    Late Data Without Endless Reprocessing

    A correction window should bound automatic work without turning older truth into dropped data or a full-history rebuild.

    • Data systems
    • Software design
  9. Part 02 / 05

    Idempotent Writes Are Not Replay Safety

    A table can converge perfectly while the workflow around it still repeats the wrong effect.

    • Data systems
    • Software design
  10. Part 01 / 05

    Backfills Are a Data Model Problem, Not an Airflow Feature

    A scheduler can recreate yesterday's run. Only the data model can make that run safe to publish again.

    • Data systems
    • Software design