Distill best practices from agent-runtimes M1-M3 memory files

12 additions/updates across 5 best-practice files:
- docker-uid-matching: userdel simplification, SSH agent socket UID match
- debugging: GIT_SSH_COMMAND scope limitation
- test-driven-development: subprocess mock gotcha, routing callables,
  Pydantic v2 field_validator defaults, sys.exit at module level
- spec-driven-development: multi-agent orchestration practices (commit WIP,
  self-verify, import conventions, assembly budget)
- validation: test pre-commit hooks after adding dependencies

Source: agent-runtimes/memory/ (decisions, gotchas-docker, gotchas-python,
process-lessons, m1/m2/m3 reflections)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

best-practices/.distill-state.json

@@ -1,41 +1,41 @@
 {
   "version": 1,
-  "last_run": "2026-03-15T10:24:05Z",
+  "last_run": "2026-03-25T12:00:00Z",
   "projects": {
     "agent-runtimes": {
       "path": "/home/paul/dev/claude/projects/agent-runtimes",
-      "last_sha": "2adcc5aea4af520d407b062dcf5c81ff5fd69a73",
-      "last_run": "2026-03-15T10:24:05Z"
+      "last_sha": "d40ea0b39140077a482ce9ae304fad1cf51c832e",
+      "last_run": "2026-03-25T12:00:00Z"
     },
     "claude-foundations": {
       "path": "/home/paul/dev/claude/projects/claude-foundations",
-      "last_sha": "c3a151a87bf726a239532e6739c58e8c41c45f4e",
-      "last_run": "2026-03-15T10:24:05Z"
+      "last_sha": "6c0f2db169b588afa9c92587eef3b64311acc025",
+      "last_run": "2026-03-25T12:00:00Z"
     },
     "cluster-apps/octopus-deploy": {
       "path": "/home/paul/dev/claude/projects/cluster-apps/octopus-deploy",
-      "last_sha": "5989ef737cc5bf0885136259aecbb3726c2bf1c1",
-      "last_run": "2026-03-15T10:24:05Z"
+      "last_sha": "d6aee319f33853ad58ea304d9ea1deedff8444d0",
+      "last_run": "2026-03-25T12:00:00Z"
     },
     "cluster-bootstrap": {
       "path": "/home/paul/dev/claude/projects/cluster-bootstrap",
-      "last_sha": "ab0460488a1251c6c1afdc7df929b3b7cd147243",
-      "last_run": "2026-03-15T10:24:05Z"
+      "last_sha": "edc48d7a3113c049786cf6de74b2f33f101f39ef",
+      "last_run": "2026-03-25T12:00:00Z"
     },
     "custom-claude-skills": {
       "path": "/home/paul/dev/claude/projects/custom-claude-skills",
-      "last_sha": "bb6fb7270590296aa7c1594053cde1bcae114019",
-      "last_run": "2026-03-15T10:24:05Z"
+      "last_sha": "e8e572e0afdcf3895f4a500ec73ec6d95d1cc19c",
+      "last_run": "2026-03-25T12:00:00Z"
     },
     "hugo-accelerator": {
       "path": "/home/paul/dev/claude/projects/hugo-accelerator",
-      "last_sha": "b300687256b70ef9f82781840863534a814496d3",
-      "last_run": "2026-03-15T10:24:05Z"
+      "last_sha": "bf0b1a8bc7ed7964a724a2b8ee6c15b6dc1c926c",
+      "last_run": "2026-03-25T12:00:00Z"
     },
     "small-scripts": {
       "path": "/home/paul/dev/claude/small-scripts",
-      "last_sha": "5230e542360f8b07b7375c943ffb99501f4aacd8",
-      "last_run": "2026-03-15T10:24:05Z"
+      "last_sha": "161c633b42c5535b1c649487a330b23a9fa11626",
+      "last_run": "2026-03-25T12:00:00Z"
     }
   }
 }