---
name: "auto-docs-updater"
description: "Выборочно обновляет документацию после любых изменений кода. Вызывать всегда после правок кода или функциональности."
---

# Авто‑обновление документации

## Протокол работы (обязательно)
- Сначала дай короткий план (1–3 шага), что именно обновишь и где.
- Если есть неоднозначность — задай вопросы.
- Перед **крупными** правками документации/структуры — получи подтверждение. Если пользователь явно просит запустить проверки/команды — запускай сразу.
- Если пользователь просит только план — остановись на плане.

## Назначение
Этот скилл поддерживает актуальность документации проекта после любых изменений кода. Обновление выполняется выборочно, только в релевантных файлах.

## Когда вызывать
- Всегда после любых изменений кода, логики, экранов, навигации, данных, API, хранилищ.
- При любых изменениях, влияющих на поведение приложения.

## Базовые правила
- Используй простой русский язык.
- Обновляй документацию выборочно, только то, что затронуто задачей.
- Не создавай новые .md файлы, если это не требуется задачей.
- Сохраняй структуру и стиль существующих документов.
- Не добавляй детали, которых нет в коде.
- Перед крупными правками документации сверяйся с проектными правилами.

## Что проверять перед обновлением
Всегда просматривай:
- `README.md`
- `CLAUDE.md`
- `AgentMD/*.md`
- `docs/*.md`
- `design_guidelines.md`

## Как выбирать, что менять
1. Определи, какие модули/экраны/потоки затронуты.
2. Найди документы, где это описано.
3. Обнови только соответствующие разделы, статусы и флоу.
4. Если в документации стоит статус Planned, а функционал реализован — обнови на ✅.
5. Если поменялся способ хранения данных или ключи — зафиксируй это явно.

## Типовые сценарии
- **Изменения в Reader/режимах/прогрессе** → README.md, CLAUDE.md, docs/TECHNICAL_SPECIFICATION.md, docs/DATA_FLOWS.md, docs/USER_FLOWS.md, docs/USER_JOURNEY_MAP.md, docs/COMPONENT_SPECIFICATION.md
- **Изменения в API** → README.md, docs/API_REFERENCE.md, docs/DATA_FLOWS.md
- **Изменения в хранении данных** → README.md, docs/DATA_FLOWS.md, docs/DATABASE_SCHEMA.md
- **Изменения UI/UX** → docs/TECHNICAL_SPECIFICATION.md, docs/COMPONENT_SPECIFICATION.md, design_guidelines.md

## Формат обновлений
- Короткие, точные формулировки.
- Никаких «планируется», если уже реализовано.
- Если функционал не реализован — явно оставляй Planned.

## Проверка после обновлений
- Если были правки кода, запускай `npm run lint`, `npm run check:types`, `npm run check:format` с `HOME=.home`.