DocOps · briandominick · May 21, 2026 · May 21, 2026 · May 23, 2026 · May 29, 2026
diff --git a/.config/commit-conventions.yml b/.config/commit-conventions.yml
@@ -0,0 +1,10 @@
+# Project-local commit convention overrides.
+---
+inherit_from: .vendor/docopslab/commit-conventions.yml
+
+conventions:
+  scopes:
+    labdev:
+      name: docopslab-dev
+      summ: Changes to the docopslab-dev gem and distributed development tooling
+      akas: [docopslab-dev, dev, gem]
diff --git a/.config/docopslab-dev.yml b/.config/docopslab-dev.yml
@@ -85,6 +85,21 @@ tools:
         target: .config/actionlint.yml
         synced: false
 
+  - tool: git-lint
+    files:
+      - source: commit-conventions/base.yml
+        target: .config/.vendor/docopslab/commit-conventions.yml
+        synced: true
+      - source: commit-conventions/project.yml
+        target: .config/commit-conventions.yml
+        synced: false
+      - source: git-lint/base.yml
+        target: .config/.vendor/docopslab/git-lint.yml
+        synced: true
+      - source: git-lint/project.yml
+        target: .config/git-lint.local.yml
+        synced: false
+
 # Local library declaration used by lab release and local tests
 library:
   enabled: true

diff --git a/.config/git-lint.local.yml b/.config/git-lint.local.yml
@@ -0,0 +1,6 @@
+# Project-local git-lint overrides.
+#
+# This file is copied once to `.config/git-lint.local.yml`.
+# Leave it empty to use DocOps Lab defaults, or override keys from
+# `.config/.vendor/docopslab/git-lint.yml`.
+---
diff --git a/.github/workflows/qa.yml b/.github/workflows/qa.yml
@@ -184,7 +184,7 @@ jobs:
           else
             echo "❌ **RuboCop**: Failed" >> $GITHUB_STEP_SUMMARY
           fi
-          
+
           # Vale
           if [ "${{ inputs.skip_vale }}" = "true" ]; then
             echo "⏭️ **Vale**: Skipped" >> $GITHUB_STEP_SUMMARY
@@ -201,4 +201,4 @@ jobs:
             echo "✅ **HTML-Proofer**: Passed" >> $GITHUB_STEP_SUMMARY
           else
             echo "❌ **HTML-Proofer**: Failed" >> $GITHUB_STEP_SUMMARY
-          fi
+          fi
diff --git a/.gitignore b/.gitignore
@@ -33,12 +33,16 @@ vendor/
 # Markdown files (except important docs)
 *.md
 ./!AGENTS.md
+!gems/docopslab-dev/assets/templates/CLAUDE.md
 # DocOps Lab vendor files
 .config/.vendor/
 
+# tag::universal-docopslab-dev-configs[]
 # Generated config files (merged from base + local)
 .config/vale.ini
 .config/htmlproofer.yml
+.config/git-lint.yml
+# end::universal-docopslab-dev-configs[]
 
 # Gem content paths
 gems/**/pkg/

diff --git a/Gemfile b/Gemfile
@@ -6,12 +6,13 @@ source 'https://rubygems.org'
 gem 'docopslab-dev', path: './gems/docopslab-dev'
 # 3rd Party
 gem 'colorize',          '~> 1.1'
-gem 'jekyll',            '~> 4.r'
+gem 'jekyll',            '~> 4.4'
 gem 'pathspec',          '~> 2.1'
 gem 'reverse_markdown'
 gem 'rubyzip', '~> 2.3' # For Vale package building
 gem 'sass'
 # DocOps Lab
+gem 'asciisourcerer'
 gem 'schemagraphy'
 
 group :jekyll_plugins do

diff --git a/Gemfile.lock b/Gemfile.lock
@@ -1,14 +1,15 @@
 PATH
   remote: gems/docopslab-dev
   specs:
-    docopslab-dev (0.3.1)
+    docopslab-dev (0.4.0)
       asciidoctor (~> 2.0)
-      asciisourcerer (~> 0.4)
+      asciisourcerer (~> 0.5)
       brakeman (~> 7.1)
       bundler-audit (~> 0.9)
       debride (~> 1.13)
       fasterer (~> 0.11)
       flog (~> 4.8)
+      git-lint (~> 6.2)
       html-proofer (~> 5.2)
       inch (~> 0.8)
       rake (~> 13.0)
@@ -31,14 +32,15 @@ GEM
     asciidoctor-html5s (0.5.1)
       asciidoctor (>= 1.5.7, < 3.0)
       thread_safe (~> 0.3.4)
-    asciisourcerer (0.4.0)
+    asciisourcerer (0.5.0)
       asciidoctor (~> 2.0)
       asciidoctor-html5s (~> 0.5)
       jekyll (~> 4.4)
       jekyll-asciidoc (~> 3.0)
       kramdown-asciidoc (~> 2.1)
       liquid (~> 4.0)
       reverse_markdown (~> 2.1)
+      yard (~> 0.9)
     ast (2.4.3)
     async (2.32.0)
       console (~> 1.29)
@@ -55,13 +57,19 @@ GEM
       bundler (>= 1.2.0, < 3)
       thor (~> 1.0)
     coderay (1.1.3)
+    cogger (0.14.0)
+      core (~> 0.1)
+      refinements (~> 11.0)
+      tone (~> 0.3)
+      zeitwerk (~> 2.6)
     colorator (1.1.0)
     colorize (1.1.0)
     concurrent-ruby (1.3.5)
     console (1.34.0)
       fiber-annotation
       fiber-local (~> 1.1)
       json
+    core (0.1.6)
     crass (1.0.6)
     csv (3.3.5)
     date (3.5.1)
@@ -73,6 +81,8 @@ GEM
     dry-configurable (1.3.0)
       dry-core (~> 1.1)
       zeitwerk (~> 2.6)
+    dry-container (0.11.0)
+      concurrent-ruby (~> 1.0)
     dry-core (1.1.0)
       concurrent-ruby (~> 1.0)
       logger
@@ -84,6 +94,10 @@ GEM
       concurrent-ruby (~> 1.0)
       dry-core (~> 1.1)
       zeitwerk (~> 2.6)
+    dry-monads (1.10.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.1)
+      zeitwerk (~> 2.6)
     dry-schema (1.14.1)
       concurrent-ruby (~> 1.0)
       dry-configurable (~> 1.0, >= 1.0.1)
@@ -102,6 +116,14 @@ GEM
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
+    etcher (0.5.1)
+      cogger (~> 0.12)
+      core (~> 0.1)
+      dry-monads (~> 1.6)
+      dry-types (~> 1.7)
+      refinements (~> 11.0)
+      versionaire (~> 12.1)
+      zeitwerk (~> 2.6)
     ethon (0.15.0)
       ffi (>= 1.15.0)
     eventmachine (1.2.7)
@@ -121,6 +143,26 @@ GEM
       ruby_parser (~> 3.1, > 3.1.0)
       sexp_processor (~> 4.8)
     forwardable-extended (2.6.0)
+    git-lint (6.2.1)
+      cogger (~> 0.12)
+      core (~> 0.1)
+      dry-container (~> 0.11)
+      dry-monads (~> 1.6)
+      dry-schema (~> 1.13)
+      etcher (~> 0.2)
+      gitt (~> 2.0)
+      infusible (~> 2.2)
+      refinements (~> 11.0)
+      runcom (~> 10.0)
+      sod (~> 0.0)
+      spek (~> 2.0)
+      tone (~> 0.3)
+      zeitwerk (~> 2.6)
+    gitt (2.2.0)
+      core (~> 0.1)
+      dry-monads (~> 1.6)
+      refinements (~> 11.0)
+      zeitwerk (~> 2.6)
     google-protobuf (4.32.0-x86_64-linux-gnu)
       bigdecimal
       rake (>= 13)
@@ -147,6 +189,9 @@ GEM
       sparkr (>= 0.2.0)
       term-ansicolor
       yard (~> 0.9.12)
+    infusible (2.2.1)
+      marameters (~> 2.0)
+      zeitwerk (~> 2.6)
     io-event (1.14.0)
     jekyll (4.4.1)
       addressable (~> 2.4)
@@ -198,6 +243,9 @@ GEM
     loofah (2.25.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.12.0)
+    marameters (2.1.1)
+      refinements (~> 11.0)
+      zeitwerk (~> 2.6)
     mercenary (0.4.0)
     method_source (1.1.0)
     metrics (0.15.0)
@@ -241,6 +289,7 @@ GEM
       parser (~> 3.3.0)
       rainbow (>= 2.0, < 4.0)
       rexml (~> 3.1)
+    refinements (11.1.3)
     regexp_parser (2.11.3)
     reverse_markdown (2.1.1)
       nokogiri
@@ -274,6 +323,10 @@ GEM
       racc (~> 1.5)
       sexp_processor (~> 4.16)
     rubyzip (2.4.1)
+    runcom (10.2.1)
+      refinements (~> 11.0)
+      xdg (~> 7.1)
+      zeitwerk (~> 2.6)
     safe_yaml (1.0.5)
     sass (3.7.4)
       sass-listen (~> 4.0.0)
@@ -297,7 +350,19 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
+    sod (0.3.1)
+      cogger (~> 0.12)
+      dry-container (~> 0.11)
+      infusible (~> 2.2)
+      refinements (~> 11.0)
+      tone (~> 0.3)
+      zeitwerk (~> 2.6)
     sparkr (0.4.1)
+    spek (2.1.1)
+      dry-monads (~> 1.6)
+      refinements (~> 11.0)
+      versionaire (~> 12.0)
+      zeitwerk (~> 2.6)
     stringio (3.2.0)
     subtxt (0.3.0)
     sync (0.5.0)
@@ -313,13 +378,19 @@ GEM
       mize (~> 0.6)
       sync
     to_regexp (0.2.1)
+    tone (0.4.2)
+      refinements (~> 11.0)
+      zeitwerk (~> 2.6)
     traces (0.18.2)
     ttfunk (1.8.0)
       bigdecimal (~> 3.1)
     typhoeus (1.5.0)
       ethon (>= 0.9.0, < 0.16.0)
     unicode-display_width (2.6.0)
+    versionaire (12.1.1)
+      refinements (~> 11.0)
     webrick (1.9.1)
+    xdg (7.1.3)
     yaml (0.4.0)
     yard (0.9.37)
     yell (2.2.2)
@@ -329,12 +400,13 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
+  asciisourcerer
   colorize (~> 1.1)
   docopslab-dev!
   feedjira (~> 3.2)
   http_parser.rb (~> 0.6.0)
   httparty (~> 0.21)
-  jekyll (~> 4.r)
+  jekyll (~> 4.4)
   jekyll-asciidoc (~> 3.0)
   jekyll-redirect-from (~> 0.16)
   jekyll-seo-tag (~> 2.8)

diff --git a/README.adoc b/README.adoc
@@ -574,6 +574,9 @@ See link:https://vale.sh/docs/styles[Vale's Style documentation] for details on
 ==== Asset Library Publishing
 
 These tasks live in the `DocOps/lab` Rakefile and are used to stage and publish library assets to the `labdev-library` branch.
+Generated agent docs follow this chain of truth:
+`_docs/agent/` -> `_site/docs/agent/` -> `gems/docopslab-dev/docs/agent/` -> `.library/` -> `~/.cache/docopslab/dev/library/current/`.
+Downstream projects running `bundle exec rake labdev:sync:docs` read the local cache first when it is available.
 
 .Stage assets from `gems/docopslab-dev/assets/` and generated docs into `.library/`
 [.prompt]
@@ -591,6 +594,13 @@ These tasks live in the `DocOps/lab` Rakefile and are used to stage and publish
 [.prompt]
  bundle exec rake gemdo:push:library
 
+.Build the latest agent docs and load them into the local cache for downstream repo testing
+[.prompt]
+ bundle exec rake gemdo:push:library:docs:local
+
+Use `gemdo:push:library:docs:local` before running `bundle exec rake labdev:sync:docs` in a local downstream checkout such as AsciiSourcerer.
+This avoids testing against a stale `~/.cache/docopslab/dev/library/current/` copy.
+
 
 [[troubleshooting]]
 == Troubleshooting