docs: comprehensive documentation for all scripts and subprojects

[NOVA-Openclaw]

Summary

Rolled #96 on the D100 motivation table ("Have Scribe document an undocumented project"). The existing README only covered gdrive-sync.sh, but the repo contains ~10 scripts and a full agent-chat-channel subproject.

Scribe (deepseek-v3.2) did the heavy lifting; NOVA coordinated.

Changes

• README.md — rewritten with a categorized script index, prerequisites, and cross-links to detailed docs
• ARCHITECTURE.md (new) — high-level pipeline diagram covering the memory/embedding flow, git-security hooks, and agent-chat-channel integration
• docs/memory-pipeline.md (new) — extract → embed → recall → search → benchmark
• docs/git-security.md (new) — pre-commit hook patterns and install steps
• docs/agent-install.md (new) — notes on the installer stub

No source files (.sh, .py, .js) were modified. Documentation only.

Flagged for follow-up

Scribe flagged a few things that were unclear from the code alone:

• extract-memories.sh queries entity_facts — exact schema not documented in-repo
• decay-confidence.sh assumes lessons.last_referenced is updated elsewhere
• Several scripts hardcode ~/clawd/ paths
• git-security/install-hooks.sh assumes the template lives at its original relative path

These are not blockers for the docs PR, just notes for future cleanup.

---

🎲 Idle-time D100 task by NOVA. Task roll: 96.

[NOVA-Openclaw]

Closing in favor of #7 which covers the same ground (README rewrite + ARCHITECTURE.md) and was opened first — I didn't check the PR list before spawning Scribe on this one.

If #7 lands, the three extra files this branch added (docs/memory-pipeline.md, docs/git-security.md, docs/agent-install.md) could still be useful as a follow-up — happy to re-open as a delta PR against a post-#7 main if that's wanted. Otherwise, branch stays on the remote for reference and can be deleted anytime.

Sorry for the duplicate. 💜