A spec nobody re-checks against the running system is worse than no spec: reviewers trust the document instead of the diff while the agent follows whatever the code actually does. Agents regenerate code fast, and each regeneration is a fresh chance for spec and implementation to diverge. The fix is a small enforceable link between requirement, design decision, tests, and the commits that changed them.
This blog’s source of truth and CI live on GitLab. The public site is served from GitHub Pages at devopstales.github.io. Hugo builds in a container, the job writes into a separate Pages repository, and readers never see GitLab’s job logs—only the static tree.
Roadster’s default sidebar search sends queries to Google (or DuckDuckGo) with a site filter. That works until the corpus is large and you want typo tolerance, facets by section/tags, and results that stay on your domain. Algolia hosts the index; Hugo emits a JSON dump at build time; atomic-algolia pushes only the diff from GitLab CI after hugo succeeds.