Adapter Pattern for Multi-Cloud Portability
Abstract base classes with minimal interfaces let the same RAG pipeline run on four different cloud providers without conditional logic in business code.
architecture (14 lessons)
Lazy Imports for Optional Cloud Dependencies
Deferring cloud SDK imports to runtime lets the same codebase run with or without any given SDK installed, and enables testing without real dependencies.
RAG Corpus Chunking Strategy
Splitting documents at H2 headings with stable IDs and content hashes produces predictable, debuggable chunks that support incremental re-indexing.
Rule-Based Gap Detection Without ML
Seven heuristic rules detect when a RAG corpus can't answer a query, without training data or a classifier — transparent and debuggable, with known trade-offs.
Harvester Design Decisions
Key choices in building the lesson harvester — recursive scanning, path-based slugs, and integrated export generation.
Lesson 035: Design System Portability via Tokens
A design system built on CSS custom properties (design tokens) can be shared across completely independent frontends — s...
Lesson 040: Controlled Vocabulary as Schema Contract
The vision tagging pipeline needs a consistent set of image attributes shared across five components: the vision model p...
Provider-Agnostic Plugin Architecture
When a system needs to support multiple "providers" (vendors, brands, data sources) that share the same behavior but dif...
Schema Enforcement at the Data Layer
Adding runtime schema validation to your data loading layer catches entire categories of bugs that would otherwise surfa...
Schema Variant Consolidation
When multiple people or processes author data files for the same system without a shared schema, variant schemas emerge....
Crosswalk and Taxonomy Evolution
Occupation codes are not stable identifiers across taxonomy revisions. The same SOC code can refer to different occupati...
Design System Cross-Pollination
When two projects share an author, the stronger design system should inform the weaker one — but adopting visual feel is...
Dimensional Modeling for Labor Data
A four-layer warehouse architecture (raw, staging, core, marts) with strict separation of concerns at each layer produce...
Schema Drift Detection
Government data sources change column names, add or remove columns, and retype columns between releases — often without ...