docs: align development docs with current code behavior

src/test_logs/TEST_LOG_2026-02-26T02-43-51Z.md

@@ -0,0 +1,25 @@
+---
+agent: docs-alignment-agent
+cadence: daily
+run-start: 2026-02-26T02-43-51Z
+---
+
+# Validation Log
+
+1. Internal markdown link existence check
+- Command:
+  - `python3` script scanning `README.md` + `docs/**/*.md` for local link targets
+- Result: PASS
+- Evidence: `BROKEN_LINK_COUNT=0`
+
+2. Stale-link pattern scan
+- Command:
+  - `rg -n "docs/docs/content|src/seedpass/cli.py" README.md docs/ARCHITECTURE.md -S`
+- Result: PASS (no matches after fixes)
+
+3. Representative CLI docs command validation
+- Command:
+  - `poetry run seedpass --help`
+- Result: WARN (environment setup issue)
+- Output summary: `ModuleNotFoundError: No module named 'seedpass'`
+- Interpretation: local Poetry env in this workspace is not installed/resolved for package execution; this does not invalidate static doc/code alignment updates.