| name | sync-project-rules |
| description | Перегенерирует правила проекта для AI-агентов из фактов репозитория: AGENTS.md (канон), .cursor/rules/dotcore-project.mdc, CLAUDE.md, GEMINI.md. Без README, обложки, бейджей, LoC и аудита - лёгкая часть стандарта DotCore, держит команды/структуру/conventions в AGENTS.md в синхроне с кодом. Use when нужно обновить AGENTS.md или правила агентов после изменения команд, скриптов, модулей, зависимостей или структуры, но без полной регенерации README. Вызывается напрямую и как шаг 5 скилла generate-readme. |
Sync Project Rules
Лёгкий скилл DotCore: перегенерирует правила для агентов (AGENTS.md + нативные rule-файлы), не трогая README, обложку, бейджи, LoC и аудит. Для частого случая «изменились команды или структура, надо обновить AGENTS.md» - без тяжёлого generate-readme.
Главное правило: читай репозиторий, не выдумывай. Источник правды - package.json, Makefile, pyproject.toml, docker-compose.yml, CI, код. Старый AGENTS.md - не авторитет; при расхождении верь коду.
Связь с generate-readme: этот скилл владеет шаблонами правил. generate-readme вызывает его на шаге 5 (правила), а сам отвечает за README, обложку, бейджи, LoC, лицензию и аудит. README этот скилл не трогает.
Когда применять
- Изменились команды/скрипты, модули, зависимости, runtime или структура - обновить
AGENTS.md
- Перегенерировать
.cursor/rules/dotcore-project.mdc, CLAUDE.md, GEMINI.md
- Запросы: «обнови AGENTS.md», «синхронизируй правила проекта», «обнови правила агентов»
- Как шаг правил внутри
generate-readme
Нужен полный README (обложка, бейджи, пересчёт LoC, аудит) - это generate-readme, не этот скилл. Здесь README остаётся как есть.
Язык и тон
- Русский, если проект не целиком на английском. Пакеты и техтермины - как в коде.
- Тон сухой, internal doc.
AGENTS.md и README - один язык; .mdc/CLAUDE.md/GEMINI.md - кратко на том же языке.
Workflow
1. Scan (только rules-relevant)
| Категория | Где смотреть |
|---|
| Runtime | engines, .nvmrc, pyproject.toml, go.mod, Cargo.toml |
| Команды | scripts, Makefile, pyproject scripts, CI .github/workflows/ |
| Зависимости | dependencies, devDependencies, requirements |
| Окружение | docker-compose.yml, Dockerfile, .env.example (имена, не значения) |
| Тесты / lint | CI, pytest.ini, eslint.config, vitest.config |
| Структура | apps/, packages/, src/ - модули по факту |
| Существующие правила | AGENTS.md, CLAUDE.md, .cursor/rules/, GEMINI.md |
Спорное - проверь по коду. README не читаем как авторитет и не правим.
2. Determine launching agent
Определи, из какого агента запущен скилл, и обязательно создай/обнови его нативный rule-файл (таблица в templates.md); если папки нет - создай. AGENTS.md пишется всегда, независимо от агента.
3. Regenerate AGENTS.md
Перепиши каркас по шаблону из templates.md: профиль, быстрый старт, таблица команд, структура, соглашения, env, «что делать / чего не делать», правило README-sync. Слияние обязательно - см. ниже.
4. Regenerate rule files
.cursor/rules/dotcore-project.mdc (alwaysApply: true), CLAUDE.md (обёртка → AGENTS.md), GEMINI.md - по templates.md. Только те, что нужны (агент запуска + уже существующие в репо).
5. Embed README-sync rule
В AGENTS.md, CLAUDE.md, .mdc встрой правило: при глобальных изменениях (команды, модули, зависимости, архитектура, runtime) агент обновляет README через generate-readme. Определения глобального/не-глобального - в templates.md.
Слияние, не затирание (критично)
Богатый проект-специфичный AGENTS.md (кастомные секции: backend, i18n, security, доменные правила) не затирай. Перегенерируй каркас (профиль, команды, структура, conventions, запреты) и сохрани уникальные секции проекта. Fresh regeneration каркаса ≠ потеря проектного контента. Уникальные правила из старого CLAUDE.md/.cursorrules - слей в AGENTS.md. Подробности и таблица миграции - в templates.md.
Self-check
Файлы скилла
| Файл | Назначение |
|---|
| SKILL.md | Workflow (этот файл) |
| templates.md | Шаблоны AGENTS.md, .mdc, CLAUDE.md, GEMINI.md; агент запуска; README-sync; миграция |
| README.md | Описание для людей, установка, триггеры |
| PROMPT.md | Standalone для чатов без skills |
| codex-prompt.md | Промпт /sync-project-rules для Codex |
