Добавил конвенции для логирования

CLAUDE.md

@@ -2,7 +2,8 @@
 
 Памятка для работы над jellybit. Перед задачей прочитай также
 [README.md](README.md), [BRIEF.md](BRIEF.md) и
-[docs/specs/architecture.md](docs/specs/architecture.md).
+[docs/specs/architecture.md](docs/specs/architecture.md). Разработка идёт
+по **Spec Driven Development** через OpenSpec — см. раздел ниже.
 
 ## Что это
 
@@ -34,14 +35,57 @@
   перезаписываем.
 - **Выход LLM недоверенный** — безопасность на валидации пути, не на
   промпте. Авто-раскладка только при подтверждённом матче в базе.
+- **Секреты не попадают в логи** — пароли qBittorrent, API-ключи LLM/метабаз,
+  auth-заголовки. Подробнее — [docs/conventions/logging.md](docs/conventions/logging.md).
 - **Запуск:** контейнер под `1000:1000`, в общей docker-сети (адресация
   по именам), mount `/srv/media` (единая песочница) + data-том для
   SQLite/конфига.
 
-## Документация: три раздела
+## Spec Driven Development (OpenSpec)
 
-- `docs/specs/` — **живые** спецификации целевого состояния. Меняем по
-  мере развития, держим в соответствии с кодом.
+Изменения ведём через [OpenSpec](https://github.com/Fission-AI/OpenSpec)
+(CLI `openspec`, v1.x). Сначала спецификация — потом код.
+
+- `openspec/specs/<capability>/spec.md` — **актуальные** capability-спеки:
+  что система делает сейчас. Capability — это поведение/домен (`ingest`,
+  `recognition`, `file-layout`, `review`, `notifications`), а не пакет кода.
+- `openspec/changes/<id>/` — предлагаемое изменение: `proposal.md` (зачем и
+  что), `design.md` (как, для нетривиальных), дельта-спеки (`ADDED`/
+  `MODIFIED`/`REMOVED Requirements`), `tasks.md` (шаги). После реализации
+  change архивируется в `openspec/changes/archive/`, дельты вливаются в
+  `openspec/specs/`.
+- `openspec/config.yaml` — язык и правила оформления спек (читай перед
+  написанием).
+
+Поток работы — через слэш-команды `opsx:*` (канонический набор, его
+поддерживает `openspec update`): `opsx:explore` (продумать), `opsx:propose`
+(завести change), `opsx:apply` (реализовать tasks), `opsx:sync`/`opsx:archive`
+(влить и архивировать). Skills `openspec-*` — то же, но предыдущего
+поколения; для новой работы используем `opsx:*`.
+
+Правила спек:
+
+- Каждое `### Requirement` ОБЯЗАНО содержать литерал `SHALL` или `MUST` —
+  иначе `openspec validate` падает.
+- Структурные заголовки и ключевые слова — английские (`### Requirement:`,
+  `#### Scenario:`, `GIVEN/WHEN/THEN`, RFC 2119), остальной текст — русский.
+- Сценарии — в формате `GIVEN/WHEN/THEN`.
+- `openspec validate --strict` перед коммитом change.
+
+Ревью (процесс, не артефакт): нетривиальная задача — два чекпоинта (ревью
+дизайна после design/specs, ДО кода; ревью кода после apply, до archive);
+тривиальная — одного прохода по коду достаточно.
+
+**Миграция:** capabilities постепенно переносятся из `docs/specs/` в
+OpenSpec (пилот — `ingest`). До переноса источник истины по теме —
+соответствующий файл в `docs/specs/`; перенесённое живёт в
+`openspec/specs/`.
+
+## Прочая документация
+
+- `docs/specs/` — **живые** спецификации целевого состояния (архитектурный
+  обзор + ещё не перенесённые в OpenSpec темы). Меняем по мере развития,
+  держим в соответствии с кодом.
 - `docs/adr/` — **неизменяемый** журнал решений, пишется постфактум,
   хранит *почему*. Правила — [docs/adr/README.md](docs/adr/README.md).
 - `docs/drafts/` — черновики: планы, идеи, ещё не принятые решения. Не
@@ -72,5 +116,9 @@ Module path — `git.vakhrushev.me/av/jellybit`. Go 1.26, `CGO_ENABLED=0`.
 - Раскладка: `cmd/jellybit` (точка входа) + `internal/<пакет>` по
   компонентам из [architecture.md](docs/specs/architecture.md).
 - Ошибки оборачиваем с контекстом (`fmt.Errorf("...: %w", err)`).
-- Логирование только через `slog`, без `fmt.Println`.
+- Логирование только через `slog`, без `fmt.Println` — уровни, обязательные
+  поля и что не логировать см. [docs/conventions/logging.md](docs/conventions/logging.md).
 - Время — всегда с явным TZ (сервер в `Europe/Moscow`).
+
+Кросс-каттинг конвенции (как пишем код, а не что система делает) живут в
+[docs/conventions/](docs/conventions/README.md) и не переносятся в OpenSpec.