housekeeping

name	housekeeping
description	Фоновое обслуживание проекта: актуальность README, CHANGELOG, версии, .gitignore, метафайлов.
allowed-tools	Read Edit Write Glob Grep Bash
disable-model-invocation	true

Skill: Housekeeping

Запускается по запросу пользователя или агента. Агент должен вызывать housekeeping перед git push — это его ответственность, не автоматический хук. Проверяет и приводит в порядок всё, что могло устареть.

Что проверять

1. README.md

Прочитать README.md и сравнить с реальным состоянием проекта:

• Описание проекта — соответствует ли текущему функционалу?
• Инструкция по установке — npm install / pip install актуальны? Зависимости не изменились?
• API / usage — описанные endpoints, функции, CLI-команды существуют в коде?
• Примеры — работают ли примеры кода?

Если README устарел — обновить автоматически. Не спрашивать пользователя.

2. CHANGELOG.md

Если в проекте есть CHANGELOG.md:

# Коммиты после последней записи в CHANGELOG
git log --oneline $(grep -m1 -oP '\d+\.\d+\.\d+' CHANGELOG.md 2>/dev/null | head -1)..HEAD

Если есть незадокументированные коммиты — дописать секцию с новыми изменениями. Формат: Keep a Changelog (Added, Changed, Fixed, Removed).

Если CHANGELOG.md нет — создать, если в проекте больше 10 коммитов.

3. Версия

Если в проекте есть package.json или pyproject.toml:

• Проверить: были ли breaking changes (новые/удалённые API, изменение интерфейсов)?
• Если да → bump minor или major
• Если только fixes → bump patch
• Обновить версию в package.json / pyproject.toml

Не публиковать. Только обновить номер.

4. .gitignore audit

Проверить git status на наличие файлов, которые по commit-policy должны быть в .gitignore:

# Проверить на запрещённые паттерны в tracked files
git ls-files | grep -E '\.(env|key|pem|db|sqlite)$'
git ls-files | grep -E '^(node_modules|__pycache__|dist|build)/'

Если найдены — git rm --cached, добавить в .gitignore.

5. Метафайлы фреймворка

• .claude/SNAPSHOT.md — дата обновления не старше последнего коммита?
• manifest.md — заполнены ли project_name и repo_access?

Если SNAPSHOT устарел — обновить. Если manifest пустой — заполнить на основе анализа проекта (basename → project_name, git remote → repo_access).

6. Drift detection

Сравнить то, что описано в документации, с тем, что реально есть в коде:

# Пример: функции упомянутые в README но отсутствующие в коде
# Endpoints описанные в docs/ но не существующие в src/

Если обнаружен drift — исправить документацию автоматически.

Когда запускать

• Перед push — агент обязан вызвать housekeeping перед git push (это правило агента, не автоматический хук)
• По запросу — пользователь говорит «наведи порядок» или «housekeeping»
• При /finish — если finish включает push

Чего НЕ делать

• Не менять код проекта — только документацию и метафайлы
• Не пушить автоматически
• Не удалять файлы пользователя
• Не тратить больше 3 минут на housekeeping