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.
implementation (7 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.
Static Search with Pagefind
Integrating Pagefind for full-text search on a static site with no backend.
Validation Severity Model
Why the validator uses ERROR/WARNING/INFO levels and why warnings never fail the build.