Как внести вклад
Каталог растёт плагинами. Если вы хотите добавить плагин или поправить существующий, начните с правил разработки: они лежат рядом с кодом и проверяются валидаторами.
Путь изменения
Заголовок раздела «Путь изменения»- Форкните репозиторий и создайте ветку от
develop. - Прочитайте устройство того, что правите: skill, агент, команда, мод.
- Внесите изменение и синхронизируйте всё, что нужно: Добавить плагин, Версии.
- Прогоните проверки.
- Откройте Pull Request в
develop: Pull Request.
Где лежат правила
Заголовок раздела «Где лежат правила»Нормативные тексты лежат в репозитории, а не на этом сайте: сайт их пересказывает и ведёт к первоисточнику.
| Документ | О чём |
|---|---|
| CLAUDE.md | Как писать плагины, ревьюить и проверять перед коммитом |
| plugin-changes.md | Версии (semver), обязательные синхронизации, гейт перед коммитом |
| docs-changes.md | Правки документации |
| terminology.md | Заведённые имена; значения - в словаре |
| VALIDATOR_RULES.md | Реестр правил валидаторов: что ловит каждое |
| BRD, конституция | Ценность и инварианты каталога |
Остальные документы раздела docs/ (корпус, карта процесса разработки, стандарты, конвейеры) перечислены в README репозитория. В установленный плагин они не входят: это правила для авторов, а не рантайм.
Принципы, которые стоит знать до первой правки
Заголовок раздела «Принципы, которые стоит знать до первой правки»- Skill - ловушки, а не документация. Если «убрать имена проекта - правило всё ещё читается», оно обобщено верно.
- Агент описывается фазами-контрактами, а не процедурами: цель, результат, критерий завершения.
- Один факт - один дом. Правило не копируется, а даётся ссылкой на дом.
- Тексты артефактов пишутся для модели: сухо и по делу, без пересказа.