docs: davfs2 hang incident — разбор, лечение, статус проекта

README.md

@@ -1,26 +1,28 @@
-```markdown
-# Project Name
+# Infrastructure
 
-## Description
+Домашняя инфраструктура: единый каталог конфигов, плейбуков, спеков (openspec) и операционного опыта.
 
-### Setup Instructions
-1. Clone the repository
-2. Install dependencies
-3. Configure environment
+## Структура
+- `README.md` — это описание
+- `STATUS.md` — текущее состояние (живой документ, обновляется при закрытии сессии)
+- `PRD.md` — требования к проекту
+- `TODO.md` — журнал задач
+- `WALKTHROUGH.md` — капитанский журнал: разборы инцидентов, команды, выводы
+- `openspec/` — спеки и изменения (openspec workflow)
+- `roles/` — ansible-роли (например, garage)
 
-### Usage Examples
-```bash
-./run.sh
-```
+## Текущее состояние
+См. STATUS.md
 
-### Contribution Guidelines
-- Submit issues
-- Follow code of conduct
-- Submit pull requests
+## Быстрый старт / проверка
+- Проверить монтирование Яндекс.Диска: `grep yandex /proc/mounts`, `ls /mnt/yandex-disk/`
+- Демон davfs2: `ps aux | grep mount.davfs`
+
+## Как фиксировать опыт
+Инцидент разобран → добавить запись в WALKTHROUGH.md (симптом, разбор, команды, выводы) + закрыть задачу в TODO.md.
 
 ## License
-[License Type]
+MIT (см. LICENSE)
 
 ## Security
-[Security Policy]
-```
+См. SECURITY.md