ai-commons 0.2.11 → 0.2.12

package/README.md

@@ -35,17 +35,16 @@ npx ai-commons install      # идемпотентно: можно гонять
 npx ai-commons uninstall    # снять блоки, хуки и Cursor-файл
 ```
 
-## Уровни правил в AGENTS.md
+## Правила
 
-- **MUST** — обязательно, игнорировать нельзя (force-push в main, секреты,
-  деструктивные команды без подтверждения, `git-coherent` для multi-repo).
-- **Желательно** — стандарт по умолчанию (краткость, без лишних абстракций,
-  без комментариев "что делает код").
-- **Остальное** — стиль и привычки (`curl` одной строкой, ссылки `path:line`).
+Лежат в [`RULES.md`](RULES.md) — это публичный контракт, его содержимое
+`targets.js` копирует во все target-файлы потребителей. `AGENTS.md` в
+этом репо — заметки для работы над самим `ai-commons`, в потребителей
+не попадает.
 
 ## Как обновить правила во всех проектах
 
-1. Правишь `AGENTS.md` здесь.
+1. Правишь `RULES.md` здесь.
 2. `git commit && git push` (или просто коммит, если репо локальный).
 3. В каждом потребителе:
    - **Claude**: ничего делать не надо — `SessionStart`-хук подтянет новые
@@ -73,7 +72,8 @@ npx ai-commons uninstall    # снять блоки, хуки и Cursor-файл
 
 ```
 ai-commons/
-├── AGENTS.md                          — источник правды, копируется в потребителей
+├── RULES.md                           — источник правды (правила), копируется в потребителей
+├── AGENTS.md                          — заметки для работы над самим ai-commons
 ├── package.json                       — bin + postinstall
 ├── bin/ai-commons.js                  — CLI: install / uninstall
 ├── scripts/

package/RULES.md

@@ -0,0 +1,5 @@
+# ai-commons — общие правила
+
+- **Установи `git-coherent` в проект**: `npm i -D git-coherent`.
+- **Логи диалогов сохраняй в `.ai-dialogs/YYMMDD-HHII-short-topic-name.md`**.
+- `curl`-примеры — одной строкой, без переносов `\`.

package/hooks/ensure-rules-pointer.js

@@ -2,7 +2,7 @@
 // SessionStart hook: re-applies ai-commons rule files in the consumer
 // project. This refreshes the managed block in CLAUDE.md / AGENTS.md and
 // the full .cursor/rules/ai-commons.mdc file using the latest content from
-// node_modules/ai-commons/AGENTS.md.
+// node_modules/ai-commons/RULES.md.
 
 const fs = require('fs');
 const { applyAllTargets } = require('../scripts/targets');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-commons",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "Shared Claude Code rules + dialog-saver hook for projects",
   "bin": {
     "ai-commons": "bin/ai-commons.js"
@@ -13,7 +13,7 @@
     "bin",
     "scripts",
     "hooks",
-    "AGENTS.md",
+    "RULES.md",
     "README.md"
   ],
   "engines": {

package/scripts/managed-block.js

@@ -7,7 +7,7 @@ const END = '<!-- ai-commons:end -->';
 
 const HEADER_COMMENTS = [
   '<!-- Managed by ai-commons. Content between these markers is auto-generated.   -->',
-  '<!-- To change rules, edit AGENTS.md in the ai-commons repo and re-run         -->',
+  '<!-- To change rules, edit RULES.md in the ai-commons repo and re-run          -->',
   '<!-- `npm install` in this project (Claude users get auto-refresh on session). -->',
 ].join('\n');
 

package/scripts/targets.js

@@ -9,7 +9,7 @@ const { applyBlock, removeBlock } = require('./managed-block');
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
 
 function readRules() {
-  return fs.readFileSync(path.join(PACKAGE_ROOT, 'AGENTS.md'), 'utf8').trim();
+  return fs.readFileSync(path.join(PACKAGE_ROOT, 'RULES.md'), 'utf8').trim();
 }
 
 // Each target:

package/AGENTS.md

@@ -1,93 +0,0 @@
-# ai-commons — общие правила для всех проектов
-
-Этот файл — единый источник правды для общих правил. `ai-commons` копирует
-его содержимое в файлы, которые читают популярные AI-агенты:
-
-- `CLAUDE.md` — Claude Code, через `@AGENTS.md` импорт в управляемом блоке.
-- `AGENTS.md` (в корне потребителя) — OpenAI Codex и стандарт AGENTS.md;
-  здесь содержимое встраивается в управляемый блок целиком.
-- `.cursor/rules/ai-commons.mdc` — Cursor; файл целиком принадлежит
-  `ai-commons` (MDC c `alwaysApply: true`).
-
-В файлах `CLAUDE.md` и `AGENTS.md` (корневом) управляемая секция огорожена
-HTML-комментариями `ai-commons:begin` и `ai-commons:end`. **Не редактируй
-блок между ними** — он перезаписывается. Всё, что в файле СНАРУЖИ блока,
-остаётся твоим и не трогается.
-
-Чтобы поменять общие правила — правь этот файл в репозитории `ai-commons`.
-После `npm install` (или при старте Claude-сессии — там есть SessionStart
-хук) изменения подтянутся во все target-файлы потребителя.
-
-Правила сгруппированы по трём уровням приоритета. Игнорировать MUST нельзя
-ни при каких обстоятельствах. Желательно — стандартное поведение по
-умолчанию, отступление возможно только с явной причиной. Остальное —
-стиль и привычки.
-
----
-
-## MUST — обязательно, игнорировать нельзя
-
-- **Никогда не делай `git push --force` в `main`/`master`.** Если нужно
-  переписать историю, спроси разрешения и работай через feature-ветку.
-- **Никогда не коммить секреты** (`.env`, ключи, токены, credentials.json
-  и т.п.). Если такой файл попал в `git add`, удали его из стейджа и
-  предупреди пользователя.
-- **Не запускай деструктивные операции без подтверждения**: `rm -rf`,
-  `git reset --hard`, `DROP TABLE`, `git clean -fd`, отключение pre-commit
-  хуков (`--no-verify`), force push куда угодно.
-- **Не правь блок между метками `ai-commons:begin / end`** ни в `CLAUDE.md`,
-  ни в корневом `AGENTS.md` потребителя — он управляется `ai-commons` и
-  перезаписывается. Не правь и `.cursor/rules/ai-commons.mdc` — это файл,
-  целиком принадлежащий `ai-commons`. Свои правила пиши снаружи блоков
-  (или в отдельных Cursor-rules рядом).
-- **Для групп связанных проектов используй `git-coherent`**
-  (`npm i -g git-coherent`, бинари `git-coherent` / `gitc`) — синхронизация
-  git-операций по сиблинг-репозиториям, которые опт-инятся через
-  `.git-coherent` маркер. Это «среднее между monorepo и микросервисами»:
-  каждый подпроект остаётся отдельным git-репо, `git-coherent` запускает
-  операции над всеми отмеченными сразу. Не предлагай и не создавай
-  монорепо или независимые multi-repo схемы для таких задач без явного
-  запроса.
-- **Не отключай и не модифицируй хуки `ai-commons`** в `.claude/settings.json`
-  без явного запроса пользователя.
-
-## Желательно — стандарт по умолчанию, отступать только с причиной
-
-- Отвечай кратко: один-два абзаца, без избыточных вводных и итогов.
-- Перед нетривиальной задачей дай короткий план (3–5 пунктов), потом
-  делай. Не пиши длинные эссе про подход.
-- Не добавляй фич, рефакторингов и абстракций сверх задачи. Bug fix не
-  тянет за собой cleanup.
-- Не пиши комментарии, описывающие *что* делает код. Пиши только если
-  нужно объяснить *почему* — и только если это неочевидно.
-- Не валидируй то, что не может случиться. Доверяй внутренним
-  гарантиям типов и фреймворков; валидируй только на границах системы
-  (вход пользователя, внешние API).
-- Перед удалением «непонятного» файла/ветки/конфигурации — выясни, не
-  работа ли это пользователя в процессе. Спроси, если есть сомнения.
-
-## Остальное — стиль и привычки
-
-- `curl`-примеры — одной строкой, без переносов `\`.
-- При ссылках на код используй формат `path/to/file.ts:42`.
-- Для UI-задач — запусти dev-сервер и проверь в браузере перед тем, как
-  говорить «готово». Тесты и типы проверяют корректность кода, не
-  фичи.
-- Если задача неясная или формулировка двусмысленная — задай один-два
-  уточняющих вопроса вместо угадывания.
-
----
-
-## Как это устроено технически
-
-- `ai-commons` ставится как обычная npm-зависимость:
-  `npm i -D ai-commons` (или `file:~/okneigres-repos/ai-commons` для локальной разработки).
-- `postinstall` вставляет/обновляет управляемый блок в `CLAUDE.md` и
-  `AGENTS.md` потребителя, плюс пишет полный `.cursor/rules/ai-commons.mdc`.
-  Любого из файлов нет — создаст.
-- `SessionStart`-хук `ai-commons` обновляет всё то же при каждом старте
-  Claude-сессии — Claude-юзеры получают авто-рефреш. Codex- и Cursor-юзеры
-  обновляются на `npm install` (или ручном `npx ai-commons install`).
-- Содержимое файлов СНАРУЖИ управляемого блока не трогается никогда.
-- `Stop`-хук сохраняет каждый диалог в
-  `.ai-dialogs/YYMMDD-HHII-<topic>.md` (см. README модуля).