# claude-md-master

Главный навык для жизненного цикла CLAUDE.md: создание, обновление и улучшение
на основе проверенных данных репозитория, с поддержкой нескольких модулей и правил для разных стеков.

## Обзор
- Цель: создавать точные и краткие `CLAUDE.md` из реальных данных репозитория.
- Объём: корень и значимые модули с определением особенностей стека.
- Защита: без секретов и пустого текста; перед записью нужно явное одобрение.

## Как ИИ находит и применяет навык
- Обнаружение: инструмент узнаёт о навыке, потому что тот есть в каталоге навыков репозитория (установлен или доступен в окружении).
- Автоматическое применение: если запрос содержит «создать/обновить/улучшить CLAUDE.md», инструмент выбирает этот навык как наиболее подходящий.
- Ручной запуск: оператор может явно вызвать `/claude-md-master`, чтобы применить этот процесс.
- При работе навык изучает документацию, конфигурацию и исходники, предлагает изменения и ждёт явного согласия до записи файлов.

## Для кого
- Для операторов ИИ, применяющих навыки в Cursor или Claude Code.
- Для сопровождающих, которые развивают правила и справочники.

## Что делает
- Создаёт или обновляет `CLAUDE.md` с проверенным содержанием из репозитория.
- Соблюдает строгие правила безопасности и краткости: без секретов и пустого текста.
- Обнаруживает репозитории с несколькими модулями и создаёт модульные `CLAUDE.md`.
- Использует справочники по стекам, чтобы точно описать паттерны.

## Когда использовать
- Пользователь просит создать, улучшить, обновить или стандартизировать `CLAUDE.md`.
- Репозиторию нужны последовательные, проверенные инструкции для работы ИИ.

## Обязательные исходные данные (изучи их)
- Документация репозитория: `README.md`, `docs/*`, если есть.
- Файлы сборки и конфигурации для найденного стека или стеков.
- Конфигурация запуска: `Dockerfile`, `.env.example`, `config/*`, если есть.
- CI: `.github/workflows/*`, `.gitlab-ci.yml`, `.circleci/*`, если есть.
- Корни исходников, чтобы извлечь реальные структуру, типы, аннотации и имена.

## Результат
- Корневой `CLAUDE.md` — всегда.
- Модульные `CLAUDE.md` для значимых модулей (с конфигурацией сборки и `src/`).
- Краткий отчёт об изменениях с перечнем созданных и обновлённых файлов и резервных копий.

## Порядок работы (в общих чертах)
1. Найти существующие варианты `CLAUDE.md` и определить, первый это запуск или повторный.
2. Определить стек или стеки и структуру модулей.
3. Прочитать нужные документы, конфигурацию и CI ради реальных команд и процедур.
4. Проверить корни исходников на структуру, ключевые типы, аннотации и паттерны.
5. Создать корневой и модульные файлы без повторов, используя `@/CLAUDE.md`.
6. Перед применением изменений запросить явное одобрение.
7. Применить изменения и вывести отчёт.

## Основные правила и ограничения
- Только проверенные по репозиторию сведения; никаких секретов.
- Краткость: корень — не более 200 строк, модуль — не более 120.
- Команды должны быть реальными и пригодными для копирования из документации, скриптов или CI репозитория.
- Пропускай пустые разделы и общие советы.
- Никогда не меняй `.claude.local.md`.
- Не добавляй примеры кода в разделы «Делай/Не делай».

## Правило для нескольких модулей (кратко)
- Всегда создавай корневой `CLAUDE.md`.
- Отдельные модульные файлы создавай только для значимых модулей.
- Пропускай каталоги только для инструментов (например, `buildSrc`, `gradle`, `scripts`, `tools`).
- Бизнес-модулю нужен свой файл, если в нём более пяти файлов или есть собственный README.

## Справочники по стекам
Каждый справочник задаёт признаки обнаружения, источники для подготовки, цели проверки кодовой базы, обязательные пункты результата, источники команд и ключевые пути.

- `references/android.md` — Android/Gradle
- `references/ios.md` — iOS/Xcode/Swift
- `references/react-web.md` — веб-приложения React
- `references/react-native.md` — React Native
- `references/node.md` — инструменты Node в общем случае
- `references/python.md` — Python
- `references/java.md` — Java/JVM
- `references/dotnet.md` — .NET (C#/F#)
- `references/go.md` — Go
- `references/rust.md` — Rust
- `references/flutter.md` — Dart/Flutter
- `references/ruby.md` — Ruby/Rails
- `references/php.md` — PHP (Laravel/Symfony/CI/Phalcon)
- `references/elixir.md` — Elixir/Erlang
- `references/cpp.md` — C/C++
- `references/generic.md` — запасной вариант, если ни один стек не подошёл

## Расширение навыка
- Добавляй новый `references/<stack>.md` по тому же шаблону.
- Признаки обнаружения и обязательные пункты должны быть конкретными и проверяемыми.
- Не вводи непроверенные команды или общие советы.

## Контроль качества
- Каждое правило ссылается на реальные типы или пути репозитория.
- Нет незаполненных шаблонов.
- Нет секретов.
- Команды реальны и пригодны для копирования.
- Соблюдено правило «сначала отчёт»; справочники вложены на один уровень.