docs: AI project context (docs/ai) and repository documentation refresh

- docs/ai/: stable, repo-verified context - README, architecture, tech-stack,
  edge-cases, plan (confirmed active work only), migration-tofu (the blue-green
  OpenTofu migration runbook and per-service findings), legacy-warning, links.
- AGENTS.md: slimmed to a working contract that points at docs/ai instead of
  restating it; CLAUDE.md is an adapter that @-includes it.
- README.md, ansible/README.md, ansible/roles/README.md,
  roles/lxc_docker_host/README.md: bring wording in line with the current
  control plane (Makefile entry point, registry, tofu, memoir-bot gone).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012uoq5AVK8mkBgg83Mq6o5V

README.md

@@ -2,6 +2,7 @@
 
 Активная инфраструктура домашней лаборатории управляется через Ansible.
 Каноничные инструкции для людей и агентов — в [AGENTS.md](./AGENTS.md).
+Стабильный архитектурный контекст и риски — в [docs/ai/](./docs/ai/README.md).
 
 ## Быстрый старт
 
@@ -32,7 +33,8 @@ make deploy-gitea           # применить
 make update-gitea           # бэкап -> обновление -> health-check
 ```
 
-`.env` с Proxmox-токенами подхватывается автоматически. Опасные цели требуют `CONFIRM=1`.
+Секреты лежат в `.env` в **корне репозитория** (в `.gitignore`); его подхватывают
+и Ansible, и OpenTofu. Опасные цели требуют `CONFIRM=1`.
 
 ## SSH руками
 
@@ -49,12 +51,13 @@ Include /home/ada/Documents/Projects/HomeLab/infras/ansible/ssh_config
 - `ansible/inventory/group_vars/all/services.yml` — реестр сервисов (VMID, IP, порты, домены, образы)
 - `flake.nix` — dev-окружение
 - `.gitea/workflows/lint.yml` — CI: yamllint, ansible-lint, syntax-check
+- `docs/ai/` — архитектура, stack, edge cases и legacy boundaries для агентов
 - `archive/2026-07-proxmox-migration/` — исторические NixOS/Docker конфиги, только как справка
 
 ## Grimmory MCP
 
-`tools/grimmory-mcp/` содержит read-only интеграцию с Grimmory API для OpenCode
-и явно вызываемые инструменты синхронизации с Obsidian.
+`tools/grimmory-mcp/` содержит read-only интеграцию с Grimmory API для OpenCode.
+Явно вызываемые sync tools записывают сгенерированные заметки и обложки в Obsidian.
 
 ```bash
 npm install --prefix tools/grimmory-mcp
@@ -62,6 +65,6 @@ npm run configure --prefix tools/grimmory-mcp
 npm test --prefix tools/grimmory-mcp
 ```
 
-OpenCode регистрирует сервер глобально. После перезапуска OpenCode используй
-`/grimmory-sync` для обновления заметок книг в `90 Library/Books` и обложек
-в `99 System/Export/Grimmory/Covers`.
+Глобальная регистрация MCP в OpenCode выполняется вне этого репозитория. После
+настройки используй `/grimmory-sync` для обновления заметок книг в
+`90 Library/Books` и обложек в `99 System/Export/Grimmory/Covers`.